Settings Reference

This guide covers all the settings available in AirShare, helping you customize your experience.

General Settings

Device & Identity

Display Name

• What it does: Sets how your device appears to others in their Radar
• Default: Your computer's hostname
• Recommendation: Use a descriptive, recognizable name

Examples:
✅ "Sarah's MacBook Pro"
✅ "Office Desktop - Marketing"
✅ "John's Windows Laptop"
❌ "localhost"
❌ "Device-12345"

Language

• Options: English, Croatian, German, French, Italian, Spanish
• Default: System language (if supported), otherwise English
• Effect: Changes all UI text immediately

Startup & System Integration

Start on Boot

• What it does: Automatically launches AirShare when your computer starts
• Default: Disabled
• Platform: Available on all platforms

Global Shortcut

• What it does: Allows you to quickly bring AirShare to the front with a keyboard shortcut
• Default: Disabled
• Shortcut: Configurable (default: Cmd+Shift+A on macOS, Ctrl+Shift+A on Windows/Linux)

Discovery & Privacy

Discoverability

Controls who can see your device in their Radar:

Everyone

• Default: Yes
• What it means: Your device appears in all nearby AirShare users' Radar
• Best for: Home networks, trusted environments

Nobody

• What it means: Your device is invisible to others
• Best for: Public networks, maximum privacy
• Note: You can still send files if you know someone's IP address

Downloads

Download Folder

• What it does: Sets where received files are saved
• Default:
  • Windows: Downloads/AirShare
  • macOS: Downloads/AirShare
  • Linux: ~/Downloads/AirShare
• Change: Click "Change" button to select a different folder

Updates

Auto-Check for Updates

• What it does: Automatically checks for new AirShare versions
• Default: Enabled
• Frequency: Check on app startup
• Connection: Uses Tauri updater connected to our secure update server
• Manual: You can also check manually in Settings

Privacy & Data

Transfer History

AirShare keeps a local database of all transfers for your reference:

History Retention

• Free tier: 7 days of transfer history
• Pro tier: Unlimited transfer history retention
• Storage: Local database only (never sent to servers)

Clear History

• What it does: Removes all transfer records from your local database
• What's deleted: Transfer logs, file names, timestamps
• What's kept: Your settings and preferences
• Irreversible: This action cannot be undone

Credits & Licenses

Open Source Licenses

• What it shows: Third-party libraries and frameworks used in AirShare
• Includes: Tauri, Vue.js, Rust crates, and other dependencies
• Access: Click to view full license information in your browser

Advanced Settings

Network Configuration

AirShare automatically handles network configuration, but you may need to:

Firewall Settings

If transfers aren't working, ensure AirShare is allowed through your firewall:

Windows:

• Windows Defender Firewall → Allow an app → Add AirShare

macOS:

• System Preferences → Security & Privacy → Firewall → Allow AirShare

Linux (UFW):

sudo ufw allow from 192.168.0.0/16 to any port 7680

Port Configuration

• Default Port: 7680
• Protocol: QUIC over UDP
• Auto-negotiation: AirShare finds available ports automatically

Performance Optimization

Network Speed

For best performance:

• Use 5 GHz Wi-Fi or Gigabit Ethernet
• Ensure devices are on the same network segment
• Close bandwidth-heavy applications during transfers

Memory Usage

AirShare is optimized for low memory usage:

• Typical usage: 50-100 MB RAM
• During transfer: Additional 10-50 MB per active transfer
• Idle: ~30 MB RAM

Troubleshooting Settings

Reset to Defaults

If you're experiencing issues:

1. Close AirShare completely
2. Delete the settings database file:
   • Windows: %APPDATA%/airshare/settings.db
   • macOS: ~/Library/Application Support/airshare/settings.db
   • Linux: ~/.config/airshare/settings.db
3. Restart AirShare

Debug Information

For technical support, you can find debug logs at:

• Windows: %APPDATA%/airshare/logs/
• macOS: ~/Library/Logs/airshare/
• Linux: ~/.local/share/airshare/logs/