Description

Amcfy Music supports macOS, Windows, and Linux desktop platforms, providing the same playback experience as mobile with added desktop-specific interaction capabilities.

Feature Overview:

• Native desktop window experience
• File drag-and-drop playback
• System tray control
• Large screen adapted layout

---

Platform Support

Platform	Format	Requirements
macOS	.dmg	macOS 10.15+
Windows	.zip package	Windows 10+
Linux	.deb / .rpm / .tar.gz	Ubuntu 20.04+ / mainstream distros

---

Installation

macOS

1. Download the .dmg file from Download Page
2. Double-click to open the DMG
3. Drag Amcfy Music to the Applications folder
4. Launch from Launchpad

Windows

1. Download the .zip package
2. Extract and run the executable directly

Linux

1. Download the corresponding Linux package (.deb, .rpm, or .tar.gz)
2. Choose the installation method based on the package format:

# deb (Debian/Ubuntu)
sudo dpkg -i amcfy-music_*.deb

# rpm (Fedora/RHEL)
sudo rpm -ivh amcfy-music-*.rpm

# tar.gz (Universal)
tar -xzf amcfy-music-*.tar.gz
cd amcfy-music
./amcfy

---

How to Use

Drag-and-Drop Playback

New in v1.2.1: Drag audio files directly into the Amcfy Music window to play.

• Supports dragging audio files from file manager
• Supports dragging folders (batch add)
• Dragged songs are automatically added to the current play queue
• Dragged songs are not synced to the server — local playback only

Notes:

• DRM-protected files are not supported
• Supported formats depend on the OS and MPV framework's decoding capability
• Dragging a large number of files may cause brief lag
• Temporary playlist is not saved after closing the app

File Association

New in v1.2.1: Set Amcfy Music as the default music player to open audio files with a double-click.

How to Use:

1. Go to Settings → Desktop
2. Tap "Associate Audio File Formats"
3. Check the formats to associate (MP3, FLAC, WAV, AAC, OGG, etc.)
4. The system will prompt to confirm the file association change

Notes:

• Requires OS permissions; admin rights may be needed on some systems
• Changing file association replaces previously associated players
• On macOS, you may need to manually change it in Finder's "Get Info"

System Tray

Desktop version supports system tray (menu bar icon) for minimizing to tray:

• macOS: Amcfy Music icon in menu bar
• Windows: Icon in system tray area
• Linux: Taskbar system tray

Tray Menu Functions:

Menu Item	Description
Play / Pause	Control current song playback
Previous Song	Switch to the previous song
Next Song	Switch to the next song
---	Separator
Hide / Show Window	Hide or show the main window
Hide / Show Dock Icon	Hide or show the Dock icon (macOS/Windows)
Hide / Show Status Bar Lyric	Show or hide lyrics in the menu bar (macOS/Windows)
---	Separator
Website	Open the official website
Support	Get technical support
About	View version information
---	Separator
Exit	Completely quit the application

Window Management

• Window resize and fullscreen support
• Minimize to tray
• Closing window does not quit app on macOS

Keyboard Shortcuts

The desktop version supports the following keyboard shortcuts:

Shortcut	Action
Space	Play / Pause
Enter	Play / Pause
←	Previous Song
→	Next Song
↑	Volume +5%
↓	Volume -5%
Esc	Exit Fullscreen

---

Notes

Tips

Desktop version shares the same codebase as mobile, with essentially the same features.

1. First Launch: Desktop version needs a server connection to play music
2. Network Dependency: Desktop version depends on music servers; ensure server accessibility
3. Updates: Desktop version requires manual download for updates; auto-update not yet supported
4. Notifications: Windows/Linux desktop notifications may be blocked by system; check notification permissions
5. Performance: Disable vinyl cover effect on desktop to reduce CPU usage

---

Use Cases

Scenario	Description
Office Music	Background music player on work computer
Hi-Fi Listening	Connect to high-fidelity audio gear (DAC/amp) for lossless music
Music Management	Manage playlists and music library on large screen
Developer Testing	Quick drag-and-drop testing of audio files
Home Media Center	Connect to living room PC and large screen

---

Differences from Mobile

Feature	Mobile	Desktop
Drag-and-Drop Play	❌	✅
Notification Control	✅	✅ Desktop notifications
CarPlay/Android Auto	✅	❌
Widgets	Planned	❌
System Tray	❌	✅
Touch Operation	✅	Limited

Copyright

License under:Attribution 4.0 International (CC-BY-4.0)