status display programs

These scripts are invoked on any status change of the player. Usually they are used to show the current playing song (e.g. to others in an instant messenger, or as popup in a window manager), but they can also do other stuff (e.g. populating the play queue with new songs).

Audio scrobbling (to e.g. Last.fm or Libre.fm)

• CmuScrobbler: a scrobbler in Python 2, supports Now-Playing Notification (cmuscrobbler.py).
• cmusfm: a simple scrobbler written in C with Scrobbling 2.0 protocol support
• cmus_lastfmsubmit: a simple script that allows cmus to scrobble to lastfmsubmitd.
• cmuslastfm: a scrobbler in PHP, with ID3 tag v1/v2 and now playing support
• cmus-status-scrobbler: a simple standalone Python 3 program with offline mode scrobbling to multiple servers

Dynamic playlists

• cmus_add_similar: uses Last.fm similar artists to fill the playlist or play queue (cmus_add_similar.py).

Display current track info on screen

Standalone

• cmusd: Connects cmus with the OS's media player to provide album art and play back buttons with support for media keys (read documentation for installation).

Scripts

• Systray: Use a script such as status_display_short_text.sh to generate a short, readable status line, pipe that (through a fifo) to now-playing-d
• Conky: blog post 1, blog post 2 (german), wiki (german), first script fixed to stop wrong info being displayed, [Album art display for now playing] (https://github.com/TiredSounds/cmus-conky/blob/master/cmus-conky-art.sh)
• GNOME/Unity (via ''notify-send'' command) — status_diplay_notify_send.py
• Awesome DM widget
• Display status via desktop notification with album art cmus_status.py
• Gnome desktop notifications, based on cmus_status.py, cmus_notify.py. Includes album art and control buttons.
• Mac OS X: simple GUI for cmus, provides playback commands, seek and volume adjust - Apple Remote control supported. - https://github.com/moonwave99/CMusRemote
• Alternative status with album-art via desktop notification cmus_status.rb
• awesome-WM-specific status display via desktop notification (Naughty), allowing cmus-specific placement, sizing, style etc. naughty_status.rb
• For dwm users: xsetcmus.sh is shell script that echos the currently playing track data, which can be easily piped though xsetroot to display in the status bar.
• CmusNotify, now playing notifications written in golang
• cmus-notify: Simple Rust app to show notifications.
• cmushnotify: Shell script for showing notifications with album art.

Album Art Display

• cmus-cover-art - extract and display cover art of current track
• Display status via desktop notification with album art cmus_status.py
• cmus-feh.sh - Widely compatible script using 'feh' to display the image. Edit the resolution/offset to your needs. Use your window manager to manipulate the window automatically.
• cmusCoversSDL - find and display cover art in a standalone window.
• cmus-swift - Apple macOS album art and remote controls in SwiftUI
• cmus-rg - a simple graphical cmus status display in C using SDL2

Instant messengers

• Gaim: cmus-updategaim.py
• Pidgin: cmus-updatepidgin.py

Miscellaneous

• Focus follows playback: cmus_follow_playback
• Mac OS X: Send status updates to iTunes-aware apps - itunes_notify.c
• Album shuffle mode: albumshuffle.sh

Usage / Installation

To use the programs, download them and make them executable:

chmod a+x downloaded-file

To use multiple programs, create a shell script, e.g. ~/.cmus/status_display_program.sh, that starts all wanted programs:

#!/bin/sh
program1 "$@" &
program2 "$@" &

Then in cmus, set the display_status_program variable to the path of the program or wrapper script:

  :set status_display_program=/home/user/.cmus/status_display_program.sh