MacMusicPlayer

Requirements

• macOS 12.0 (Monterey) or later

Installation

Homebrew (Recommended)

brew install samzong/tap/mac-music-player

DMG

Download the latest MacMusicPlayer.dmg from the Releases page.

Security Note: If you encounter a security warning on first launch, right-click the app and select "Open", or run: xattr -dr com.apple.quarantine /Applications/MacMusicPlayer.app

Features

• 🎵 Lightweight menu bar player for instant music control
• 🎨 Native macOS interface with perfect light/dark theme support
• 🌍 Multi-language support (English, Simplified Chinese, Traditional Chinese, Japanese, Korean)
• 🔎 Song picker (⌘F in menu) with instant filename filtering
• 🎧 Audio format support (mp3, m4a, wav, flac, aac, ogg, aiff)
• 🔄 Multiple playback modes (Sequential, Single Loop, Random)
• 📚 Multiple music libraries with quick switch (⌘R to refresh)
• 📥 Built-in YouTube/SoundCloud search & playlist downloads with format selection (requires yt-dlp + ffmpeg)
• 💾 Smart memory of last music folder location and volume
• 🚀 Launch at login (enabled by default)
• 🌙 Prevent-sleep toggle (enabled by default) and configurable song picker on launch
• ⌨️ Media key control and keyboard shortcuts (⌘D Download, ⌘S Settings)

Configuration & Tips

• Download dependencies (yt-dlp, ffmpeg) are installed automatically via Homebrew; manual install (brew install yt-dlp ffmpeg) is required for DMG users.
• Configure API URL and API Key in Settings to enable YouTube search (requires a custom search proxy service).
• Pick the destination library in the Download window; use Download All button to download entire playlists, or Refresh Current Library to rescan music quickly.
• For best metadata display, name your files as Artist - Title.mp3 format.

Screenshots

Menu Items

Download Music

Contributing

Contributions are welcome! Please feel free to submit Issues and Pull Requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.