rrevanth / ncmpcpp-control

Support media keys for ncmpcpp player

Ncmpcpp Control

Inspiration from Cmus Control

Control ncmpcpp with Media Keys ⏪ ▶️ ⏩ under OS X.

Requirements

• At least macOS 10.8.
• cmake to build it.
• Since Ncmpcpp Control doesn't have the behavior of changing any foreign processes it's highly recommended to deactivate the Remote Control Daemon.
• ncmpcpp installed. ;)

Install

1. You need to install cmake: brew install cmake
2. Run make install to compile Control Daemon and install ncmpcppcontrold under /usr/local/bin path. A launchd.plist file named at.fox21.ncmpcppcontrold.plist will be created under ~/Library/LaunchAgents to start Control Daemon automatically on login.

If you just want to compile Control Daemon without installing run make. The binary will be created at build/release/bin/ncmpcppcontrold.

Uninstall

Just run make uninstall. Doing so

• ncmpcppcontrold will be unloaded via launchctl;
• ~/Library/LaunchAgents/at.fox21.ncmpcppcontrold.plist will be removed;
• /usr/local/bin/ncmpcppcontrold will be removed.

Load/Unload

After a successful manual installation the ncmpcppcontrold is loaded/started automatically with launchctl. You can unload the daemon manually:

make unload

Or load it manually:

make load

Re-build

After changing the source code you might want to re-build the binary and re-install it.

1. make unload
2. make -C build/release
3. make install

License

Copyright (C) 2015 Revanth Revoori http://rrevanth.github.io

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.