FMUI

fzf mpd user interface
Warning: FMUI will add every song to your queue by default.

Overview

• Unofficial aur package
• Required uncommon programs
• Config
  • General configuration
  • Cover images
  • Keybindings
    • Default keybindings
    • Keybindings example
• Visualizer
• Screenshots

Unofficial aur package

fmui-git

Required uncommon programs

• toilet
• fzf
• mpc

Config

General configuration

The config is a bash script called "config" located in "~/.config/fmui/".

Variable name	Type	Description	Default value
fill_queue	Boolean	Add every song to the queue on starting FMUI	true
clear_queue	Boolean	Clear queue on starting FMUI	false
fzf_options	Array	fzf additional command line arguments	'--cycle', '-i'
song_format	String	Default song format used by the song info screen, see man mpc	'[[[%artist% - ]%title%]|[%file%]]'
song_list_format	String	Song format used for fzf, see man mpc	'%time% [[[%artist% - ]%title%]|[%file%]]'
preview	String	fzf preview command	'mpc | tail -n 1'
prompt	String	fzf prompt	'\xF0\x9D\x84\x9E '
seek_step	String	Seek time	'00:00:10'
visualizer	String	Visualizer program, e.g. cava, vis	'cava || vis'
mod	String	Mod key	'ctrl'
cover_max_width	Integer	Max width of the extracted image which is used as cover image	500
cover_max_columns	Integer	Max amount of columns used to display the cover image	30
margin	String	fzf margin	0,0,0,0 or 0,0,0,cover_max_columns+1 if cover enabled
preview_box_size	Integer	size of fzf preview box	1 or 20 if cover enabled
DIR_MUSIC	String	The path to your music collection

Cover images

1. Install:
   • Überzug
   • ffmpeg or avconv (should also include ffprobe or avprobe)
   • file likely already installed
2. Assign the path of your music collection to DIR_MUSIC in your config.

Keybindings

Keybindings formatted with fzfs syntax are also configured with a bash script called "keybindings".
Commands starting with 'execute-silent' bound to a single char are useable in subscreens.

Default keybindings

Key	Action	Subscreens
q	Quit fzf
u	Update fzf preview window
v	Start visualizer
i	Show song info screen
j	Go down
k	Go up
down	Go down
up	Go up
return	Play choice
mod-r	Toggle repeat
mod-s	Shuffle
mod-d	Update mpd database, restart
left	Seek backwards
right	Seek forwards
h	Seek backwards	✓
l	Seek forwards	✓
p	Toggle play	✓
c	Toggle consume	✓
s	Toggle single song	✓
r	Toggle random	✓
<	Play previous song	✓
>	Play next song	✓

Keybindings example

readonly VOLUME_STEP=2
# format? see man fzf
readonly ACTION_VOLUME_UP="execute-silent:amixer set Master ${VOLUME_STEP}%+ unmute"
readonly ACTION_VOLUME_DOWN="execute-silent:amixer set Master ${VOLUME_STEP}%- unmute"

key_bindings+=(
    [+]="$ACTION_VOLUME_UP"
    [=]="$ACTION_VOLUME_UP"
    [-]="$ACTION_VOLUME_DOWN"
)

Visualizer

• vis: Works out of the box
• cava:

           if (strncmp(ttyname(0), "/dev/tty", 8) == 0 || strcmp(ttyname(0),
                 "/dev/console") == 0) inAtty = 1;
  

  needs to be replaced with

            if (ttyname(0) != NULL &&
                    (strncmp(ttyname(0), "/dev/tty", 8) == 0 ||
                     strcmp(ttyname(0), "/dev/console") == 0)) {
                inAtty = 1;
            }
  

Screenshots