aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorHarvey Tindall <hrfee@protonmail.ch>2020-08-22 15:40:24 +0100
committerHarvey Tindall <hrfee@protonmail.ch>2020-08-22 15:40:24 +0100
commit54dcac02e69545743c4cb07942428e4fdaea515e (patch)
tree9978381010d037cf70554e53e00185fe2096e8a9 /README.md
parent5020e1c9298bfa76e89016be1bd2dd157563ea41 (diff)
downloadwaybar-mpris-54dcac02e69545743c4cb07942428e4fdaea515e.tar.gz
waybar-mpris-54dcac02e69545743c4cb07942428e4fdaea515e.zip
Add flags, executable and improve README.md
Diffstat (limited to 'README.md')
-rw-r--r--README.md16
1 files changed, 15 insertions, 1 deletions
diff --git a/README.md b/README.md
index 8ae1301..a527fb3 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,17 @@
## waybar-mpris
-a custom waybar component for displaying info from MPRIS2 players. Currently WIP.
+a custom waybar component for displaying info from MPRIS2 players. It automatically focuses on currently playing music players, and can easily be customized.
+
+## Usage
+When running, the program will pipe out json in waybar's format. Make a custom component in your configuration and set `return-type` to `json`, and `exec` to the path to the program.
+```
+Usage of ./waybar-mpris:
+ --order string Element order. (default "SYMBOL:ARTIST:ALBUM:TITLE")
+ --pause string Pause symbol/text to use. (default "")
+ --play string Play symbol/text to use. (default "▶")
+ --separator string Separator string to use between artist, album, and title. (default " - ")
+```
+* Modify the order of components with `--order`. `SYMBOL` is the play/paused icon or text, other options are self explanatory.
+* `--play/--pause` specify the symbols or text to display when music is paused/playing respectively.
+* --separator specifies a string to separate the artist, album and title text.
+