minor changes
This commit is contained in:
aditya-K2
parent
cf3101d778
commit
65182b2b42
@ -1,203 +0,0 @@
|
||||
* [Prerequisites](#prerequisites)
|
||||
* [Installing / Building](#installing--building)
|
||||
* [Configuration](#configuration)
|
||||
* [MPD Port](#mpd-port)
|
||||
* [Music Directory](#music-directory)
|
||||
* [Default Image Path](#default-image-path)
|
||||
* [Additional Padding and Extra Image Width](#additional-padding-and-extra-image-width)
|
||||
* [Image Rendering](#image-rendering)
|
||||
* [Cache Directory](#cache-directory)
|
||||
* [Key Mappings](#key-mappings)
|
||||
* [Getting Album Art from LastFm API](#getting-album-art-from-lastfm-api)
|
||||
|
||||
# Prerequisites
|
||||
|
||||
- Music Player Daemon must be setup and Running
|
||||
- Go Should Be Installed ( For Building )
|
||||
- After Reading this it is highly recommended to read the [sample_config](https://github.com/aditya-K2/goMP/blob/master/sample_config.yml)
|
||||
|
||||
# Installing / Building
|
||||
|
||||
```bash
|
||||
git clone https://github.com/aditya-K2/goMP &&
|
||||
cd goMP &&
|
||||
go build
|
||||
```
|
||||
|
||||
# Configuration
|
||||
|
||||
Configuration of goMP is done through a `config.yml` file in `$HOME/config/goMP/`
|
||||
|
||||
It is essential to have some config options defined in order to have a smooth experience.
|
||||
|
||||
## MPD Port
|
||||
|
||||
This is the port where your Music Player Daemon Is Running
|
||||
|
||||
```yml
|
||||
MPD_PORT : "6600"
|
||||
```
|
||||
|
||||
## Music Directory
|
||||
|
||||
The Most Essential config option is `MUSIC_DIRECTORY` It is the path to your Music Folder that you have provided to mpd
|
||||
in the `mpd.conf` file. If you do not provide the path to the `MUSIC_DIRECTORY` then goMP parses the mpd.conf file for
|
||||
the `music_directory` option ( It is to be noted that goMP assumes that your mpd.conf file is at
|
||||
`$HOME/.config/mpd/mpd.conf`
|
||||
|
||||
```yml
|
||||
MUSIC_DIRECTORY : "~/Music"
|
||||
```
|
||||
|
||||
The reason why you need to setup `MUSIC_DIRECTORY` manually because the paths to the songs received from mpd are relative the `MUSIC_DIRECTORY`.
|
||||
|
||||
## Default Image Path
|
||||
|
||||
This is the Fallback Image that will be rendered if goMP doesn't find the embedded cover art or LastFM Cover Art.
|
||||
|
||||
```yml
|
||||
DEFAULT_IMAGE_PATH : "/path/to/default/image"
|
||||
```
|
||||
|
||||
## Additional Padding and Extra Image Width
|
||||
|
||||
### Image Rendering
|
||||
|
||||
The Default Position of the Image without any configuration assumes that you have no font or terminal padding or margin so Image will
|
||||
be rendered at different places in different terminals, Also the TUIs calculates positions with the according to rows and columns
|
||||
and the image is rendered at pixel positions so the exact position can't be defined [ the app tries its best by calculating
|
||||
the font width and then predicting the position but it is best that you define some extra padding and your own image width ratio
|
||||
in config.yml. Please Read more about it in the [sample_config](https://github.com/aditya-K2/goMP/blob/master/sample_config.yml)
|
||||
|
||||
for e.g
|
||||
|
||||
```yml
|
||||
# Default Values. Might be different than sample_config.yml
|
||||
ADDITIONAL_PADDING_X : 11
|
||||
ADDITIONAL_PADDING_Y : 18
|
||||
|
||||
IMAGE_WIDTH_EXTRA_X : -0.7
|
||||
IMAGE_WIDTH_EXTRA_Y : -2.6
|
||||
```
|
||||
|
||||
|
||||
Let's say upon opening goMP for the first time and your image is rendered this way.
|
||||
|
||||
Here the `Y` Position is too low hence we have to decrease the `ADDITIONAL_PADDING_Y` so that image will be rendered
|
||||
in a better position so we decrement the `ADDITIONAL_PADDING_Y` by `9`
|
||||
|
||||
Now the configuration becomes
|
||||
```yml
|
||||
ADDITIONAL_PADDING_Y : 9
|
||||
```
|
||||
|
||||
and the image appears like this:
|
||||
|
||||
|
||||
|
||||
One might be happy the way things turn out but for the perfectionist like me this is not enough.
|
||||
You can notice that the Height of the image is a little bit more than the box height and hence the image is flowing outside the box. Now it's time to change the `WIDTH_Y`.
|
||||
|
||||
Width can be changed by defining the `IMAGE_WIDTH_EXTRA_Y` and `IMAGE_WIDTH_EXTRA_X` it act's a little differently think of it like a chunk which is either added or subtracted from the image's original width. We can look at the configuration and realize that the chunk `IMAGE_WIDTH_EXTRA_Y` when subtracted from the original `IMAGE_WIDTH` doesn't get us the proper result and is a little to low. We need to subtract a more bigger chunk, Hence we will increase the magnitude of `IMAGE_WIDTH_EXTRA_Y` or decrease `IMAGE_WIDTH_EXTRA_Y`
|
||||
|
||||
Now the Configuration becomes:
|
||||
```yml
|
||||
IMAGE_WIDTH_EXTRA_Y : - 3.2
|
||||
```
|
||||
and the image appears like this:
|
||||
|
||||
|
||||
|
||||
Which looks perfect. 🎉
|
||||
|
||||
Read More about Additional Padding and Image Width in the [sample_config](https://github.com/aditya-K2/goMP/blob/master/sample_config.yml)
|
||||
|
||||
Please change the configuration according to your needs.
|
||||
|
||||
## Cache Directory
|
||||
|
||||
By Default Images are cached to avoid re-extracting images and making redundant API Calls. The Extracted Images are copied to the `CACHE_DIR` and a reference is added to the `CACHE_FILE`
|
||||
|
||||
```yml
|
||||
CACHE_DIR : "/path/to/the/cache/Directory/"
|
||||
CACHE_FILE : "/path/to/the/cache/file" # Cache file stores the path to all the images ( think of it like a database. )
|
||||
```
|
||||
|
||||
This Technique has some drawbacks and the `CACHE_FILE` mechanism will soon be deprecated but for now add this lines to your `config.yml`. Don't Worry after changing the mechanism you won't have to make a single change to `config.yml` file the changes would be under the hood ( you won't even notice ).
|
||||
|
||||
Read More about Caching in the [sample_config](https://github.com/aditya-K2/goMP/blob/master/sample_config.yml)
|
||||
|
||||
## 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", "TAB", "[" ] # using the quotes is neccessary.
|
||||
```
|
||||
|
||||
Following functions are provided :
|
||||
|
||||
| Functions |
|
||||
|------------------------------------|
|
||||
| showChildrenContent |
|
||||
| togglePlayBack |
|
||||
| showParentContent |
|
||||
| nextSong |
|
||||
| clearPlaylist |
|
||||
| previousSong |
|
||||
| addToPlaylist |
|
||||
| toggleRandom |
|
||||
| toggleRepeat |
|
||||
| decreaseVolume |
|
||||
| increaseVolume |
|
||||
| navigateToFiles |
|
||||
| navigateToPlaylist |
|
||||
| navigateToMostPlayed |
|
||||
| navigateToSearch |
|
||||
| quit |
|
||||
| stop |
|
||||
| updateDB |
|
||||
| deleteSongFromPlaylist |
|
||||
| FocusSearch |
|
||||
|
||||
## Getting Album Art from [LastFm API](https://www.last.fm/api)
|
||||
|
||||
1. Generate API Key [here](https://www.last.fm/login?next=%2Fapi%2Faccount%2Fcreate%3F_pjax%3D%2523content)
|
||||
|
||||
|
||||
|
||||
2. Add the api key and api secret to config.yml
|
||||
|
||||
```yml
|
||||
GET_COVER_ART_FROM_LAST_FM : "TRUE" # Turn On Getting Album art from lastfm api
|
||||
LASTFM_API_KEY: "YOUR API KEY HERE"
|
||||
LASTFM_API_SECRET: "YOUR API SECRET HERE"
|
||||
```
|
||||
3. Auto correct
|
||||
|
||||
|
||||
:
|
||||
|
||||
```yml
|
||||
LASTFM_AUTO_CORRECT: 1 # 0 means it is turned off
|
||||
```
|
||||
Loading…
Reference in New Issue
Block a user