cmusfm

cmusfm [init]

cmusfm is a standalone Last.fm scrobbler designed for the cmus music player. It runs as a background server process that receives track information from cmus via the status_display_program interface, then submits "now playing" notifications and scrobbles to Last.fm or compatible services.
Before first use, run cmusfm init to authenticate with the Last.fm API. Then configure cmus to use cmusfm by setting status_display_program=cmusfm in cmus. The cmusfm server starts automatically when cmus sends its first status update.

Configuration is stored in ~/.config/cmus/cmusfm.conf. Edit this file to customize scrobbling behavior.
format-localfile

Regex pattern for parsing local audio file metadata (default: `"^(?A.+) - (?T.+)\.[^.]+$"`)

Regex pattern for parsing stream metadata (default: `"^(?A.+) - (?T.+)$"`)

Regex pattern for cover art file detection (e.g., `"^(cover|folder)\.jpg$"`)

Enable "now playing" notifications for local files (default: yes)

Enable "now playing" for streams (default: no)

Submit scrobbles for local files (default: yes)

Submit scrobbles for streams (default: no)

Display desktop notifications on track change (default: disabled)

Custom scrobbling service API endpoint for Last.fm alternatives (e.g., Libre.fm)

Custom authentication URL for alternative services

The cmusfm server runs as a background process and must be restarted (via pkill cmusfm) after configuration changes. The default file name parsing patterns may not match all naming conventions — custom regex patterns can be configured for non-standard file names. Only works with cmus; not compatible with other music players.

cmusfm was created as a lightweight, standalone Last.fm scrobbler specifically for the cmus console music player. It is written in C and uses the Last.fm API for authentication and scrobbling. The project is maintained on GitHub by arkq.

cmus(1)