This repository has been archived on 2026-01-13. You can view files and clone it, but cannot push or open issues or pull requests.
rmptui/README.md

55 lines
1.8 KiB
Markdown
Executable File

## rmptui - A MPD client in Rust
![LOC](https://tokei.rs/b1/github/krolyxon/rmptui?category=code)
![Release](https://img.shields.io/github/v/release/krolyxon/rmptui?color=%23c694ff)
[![GitHub Downloads](https://img.shields.io/github/downloads/krolyxon/rmptui/total.svg?label=GitHub%20downloads)](https://github.com/krolyxon/rmptui/releases)
rmptui is a minimal tui mpd client made with rust.
## rmptui in action
![](https://raw.githubusercontent.com/krolyxon/rmptui/master/assets/ss.png)
### Keys
- `q` OR `Ctr+C` to quit
- `p` to toggle pause
- `+` to increase volume
- `-` to decrease volume
- `D` to get dmenu prompt
- `j` OR `Down` to scroll down
- `k` OR `Up` to scroll up
- `J` to swap highlighted song with next one
- `K` to swap highlighted song with previous one
- `l` OR `Right` add song to playlist or go inside the directory
- `h` OR `Left` to go back to previous directory
- `Tab` to cycle through tabs
- `1` to go to queue
- `2` to go to directory browser
- `3` to go to playlists view
- `Enter` OR `l` OR `Right` to add song/playlist to current playlist
- `a` to append the song to current playing queue
- `Space`/`BackSpace` to delete the highlighted song from queue
- `f` to go forwards
- `b` to go backwards
- `>` to play next song from queue
- `<` to play previous song from queue
- `U` to update the MPD database
- `r` to toggle repeat
- `z` to toggle random
- `/` to search
- `g` to go to top of list
- `G` to go to bottom of list
### Prerequisites
- [MPD](https://wiki.archlinux.org/title/Music_Player_Daemon) installed and configured.
- [dmenu](https://tools.suckless.org/dmenu/) (optional)
### TODO
- [x] fix performance issues
- [x] improvements on queue control
- [x] add to playlists
- [x] search for songs
- [x] Human readable time format
- [x] metadata based tree view
- [x] view playlist
- [x] change playlist name
- [ ] add lyrics fetcher