https://github.com/PhilipTrauner/cmus-osx

Adds track change notifications and media key support to cmus.
https://github.com/PhilipTrauner/cmus-osx

cmus cmus-osx macos media-keys music notifications osx

Last synced: 5 days ago
JSON representation

Adds track change notifications and media key support to cmus.

• Host: GitHub
• URL: https://github.com/PhilipTrauner/cmus-osx
• Owner: PhilipTrauner
• License: mit
• Created: 2016-04-11T10:27:31.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-06-30T10:14:23.000Z (5 months ago)
• Last Synced: 2024-08-03T01:38:34.507Z (3 months ago)
• Topics: cmus, cmus-osx, macos, media-keys, music, notifications, osx
• Language: Python
• Homepage:
• Size: 173 KB
• Stars: 178
• Watchers: 7
• Forks: 9
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


​




▶ cmus-osx


![Python version support: 3.7](https://img.shields.io/badge/python-3.7-limegreen.svg)

[![PyPI version](https://badge.fury.io/py/cmus-osx.svg)](https://badge.fury.io/py/cmus-osx)

![License: MIT](https://img.shields.io/badge/license-MIT-limegreen.svg)

[![CircleCI](https://circleci.com/gh/PhilipTrauner/cmus-osx.svg?style=svg)](https://circleci.com/gh/PhilipTrauner/cmus-osx)

**cmus-osx** adds track change notifications, and media key support to [*cmus*](https://cmus.github.io/) (*macOS* only).

## Installation

macOS automatically launches iTunes on media key presses.

Installing [noTunes](https://github.com/tombonez/noTunes/releases/tag/v2.0) is the recommended solution to prevent this from happening.

```bash

pip3 install cmus-osx

cmus-osx install

```

**cmus-osx** supports virtual environments natively, so installing it via `pipx` (or basically any other virtual environment manager) works just as well.

### Uninstall

```

cmus-osx uninstall

pip3 uninstall cmus-osx

```

#### pyenv

Framework building has to be enabled, otherwise notifications cannot be created.

```bash

export PYTHON_CONFIGURE_OPTS="--enable-framework"

```

## Configuration

```

cmus-osx config

```

### Credits

* [azadkuh](https://github.com/azadkuh): all versions up to and including v1.2.0

* [PhilipTrauner](https://github.com/PhilipTrauner): all following versions