First-Time Setup

This guide will help you configure AirShare for optimal performance and personalize it to your preferences.

Initial Configuration Wizard

When you first launch AirShare, you'll go through a brief setup:

1. Accept the EULA

• Read the End User License Agreement
• Click "Accept" to continue
• Required to use transfer features

2. Choose Your Language

Select your preferred language:

• 🇬🇧 English
• 🇭🇷 Hrvatski (Croatian)
• 🇩🇪 Deutsch (German)
• 🇫🇷 Français (French)
• 🇮🇹 Italiano (Italian)
• 🇪🇸 Español (Spanish)

You can change this later in Settings.

3. Set Download Location

Choose where received files should be saved:

• Default: Your system's Downloads folder
• Custom: Any folder you prefer

Essential Settings to Configure

General Settings

Device Name

Your device name is how others see you on the network.

1. Go to Settings → General
2. Find Device Name
3. Enter a descriptive name (e.g., "John's MacBook", "Office Desktop")

Launch on Startup

Have AirShare start automatically when you boot your computer:

1. Go to Settings → General → System
2. Enable "Launch on startup"
3. ✅ Recommended: Keep this enabled for instant file receiving

Notifications

Configure how you want to be notified:

1. Go to Settings → Notifications
2. Enable/disable:
   • Transfer requests: When someone wants to send you files
   • Transfer complete: When transfers finish
   • Transfer failed: When transfers encounter errors
   • Sound alerts: Audio notifications

Network Settings

Firewall Configuration

Ensure your firewall allows AirShare:

Windows:

• Windows Firewall usually prompts on first launch
• Allow on both Private and Public networks

macOS:

• Go to System Settings → Network → Firewall
• Allow incoming connections for AirShare

Linux (UFW):

sudo ufw allow from 192.168.0.0/16 to any port 59875:59925 proto udp
sudo ufw allow from 10.0.0.0/8 to any port 59875:59925 proto udp

Port Configuration (Advanced)

AirShare uses ports 59875-59925 by default. Usually, you don't need to change this.

If you need to specify a different port:

1. Go to Settings → Network
2. Click Advanced
3. Set custom port range (requires restart)

Privacy & Security Settings

Transfer Permissions

Configure how you want to handle incoming transfers:

1. Go to Settings → Privacy
2. Choose transfer mode:
   • Ask every time (Recommended): Review each transfer before accepting
   • Auto-accept from known devices: Automatically accept from trusted senders
   • Block all: Reject all incoming transfers

Allowed File Types

Restrict which file types you're willing to receive:

1. Go to Settings → Privacy → File Types
2. Choose:
   • All file types (default)
   • Custom: Define allowed extensions (e.g., .jpg, .pdf, .docx)
   • Block executable files: Extra safety measure

Appearance Settings

Theme

Choose your preferred visual style:

1. Go to Settings → Appearance
2. Select theme:
   • Light: Traditional light theme
   • Dark: Easy on the eyes
   • System: Follows your OS theme

Window Behavior

Configure how the AirShare window behaves:

1. Go to Settings → Appearance → Window
2. Options:
   • Minimize to tray: Hide window instead of closing
   • Start minimized: Launch in system tray
   • Show dock icon (macOS only): Show/hide in dock

Storage & History

Transfer History

Configure how long to keep transfer records:

1. Go to Settings → Storage
2. Set history retention:
   • Keep all history (default)
   • Delete after 30 days
   • Delete after 90 days
   • Don't save history: Privacy mode

Clear History

Remove all transfer records:

1. Go to Settings → Storage
2. Click "Clear History"
3. Confirm deletion

License Activation (Pro Users)

If you purchased a Pro license:

Activate Your License

1. Go to Settings → License
2. Click "Enter License Key"
3. Paste your license key
4. Click "Activate"

Your Pro features will be activated immediately:

• ✅ Unlimited file size
• ✅ Unlimited daily transfers
• ✅ Priority support

Check License Status

View your current license:

1. Go to Settings → License
2. See:
   • License type (Free/Pro)
   • Expiration date (for 1-year licenses)
   • Device ID

Network Verification

Test Device Discovery

Ensure AirShare can discover other devices:

1. Install AirShare on at least one other device
2. Launch AirShare on both devices
3. Check the Radar tab
4. Both devices should appear within 5-10 seconds

If devices don't appear, check:

• Both devices are on the same network
• Firewalls allow AirShare
• No VPN interfering with local network
• Router allows multicast (mDNS)

Test File Transfer

Send a small test file:

1. Create a small text file
2. Drag it to another device in Radar
3. Accept on the receiving device
4. Verify file received correctly

Recommended Settings for Different Use Cases

Home User

• ✅ Launch on startup
• ✅ Ask before accepting transfers
• ✅ Enable all notifications
• ✅ System theme
• ✅ Keep all history

Office/Work Use

• ✅ Launch on startup
• ✅ Auto-accept from known devices
• ✅ Enable transfer complete notifications only
• ✅ Light theme (professional)
• ✅ Delete history after 30 days

Privacy-Conscious

• ✅ Manual launch (don't start on startup)
• ✅ Ask before every transfer
• ✅ Block executable files
• ✅ Don't save history
• ✅ Clear history regularly

Backup Your Settings

Your AirShare settings are stored locally. To backup:

Windows:

%APPDATA%\io.github.jaksatomovic.airshare\

macOS:

~/Library/Application Support/io.github.jaksatomovic.airshare/

Linux:

~/.config/io.github.jaksatomovic.airshare/

Copy this folder to backup your settings and history.

Next Steps

Your AirShare is now fully configured!