allen/miniplayer
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Cleaned up the readme

Browse Source
This commit is contained in:
Erica
2022-03-29 01:26:51 +00:00
parent b429e3f379
commit a20904fbb3
1 changed files with 78 additions and 48 deletions
Download Patch File Download Diff File Expand all files Collapse all files

126
README.md
View File

@ -24,51 +24,77 @@ pip install miniplayer
The config file is located at `~/.config/miniplayer/config`. The example configuration file, [`config.example`](config.example), has all the default values. You will need to create the file yourself. The config file is located at `~/.config/miniplayer/config`. The example configuration file, [`config.example`](config.example), has all the default values. You will need to create the file yourself.
#### player #### player
* ***font_width*:** The width of your font in pixels in the actual terminal. Wow, that volume step is huge. Why isn't my album art centered?
* ***font_height*:** The height of your font in pixels in the actual terminal.
![font-example](https://github.com/GuardKenzie/miniplayer/blob/main/img/font.png?raw=true) | Option | Description |
| -------------- | ----------------------------------------------------------------------------------------------------- |
| font_width | The width of your font in pixels in the actual terminal. |
| font_height | The height of your font in pixels in the actual terminal. |
| volume_step | The ammount (in percents) the volume will be adjusted on pressing the volume up and volume down keys. |
| album_art_only | Whether or not to only draw the album art and no other track info (`true/false`). |
| auto_close | Whether or not to automatically close the player once the mpd playlist has concluded (`true/false`). |
| show_playlist | Whether or not to show the playlist view. |
The `font_width` and `font_height` options are used to center the album art properly.Here is an example of how they should be measured.
![font-example](https://github.com/GuardKenzie/miniplayer/blob/main/img/font.png?raw=true)
* ***volume_step*:** The ammount (in percents) the volume will be adjusted on pressing the volume up and volume down keys.
* ***album_art_only*:** Whether or not to only draw the album art and no other track info (`true/false`).
* ***auto_close*:** Whether or not to automatically close the player once the mpd playlist has concluded (`true/false`).
* ***show_playlist*:** Whether or not to show the playlist view.
#### art #### art
* ***music_directory*:** The path to your music directory for extracting album art from the files. Why listen to music if you can't look at the pretty album art?
* ***http_base_url*:** Base URL of webserver which serves the album art for your albums (takes precedence over `music_directory`). Useful for users of Android MPD clients _MAFA_ or _MPDroid_. For more information see [the MPDroid wiki](https://github.com/abarisain/dmix/wiki/Album-Art-on-your-LAN).
* ***http_cover_filenames*:** Space separated list of filenames to use in the call to the webserver to fetch the album art. | Option | Description |
* ***image_method*:** The method to use for drawing album art. Available values are `pixcat` and `ueberzug` | -------------------- | --------------------------------------------------------------------------------------------- |
If you are not using Kitty, try `ueberzug`. | music_directory | The path to your music directory for extracting album art from the files. |
| http_base_url | Base URL of webserver which serves the album art for your albums (takes precedence over `music_directory`). Useful for users of Android MPD clients _MAFA_ or _MPDroid_. For more information see [the MPDroid wiki](https://github.com/abarisain/dmix/wiki/Album-Art-on-your-LAN).
| http_cover_filenames | Space separated list of filenames to use in the call to the webserver to fetch the album art. |
| image_method | The method to use for drawing album art. Available values are `pixcat` and `ueberzug`. |
#### mpd #### mpd
* ***host*:** The mpd host Tell me your mpd address please!
* ***port*:** The mpd port
* ***pass*:** The mpd password | Option | Description |
| ------ | ---------------- |
| host | The mpd host |
| port | The mpd port |
| pass | The mpd password |
#### keybindings #### keybindings
This section allows you to change the keybinds for the player. The format for a keybind is `key = action` (for example `p = play_pause` or `left = last_track`). Available actions are This section allows you to change the keybinds for the player. The format for a keybind is `key = action` (for example `p = play_pause` or `left = last_track`).
* `play_pause`
* `next_track` To use `shift` as a modifier, capitalize the keybinding (i.e. `shift + p` becomes `P` and `shift + left` becomes `Left`). **This only works for alpha keys and the arrow keys!**
* `last_track`
* `volume_down` | Available actions |
* `volume_up` | ----------------- |
* `toggle_info` | `play_pause` |
* `help` | `next_track` |
* `quit` | `last_track` |
* `select_down` | `volume_down` |
* `select_up` | `volume_up` |
* `select` | `toggle_info` |
| `help` |
| `quit` |
| `select_down` |
| `select_up` |
| `select` |
| `move_up` |
| `move_down` |
| `shuffle` |
| `repeat` |
| `delete` |
#### theme #### theme
This section allows you to customise the colors and progress bar Make it yours!
* ***accent_color*:** The color to use for selections in the playlist
* ***bar_color*:** The color for the progress bar | Option | Description |
* ***time_color*:** The color for the time stamp | ------------ | ---------------------------------------------------------- |
* ***bar_body*:** A single character to use for the body of the progress bar | accent_color | The color to use for selections in the playlist |
* ***bar_head*:** A single character to use for the head of the progress bar | bar_color | The color for the progress bar |
| time_color | The color for the time stamp |
| bar_body | A single character to use for the body of the progress bar |
| bar_head | A single character to use for the head of the progress bar |
The following terminal colors can be used: The following terminal colors can be used:
* `black` * `black`
@ -79,26 +105,30 @@ The following terminal colors can be used:
* `magenta` * `magenta`
* `cyan` * `cyan`
* `white` * `white`
* `auto`
If the `auto` color is specified, the player will try to determine the dominant color in the album art and use that. You can also use the magic colour called `auto`. If you pick it, the player will try to determine the dominant color in the album art and use that instead.
## Default keybinds ## Default keybinds
| Key | function | | Key | Function |
| ----- | ------------------ | | ------------ | ---------------------------------- |
| h | Show keybinds | | h | Show keybinds |
| p | Play/pause | | p | Play/pause |
| > | Next track | | > | Next track |
| < | Last track | | < | Last track |
| q | Quit | | q | Quit |
| + | Volume up | | + | Volume up |
| - | Volume down | | - | Volume down |
| i | Toggle info | | i | Toggle info |
| Up | Selection up | | Up | Selection up |
| Down | Selection down | | Down | Selection down |
| Enter | Play selected song | | Enter | Play selected song |
| Delete | Remove selected song from playlist |
| Shift + up | Move selected song up |
| Shift + down | Move selected song down |
| x | Shuffle playlist |
| r | Toggle repeat |
These keybinds can be changed by editing the config file. See the [`config.example`](config.example) file for the format. These keybinds can be changed by editing the config file. See the [`config.example`](config.example) file for the format.