{"id":21954880,"url":"https://github.com/thefox/cmus-control","last_synced_at":"2025-08-21T01:32:04.694Z","repository":{"id":50738996,"uuid":"46427102","full_name":"TheFox/cmus-control","owner":"TheFox","description":"Control cmus with Media Keys :rewind: :arrow_forward: :fast_forward: under OS X.","archived":false,"fork":false,"pushed_at":"2025-05-18T20:47:58.000Z","size":48,"stargazers_count":59,"open_issues_count":2,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-05-18T21:32:28.371Z","etag":null,"topics":["cmus","macos","macosx","mit-license","music","objective-c","osx"],"latest_commit_sha":null,"homepage":"https://blog.fox21.at/2015/11/20/control-cmus-with-media-keys.html","language":"Zig","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheFox.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG-v1.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-11-18T15:18:26.000Z","updated_at":"2025-05-18T20:48:02.000Z","dependencies_parsed_at":"2024-12-19T18:12:08.575Z","dependency_job_id":"d841708c-bc6d-4e51-b2ee-f9fdce25a9f3","html_url":"https://github.com/TheFox/cmus-control","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/TheFox/cmus-control","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheFox%2Fcmus-control","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheFox%2Fcmus-control/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheFox%2Fcmus-control/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheFox%2Fcmus-control/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheFox","download_url":"https://codeload.github.com/TheFox/cmus-control/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheFox%2Fcmus-control/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271415019,"owners_count":24755628,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-20T02:00:09.606Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cmus","macos","macosx","mit-license","music","objective-c","osx"],"created_at":"2024-11-29T07:26:28.144Z","updated_at":"2025-08-21T01:32:04.688Z","avatar_url":"https://github.com/TheFox.png","language":"Zig","readme":"# Cmus Control\n\nControl [cmus](https://cmus.github.io/) with Media Keys :rewind: :arrow_forward: :fast_forward: under [macOS](https://en.wikipedia.org/wiki/MacOS).\n\n## Project Outlines\n\nThe project outlines as described in my blog post about [Open Source Software Collaboration](https://blog.fox21.at/2019/02/21/open-source-software-collaboration.html).\n\n- The main purpose of this software is to provide support for cmus under macOS. Cmus can be controlled by the Media Keys of your Apple Keyboard.\n- The feature set is restricted because this software already provides the intended features. But still, feel free to request features.\n\n## Requirements\n\n- At least **macOS 10.8**.\n- `zig` to build it.\n- Since Cmus Control doesn't have the behavior of changing any foreign processes it's highly recommended to [deactivate the *Remote Control Daemon*](https://blog.fox21.at/2015/11/20/control-cmus-with-media-keys.html).\n- [cmus](https://cmus.github.io/) installed. ;)\n\n## Install\n\nYou can either install Cmus Control via [Homebrew](#homebrew-installation) or [manually](#manually-installation). The preferred method of installation is via Homebrew.\n\n### Homebrew installation\n\n1. Add the [`thefox/brewery`](https://github.com/TheFox/homebrew-brewery) tap to brew.\n\t\n\t```bash\n\tbrew tap thefox/brewery\n\t```\n\n2. Actual installation\n\t\n\t```bash\n\tbrew install cmus-control\n\t```\n\n3. After a successful installation follow the Caveats output, start the service:\n\t\n\t```bash\n\tbrew services start thefox/brewery/cmus-control\n\t```\n\t\n\tOr, if you don't want/need a background service you can just run\n\t\n\t```bash\n\tcmuscontrold\n\t```\n\n### Manual installation\n\n1. You need to install zig: `brew install zig`\n2. Run `./bin/install.sh` to compile *Cmus Control Daemon* and install `cmuscontrold` under `/usr/local/bin` path.\n\tA [launchd.plist](https://developer.apple.com/library/mac/documentation/Darwin/Reference/ManPages/man5/launchd.plist.5.html) file named `at.fox21.cmuscontrold.plist` will be created under `$HOME/Library/LaunchAgents` to start *Cmus Control Daemon* automatically on login.\n\n#### Uninstall\n\nJust run `./bin/uninstall.sh`. Doing so\n\n- `cmuscontrold` will be unloaded via [`launchctl`](https://developer.apple.com/library/mac/documentation/Darwin/Reference/ManPages/man1/launchctl.1.html);\n- `$HOME/Library/LaunchAgents/at.fox21.cmuscontrold.plist` will be removed;\n- `/usr/local/bin/cmuscontrold` will be removed.\n\n#### Load/Unload\n\nAfter a successful manual installation the `cmuscontrold` is loaded/started automatically with `launchctl`. You can unload the daemon manually:\n\n```bash\nlaunchctl unload \"$HOME/Library/LaunchAgents/at.fox21.cmuscontrold.plist\"\n```\n\nOr load it manually:\n\n```bash\nlaunchctl load \"$HOME/Library/LaunchAgents/at.fox21.cmuscontrold.plist\"\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthefox%2Fcmus-control","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthefox%2Fcmus-control","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthefox%2Fcmus-control/lists"}