A snappy, slick terminal client for MPD written in Zig with vim-keybindings and fuzzy-finding.
- Queue manipulation
- Fuzzy find through entire song library
- Music browser for manual browsing
muzi works on linux and macos
muzi is available on the AUR
yay -S muziTo build muzi from source you need Zig 0.15 installed, running the following command in the source directory will build to $source/zig-out/bin/muzi
zig build -Doptimize=ReleaseFastA running mpd instance will be required. The default host and port are 127.0.0.1:6600. The port and host can be specified as so:
muzi -H "127.0.0.1" -p 6600muzi is a stateful mpd client so if the mpd library is updated while muzi is active it will need to be resynced. This must be done by quitting and launching the program again.
normal queue
All delete commands save the selected songs to a yank buffer
| key | action |
|---|---|
| q | quit |
| k | cursor up |
| j | cursor down |
| Ctrl+U | cursor up half queue |
| Ctrl+D | cursor down half queue |
| g | go top |
| G | go bottom |
| h | prev song |
| l | next song |
| ENTER | play selected song |
| x, d | delete from queue at cursor position |
| X | clear queue |
| D | clear till |
| y | yank at current position |
| Y | yank till end |
| p | put (in yank buffer) |
| v | enter visual mode |
| SPACE | play/pause |
| left | seek -5 |
| right | seek +5 |
| SHIFT+left | seek -15 |
| SHIFT+right | seek +15 |
| up | increase volume |
| up | decrease volume |
| f | switch to fuzzy find |
| b | switch to browser |
visual queue All delete commands save the selected songs to a yank buffer
| key | action |
|---|---|
| ESC, v | exit visual mode |
| k | cursor up |
| j | cursor down |
| Ctrl+U | cursor up half queue |
| Ctrl+D | cursor down half queue |
| g | go top |
| G | go bottom |
| d, x | delete selected |
| y | yank selected |
fuzzy find
| key | action |
|---|---|
| ESC | return to normal queue |
| Backspace | delete |
| Ctrl+U | cursor up |
| Ctrl+D | cursor down |
| ENTER | add song to queue |
| rest | type |
browser
| key | action |
|---|---|
| ESC | return to normal queue |
| k | cursor up |
| j | cursor down |
| Ctrl+U | cursor up half queue |
| Ctrl+D | cursor down half queue |
| g | go top |
| G | go bottom |
| h | prev column |
| l | next column |
| n | cycle 10 best query matches |
| ENTER | add to queue |
| SPACE | clear queue + add to queue |
| / | search in column |
| ENTER, ESC *while searching | exit search |