Tightly integrates cmus command line music player into macOS.
Switch branches/tags
Clone or download



Python version support: 3 License: MIT

cmus-osx tightly integrates cmus, an excellent console music player, into macOS.
It adds notification and media key support on par with other media players such as iTunes.


Attention! Installing cmus-osx will prevent you from opening iTunes until it is uninstalled!
Since macOS 10.12 launchctl can not manipulate system services while System Integrity Protection is engaged.
Long story short: iTunes will always be launched when a media key is pressed unless it is explicitly disabled.

git clone https://github.com/PhilipTrauner/cmus-osx.git
cd cmus-osx
pip3 install -r requirements.txt
./setup.py install

Uninstall cmus-osx: ./setup.py uninstall


Framework building has to be enabled, otherwise notifications cannot be created.
Add this export to your shell-rc and rebuild.

export PYTHON_CONFIGURE_OPTS="--enable-framework"


A config file is created on first usage: ~/.config/cmus/cmus-osx/cmus-osx.config