ncmpcpp-ueberzug

ncmpcpp-ueberzug displays ncmpcpp album art using ueberzug. It works on alacritty, st, urxvt, kitty, xterm and lxterm. Unlike existing scripts, it dynamically sizes and positions the cover art such that the window can be any size, even resized. It has many settings to customize the position of the album art to suit your ncmpcpp setup.

ncmpcpp-ueberzug is currently gradually being improved, expect more features in each version but also potential changes in how settings work. I will update this message when this script is feature-complete.

Install

Follow the instructions on the Setup wiki page.

Check out sacad if you want to automatically download cover art for your music library.

Compatibility

Working:

• alacritty, st, urxvt, xterm, lxterm
• kitty (might use wrong terminal if using --single-instance flag)

Require manually setting character size in ncmpcpp_cover_art.sh:

• cool-retro-term
• sakura (resizing can break geometry)
• gnome-terminal, terminator, xfce4-terminal (Album art displays on the last opened terminal irrespective of which is the ncmpcpp window, resizing can break geometry)

Broken:

• konsole (stops working randomly, geometry is wrong)
• guake, terminology (geometry is wrong)

Similar scripts

• Fixed-width, left-aligned Mopidy album art Python script using Ueberzug

• Ueberzug script that opens the album art in a tmux pane

• Fixed-geometry urxvt-compatible script using urxvt background escape codes

TODO

• Refactor alignment settings / Add alignment/scaling options for left-align
• Try out toggle?
• Update columns gif with new geometry behaviour, add more illustrations
• Change cleanup mechanism to allow for several ncmpcpp-ueberzug instances
• Support Spotify album art with mopidy