MacMusicPlayer

An elegant and minimalist menu bar music player for macOS (no Dock icon), providing a seamless music playback experience.

Requirements

• macOS 13.0 (Ventura) or later

Installation

Homebrew (Recommended)

brew install samzong/tap/mac-music-player

DMG

Download the latest MacMusicPlayer-arm64.dmg from the Releases page.

Security Note: The DMG is ad-hoc signed (no paid Apple Developer account yet). On first launch macOS may warn that the app is from an unidentified developer — right-click the app and select "Open" once to proceed. The Homebrew cask installs the same prebuilt DMG and clears the app's quarantine attribute after installation.

Features

• 🎵 Lightweight menu bar player for instant music control
• 🔍 Spotlight-style song picker (⌘F) with instant title, artist, and filename filtering
• 🎨 Native macOS interface with perfect light/dark theme support
• 🌍 Multi-language support (English, Simplified Chinese, Traditional Chinese, Japanese, Korean)
• 🎧 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 thumbnails and format selection (requires yt-dlp + ffmpeg)
• 💾 Smart memory of last music library and last played track
• 🚀 Launch at login (enabled by default)
• 🌙 Prevent-sleep toggle (enabled by default)
• ⌨️ 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 and use Download Selected for the checked playlist songs. Closing the window keeps downloads running while the app stays open; Stop cancels the active download. Use Refresh Current Library to rescan music quickly.
• For best metadata display, name your files as Artist - Title.mp3 format.

Screenshots

Song Picker

Download Music

Contributing

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

swift test        # run unit tests
make build        # build the Release app into build/
make dmg          # build + package a self-signed arm64 DMG

License

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