https://github.com/samzong/macmusicplayer
A clean, lightweight music player for macOS.
https://github.com/samzong/macmusicplayer
Last synced: 11 months ago
JSON representation
A clean, lightweight music player for macOS.
- Host: GitHub
- URL: https://github.com/samzong/macmusicplayer
- Owner: samzong
- License: mit
- Created: 2024-09-18T06:21:02.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-08-01T03:02:33.000Z (12 months ago)
- Last Synced: 2025-08-16T03:05:37.311Z (11 months ago)
- Language: Swift
- Homepage: https://samzong.github.io/MacMusicPlayer/
- Size: 3.12 MB
- Stars: 52
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- fucking-awesome-mac - MacMusicPlayer - 一个干净、轻量级的常驻菜单栏的音乐播放器。 ![Open-Source Software][OSS Icon] ![Freeware][Freeware Icon] (音频和视频 / 文件共享)
- awesome-mac - MacMusicPlayer - 一个干净、轻量级的常驻菜单栏的音乐播放器。 ![Open-Source Software][OSS Icon] ![Freeware][Freeware Icon] (音频和视频 / 文件共享)
- awesome-mac - MacMusicPlayer - 一个干净、轻量级的常驻菜单栏的音乐播放器。 ![Open-Source Software][OSS Icon] ![Freeware][Freeware Icon] (音频和视频 / 文件共享)
- awesome-swift-macos-apps - MacMusicPlayer - commit/samzong/macmusicplayer?style=flat&label=" /> - A clean, lightweight music player for macOS. (Music / Text)
README
# MacMusicPlayer
[English](README.md) | [简体中文](README_zh.md)
An elegant and minimalist music player for macOS, designed as a menu bar application to provide a seamless music playback experience. Built with SwiftUI, it perfectly integrates into the macOS ecosystem.
## 📦 Installation
### Homebrew (Recommended)
```bash
brew tap samzong/tap
brew install mac-music-player
```
### Download DMG
Download the latest `MacMusicPlayer.dmg` from the [Releases](https://github.com/samzong/MacMusicPlayer/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`
## ✨ Key Features
- 🎵 Lightweight menu bar player for instant music control
- 🎨 Native macOS interface with perfect light/dark theme support
- 🌍 Multi-language support (English, Chinese, Japanese, Korean)
- 🎧 Audio format support (mp3, m4a, wav, flac, aac, aiff, etc.)
- 🔄 Multiple playback modes (Sequential, Single Loop, Random)
- 📥 Download music from online sources (YouTube, SoundCloud, etc.)
- 💾 Smart memory of last music folder location
- 🚀 Launch at login support
- 😴 Prevent system sleep for uninterrupted music
- ⌨️ Media key control support
## 📷 Screenshots
### Menu Items
### Download Music
## 🛠 Development
For detailed development guide, see: [Developer Documentation](docs/developer_guide.md)
## 🤝 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](LICENSE) file for details.