4
pianobar \- console pandora.com music player
11
is a lightweight console music player for the personalized online radio
15
.I $XDG_CONFIG_HOME/pianobar/config
17
.I ~/.config/pianobar/config
19
Per-user configuration file. See
27
Global/per-user audio output configuration. See libao documentation at
28
http://xiph.org/ao/doc/config.html
32
The configuration file consists of simple
34
lines. Each terminated with a newline (\\n) character. Keys and values are both
35
case sensitive. act_*-keys control
45
Love currently played song.
49
Ban current track. It will not be played again and can only removed using the
50
pandora.com web interface.
53
.B act_stationaddmusic = a
54
Add more music to current station. You will be asked for a search string. Just
55
follow the instructions. If you're clueless try '?' (without quotes).
59
Bookmark current song or artist.
62
.B act_stationcreate = c
63
Create new station. You have to enter a search string and select the song or
64
artist of your choice.
67
.B act_stationdelete = d
68
Delete current station.
71
.B act_songexplain = e
72
Explain why this song is played.
75
.B act_stationaddbygenre = g
76
Add genre station provided by pandora.
84
Print information about currently played song/station.
88
Add shared station by id. id is a very long integer without "sh" at the
93
Move current song to another station
109
.B act_stationrename = r
110
Rename currently played station.
113
.B act_stationchange = s
114
Select another station.
118
Ban song for one month.
122
Show next songs in playlist.
125
.B act_stationselectquickmix = x
126
Select quickmix stations.
129
.B audio_format = {aacplus,mp3,mp3-hifi}
130
Select audio format. aacplus is default if both libraries (faad, mad) are
131
available. mp3-hifi is available for Pandora One customers only.
134
.B autostart_station = stationid
135
Play this station when starting up. You can get the
139
or the key you defined in
143
.B control_proxy = http://host:port/
144
Non-american users need a proxy to use pandora.com. Only the xmlrpc interface
145
will use this proxy. The music is streamed directly.
148
.B event_command = path
149
File that is executed when event occurs. See section
154
Keep a history of the last n songs (5, by default). You can rate these songs.
157
.B password = plaintext_password
158
Your pandora.com password. Plain-text.
161
.B proxy = http://host:port/
162
Use a http proxy. Note that this setting overrides the http_proxy environment
166
.B sort = {name_az, name_za, quickmix_01_name_az, quickmix_01_name_za, quickmix_10_name_az, quickmix_10_name_za}
167
Sort station list by name or type (is quickmix) and name. name_az for example
168
sorts by name from a to z, quickmix_01_name_za by type (quickmix at the
169
bottom) and name from z to a.
172
.B user = your@user.name
173
Your pandora.com username.
177
can be controlled through a fifo. You have to create it yourself by executing
179
mkfifo ~/.config/pianobar/ctl
181
Adjust the path if you set up a $XDG_CONFIG_HOME. Afterwards you can write
182
commands directly into the fifo. Example (next song):
184
echo -n 'n' > ~/.config/pianobar/ctl
187
is the keybinding for "next song". If you customized your keybindings you have to use these characters to control
189
.I This behaviour may change in the future!
194
nc -l -p 12345 -s localhost localhost > ~/.config/pianobar/ctl;
198
echo -ne 'n\\x1a' | nc -q 0 127.0.0.1 12345
203
can report certain "events" to an external application (see
205
). This application is started with the event name as it's first argument. More
206
information (artist, title, album, stationName, error code, error description,
207
song length in milliseconds, rating) is supplied through stdin.
209
Currently supported events are: artistbookmark, songban, songbookmark,
210
songexplain, songfinish, songlove, songmove, songshelf, songstart,
211
stationaddmusic, stationaddshared, stationcreate, stationdelete,
212
stationfetchplaylist, stationquickmixtoggle, stationrename
214
An example script can be found in the contrib/ directory of
219
Lars-Dominik Braun <PromyLOPh@lavabit.com>