https://github.com/ahloiscreamo/fmpc
fmpc | TUI browser for MPD using `fzf` and `ueberzugpp`
https://github.com/ahloiscreamo/fmpc
bash-script cli fzf mpd music music-player terminal-app terminal-music-player ueberzug
Last synced: 2 months ago
JSON representation
fmpc | TUI browser for MPD using `fzf` and `ueberzugpp`
- Host: GitHub
- URL: https://github.com/ahloiscreamo/fmpc
- Owner: ahloiscreamo
- Created: 2026-01-26T09:06:27.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-29T08:36:21.000Z (5 months ago)
- Last Synced: 2026-01-31T01:51:49.256Z (5 months ago)
- Topics: bash-script, cli, fzf, mpd, music, music-player, terminal-app, terminal-music-player, ueberzug
- Language: Shell
- Homepage:
- Size: 18.6 KB
- Stars: 11
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# fmpc - Fast MPC Browser
A minimalist, high-performance TUI browser for MPD using `fzf` and `ueberzugpp`.
## Features
* **Cover Art**: Renders album art using Ueberzug++.
* **Layouts**: Supports "Right" or "Bottom" preview modes (centered).
* **Search**: Uses `fzf` for instant library filtering.
* **Selection**: Select multiple tracks or albums with TAB to queue them.
* **Sync**: Auto-selects the currently playing song on startup & follow-focus song.
* **UI**: Simple ANSI colors with grey dividers for a cleaner look.
## Dependencies
* `mpd` / `mpc`
* `fzf`
* `ueberzugpp`
* `ffmpeg` (for cover extraction)
* `Nerd Fonts`
## Installation
1. Clone the repository and move both scripts to your bin directory:
```bash
chmod +x fmpc fmpc-play fmpc-follower
cp fmpc fmpc-play fmpc-follower ~/.local/bin/
```
2. Open `fmpc` and configure your music path:
```bash
export MUSIC_DIR="/path/to/your/music"
```
3. Choose your preferred layout at the top of the script:
```bash
export PREVIEW_POS="right" # Change to "bottom" for centered view
```
## Usage
Launch the browser:
```bash
fmpc
```
### Keybindings/--help
| Key | Action |
| --- | --- |
| **ENTER** | Play highlighted song |
| **TAB** | Select/Deselect multiple songs |
| **Ctrl-x** | Play all selected songs |
| **Ctrl-f** | Search for current playing song |
| **Ctrl-p** | Toggle Play/Pause |
| **Ctrl-n** | Next Track |
| **Ctrl-b** | Previous Track |
| **Ctrl-u** | Update MPD database |
| **ESC** | Clear search / Reset view |
| **Ctrl-q** | Quit |