kato
is a MPD client.
kato
is a mpd client.
It acts like a remote controller to a already running music server.
- Psuedo-TUI interface.
- Easy & Simple commands.
- Intuitive interface
You need to have a configured and running MPD
server.
You can download a binary from the releases section.
Or else if you have the Go
compiler installed. You can run
go install github.com/pspiagicw/kato@latest
If you use gox
, you can also run
gox install github.com/pspiagicw/kato@latest
To build the project, download the project and run go build .
git clone https://github.com/pspiagicw/kato
cd kato
go build .
kato
includes a thorough help section.
Just run kato help
kato help
For more help per command, run kato help [command]
Command | Description |
---|---|
play | Play the current song |
stop | Stop playback |
pause | Pause playback |
next | Play next song |
prev | Play previous song |
toggle | Toggle playback |
version | Print version info |
- Print info about current song
- Includes title, artist, quant size and frequency
- Run a album
- Interactively select the album
- The current queue is cleared.
random
is turned off.
- Play songs by a specific artist
- Multi-select songs.
- The current queue is cleared
random
is turned off.
- Shuffle all songs in the library.
random
is turned on.
- Control volume interactively.
- Control song position interactively.
- Use
l/h
to move right or left - Or use number keys to adjust percent directory (1=10%, 9=90%, 0=100%)
- Display the playlist in a pager.
- Display a simple dash UI with essential info.
- Simple keybinds to next/prev songs.
- Repeat current song indefinately.
repeat
is turned on.single
is turned on.
kato
doesn't aim to replace tools like ncmpcpp
and mpc
.
It only provides a helpful interface for common interactions like
- Playing a album
- Play all songs but shuffled.
It provides quality of life features that would require some scripting or a learning curve in other clients.
If you want complex, minute edits you WILL need to use tools like mpc
.
Or if you need a TUI experience complete with a visualizer and other goodies, you will need to use ncmpcpp
.
This tool is made to provide qol features, thus your opinion and contribution is essential to this project.
- You can file a issue to request a feature or report a bug
- If you a little bit of Go, you can fix/implement said feature/bug and file a PR.
You can also show your love for kato
by giving this project a star on GitHub
.