A minimalist, high-performance TUI browser for MPD using fzf and ueberzugpp.

• Cover Art Rendering: Supports high-performance image rendering (including Sixel out of the box).
• Flexible Layouts: Supports "Right" or "Bottom" preview modes with custom centering.
• Instant Filtering: Uses fzf for super fast library searching.
• Batch Selection: Select multiple tracks or folders with TAB to queue them.
• Synchronization: Auto-selects the currently playing song on startup & supports follow-focus mode.
• Minimalist UI: Simple ANSI colors with grey dividers for a cleaner terminal aesthetic.

1. Clone the repository:

git clone https://github.com/ahloiscreamo/fmpc && cd fmpc

2. Run the install script:

bash install.sh

Note: A custom install location can be passed as an argument: bash install.sh /custom/path. For contributors, --dev installs via symlinks so edits to the repo take effect immediately.

3. Configure fmpc by creating ~/.config/fmpc/config:

# vim: set ft=bash:
export MUSIC_DIR="/path/to/your/music"       # defaults to your mpd.conf music_directory
export PREVIEW_POS="right"                   # right|bottom
export PREVIEW_SIZE="50%"

# --- Optional Advanced Image Tuning ---

# Image rendering protocol (sixel, kitty, iterm2, x11, wayland, chafa)
export UB_OUTPUT="sixel"                     # defaults to sixel

# Custom offsets for bottom layout (PREVIEW_POS="bottom")
# export BOTTOM_OFFSET_Y="3"                 # push image down from top (rows)
# export BOTTOM_H_ADJUST="3"                 # shrink image height to fit (rows)
# export BOTTOM_MANUAL_ADJUST="2"            # nudge right to center the image (columns)

# Custom offsets for right layout (PREVIEW_POS="right")
# export RIGHT_OFFSET_Y="6"                  # push image down from top (rows)
# export RIGHT_H_ADJUST="6"                  # shrink image height to fit (rows)

Note: Never edit the scripts directly for configuration — use the config file above so your settings are preserved across updates and reinstalls.

fmpc