summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorLars-Dominik Braun <PromyLOPh@lavabit.com>2009-04-04 15:27:53 +0200
committerLars-Dominik Braun <PromyLOPh@lavabit.com>2009-04-04 15:27:53 +0200
commitd6be5d8b24ad75503e6903dbd3ff084c992b53ed (patch)
tree12c723e992f2f468c5aa274e5a85a73622e96bbc /src
parent2a76ecfb59b3ca52ed59070e6cddade407279b6b (diff)
downloadpianobar-windows-d6be5d8b24ad75503e6903dbd3ff084c992b53ed.tar.gz
pianobar-windows-d6be5d8b24ad75503e6903dbd3ff084c992b53ed.tar.bz2
pianobar-windows-d6be5d8b24ad75503e6903dbd3ff084c992b53ed.zip
Add some remote control examples to manpage
Diffstat (limited to 'src')
-rw-r--r--src/pianobar.129
1 files changed, 29 insertions, 0 deletions
diff --git a/src/pianobar.1 b/src/pianobar.1
index 1a6eac1..9140045 100644
--- a/src/pianobar.1
+++ b/src/pianobar.1
@@ -165,5 +165,34 @@ Your pandora.com password. Plain-text.
.B user = your@user.name
Your pandora.com username.
+.SH REMOTE CONTROL
+.B pianobar
+can be controlled through a fifo. You have to create it yourself by executing
+
+ mkfifo ~/.config/pianobar/ctl
+
+Adjust the path if you set up a $XDG_CONFIG_HOME. Afterwards you can write
+commands directly into the fifo. Example (next song):
+
+ echo -n 'n' > ~/.config/pianobar/ctl
+
+.B n
+is the keybinding for "next song". If you customized your keybindings you have to use these characters to control
+.B pianobar.
+.I This behaviour may change in the future!
+
+Please note: Commands like "select station" or "delete station" don't make
+sense at the moment, because the expected input is read from stdin, but not
+from the fifo.
+
+Another example:
+
+ while true; do;
+ nc -l -p 12345 -s localhost localhost > ~/.config/pianobar/ctl;
+ sleep 1;
+ done
+
+ echo -ne 'n\\x1a' | nc -q 0 127.0.0.1 12345
+
.SH AUTHOR
Lars-Dominik Braun <PromyLOPh@lavabit.com>