Clementine

Clementine is a modern music player and library organizer for Windows, Linux and macOS.

• Latest Release
• Latest Pre-Releases
• Website: http://www.clementine-player.org/
• Github: https://github.com/clementine-player/Clementine

Please:

• Check if the new feature is not already implemented (Changelog)
• Check if another person didn't already open an issue
• If there is already an opened issue there is no need to comment "+1", it won't help. Instead, you can subscribe to the issue to be notified of anything new about it

Please:

• Try the latest build (https://github.com/clementine-player/Clementine/releases) to see if any bug is still present. If it works fine even though you see an open issue, please comment on it and explain that the issue has been fixed.
• Check if another person has already opened the same issue to avoid duplicates
• If there already is an open issue you could comment on it to add detail about the problem or confirm it
• In case there isn't, you can open a new issue with an explicit title and as much information as possible (OS, Clementine version, how to reproduce the problem...)
• Please use https://pastebin.com/ for logs/debug.

If there are no answers, it doesn't mean we don't care about your feature request/bug. It just means we can't reproduce the bug or haven't had time to implement it :o)

Get the code (if you haven't already):

git clone https://github.com/clementine-player/Clementine.git && cd Clementine

Compile and install:

cd bin
cmake ..
make -j$(nproc)
sudo make install

See the Wiki for more instructions and a list of dependencies: https://github.com/clementine-player/Clementine/wiki#compiling-and-installing-clementine

CI checks that C++ code under src/ is formatted with clang-format 23.1.0. Other versions format some code differently, so install that exact version with uv (or pipx), which puts it on your PATH:

uv tool install clang-format==23.1.0

If uv warns that its tool directory isn't on your PATH, run uv tool update-shell and open a new terminal.

Then reformat the files you've changed since origin/master:

dist/format.py -i

Claude Code does this automatically after each edit, using a hook in .claude/settings.json.

If your change is something users will notice, end its commit message with a Release-note: trailer: one line, written for users (what's new, not how it was done):

Show the song's lyrics in time with the song

Release-note: Lyrics scroll along with the song, when they're timed.

Git only reads trailers in a message's last paragraph, so keep the note there, with any other trailers and no blank line between them. A note followed by a blank line and then, say, Co-Authored-By: is ignored, and the commit never makes an update. Together, as here, both are read:

Release-note: Lyrics scroll along with the song, when they're timed.
Co-Authored-By: Someone <someone@example.com>

To check, git log -1 --format='%(trailers:key=Release-note,valueonly)' should print the note.

Once a week, the macOS update feed gets the newest build if the commits since its last update have notes, and shows them in the update window. Commits without one (refactoring, tests, CI, docs) never make an update on their own. See tools/mac-update/README.md.