91 lines
2.3 KiB
Markdown
91 lines
2.3 KiB
Markdown
# goMP
|
|
|
|
|
|
|
|
MPD client inspired by ncmpcpp written in GO
|
|
|
|
https://user-images.githubusercontent.com/51816057/140478368-5b724b2f-2499-4150-9569-c54734b3d4c1.mp4
|
|
|
|
# Roadmap
|
|
|
|
- [ ] Add Functionality to Sort out most played songs
|
|
- [x] Add a config parser
|
|
- [x] Image Previews
|
|
- [ ] Fuzzy Searching
|
|
- [ ] Visual Mode (like vim) for updating playlists
|
|
- [ ] Music Visualizer
|
|
|
|
# Setting Up
|
|
|
|
- Music Player Daemon must be setup
|
|
- Go Should Be Installed ( for building )
|
|
- Make a YAML/TOML file in ``$HOME/.config/goMP`` named config.yml / config.toml
|
|
- Read the sample_config.yml for config options
|
|
|
|
# Installing / Building
|
|
|
|
```bash
|
|
git clone https://github.com/aditya-K2/goMP &&
|
|
cd goMP &&
|
|
go build
|
|
```
|
|
|
|
# Configuration
|
|
|
|
## Key Mappings
|
|
|
|
Following Keys can be used for Mappings
|
|
|
|
| Keys | Using them in Config |
|
|
|-----------------|-----------------------|
|
|
| a-z | a-z |
|
|
| A-Z | A-z |
|
|
| {,},(,),[,],<,> | {,},(,),[,],<,> |
|
|
| Enter(Return) | ENTER/RETURN |
|
|
| Tab | TAB |
|
|
| Space | SPACE |
|
|
|
|
See config/kMap.go for more information
|
|
|
|
For mapping a key to some function use the following format:
|
|
|
|
|
|
```yml
|
|
Function: [ firstMapping, secondMapping, thirdMapping]
|
|
```
|
|
for.eg
|
|
|
|
|
|
```yml
|
|
togglePlayBack : [ "p", "T" ] # using the quotes is neccessary.
|
|
```
|
|
|
|
Following functions are provided :
|
|
|
|
| Functions |
|
|
|------------------------------------|
|
|
| "showChildrenContent", |
|
|
| "togglePlayBack", |
|
|
| "showParentContent", |
|
|
| "nextSong", |
|
|
| "clearPlaylist", |
|
|
| "previousSong", |
|
|
| "addToPlaylist", |
|
|
| "toggleRandom", |
|
|
| "toggleRepeat", |
|
|
| "decreaseVolume", |
|
|
| "increaseVolume", |
|
|
| "navigateToFiles", |
|
|
| "navigateToPlaylist", |
|
|
| "navigateToMostPlayed", |
|
|
| "quit", |
|
|
| "stop", |
|
|
| "updateDB", |
|
|
| "deleteSongFromPlaylist", |
|
|
|
|
### Tested on following terminals:
|
|
|
|
- Alacritty
|
|
- ST
|
|
- URXVT
|