1pianobar(1) General Commands Manual pianobar(1)
2
6 pianobar - console pandora.com music player
7
10 pianobar
11
14 pianobar is a lightweight console music player for the personalized on‐
15 line radio pandora.com.
16
19 $XDG_CONFIG_HOME/pianobar/config or ~/.config/pianobar/config
20 Per-user configuration file. See CONFIGURATION.
21 /etc/libao.conf or ~/.libao
23 Global/per-user audio output configuration. See libao documenta‐
24 tion at http://xiph.org/ao/doc/config.html
25
28 The configuration file consists of simple key = value lines, each ter‐
29 minated with a newline (\n) character. Keys are case sensitive.
30 act_* keys control pianobar's key-bindings. Every one-byte character
32 except for \x00 and the special value disabled are allowed here.
33 act_help = ?
36 Show keybindings.
37 act_songlove = +
40 Love currently played song.
41 act_songban = -
44 Ban current track. It will not be played again and can only re‐
45 moved using the pandora.com web interface.
46 act_stationaddmusic = a
49 Add more music to current station. You will be asked for a
50 search string. Just follow the instructions. If you're clueless
51 try '?' (without quotes).
52 act_bookmark = b
55 Bookmark current song or artist.
56 act_stationcreate = c
59 Create new station. You have to enter a search string and select
60 the song or artist of your choice.
61 act_stationdelete = d
64 Delete current station.
65 act_songexplain = e
68 Explain why this song is played.
69 act_stationaddbygenre = g
72 Add genre station provided by pandora.
73 act_history = h
76 Show history.
77 act_songinfo = i
80 Print information about currently played song/station.
81 act_addshared = j
84 Add shared station by id. id is a very long integer without "sh"
85 at the beginning.
86 act_managestation = =
89 Delete artist/song seeds or feedback.
90 act_songmove = m
93 Move current song to another station
94 act_songnext = n
97 Skip current song.
98 act_songpause = S
101 Pause playback
102 act_songpausetoggle = p
105 act_songpausetoggle2 = <Space>
106 Pause/resume playback
107 act_songplay = P
110 Resume playback
111 act_quit = q
114 Quit pianobar.
115 act_stationrename = r
118 Rename currently played station.
119 act_stationchange = s
122 Select another station. The station list can be filtered like
123 most lists by entering a search string instead of a station num‐
124 ber.
125 act_songtired = t
128 Ban song for one month.
129 act_upcoming = u
132 Show next songs in playlist.
133 act_stationcreatefromsong = v
136 Create new station from the current song or artist.
137 act_stationselectquickmix = x
140 Select quickmix stations. You can toggle the selection with 't',
141 select all with 'a' or select none with 'n'.
142 act_voldown = (
145 Decrease volume.
146 act_volreset = ^
149 Reset volume.
150 act_volup = )
153 Increase volume.
154 act_settings = !
157 Change Pandora settings.
158 at_icon = @
161 Replacement for %@ in station format string. It's " @ " by de‐
162 fault.
163 audio_quality = {high, medium, low}
166 Select audio quality.
167 audio_pipe = /path/to/fifo
170 Stream decoded, raw audio samples to a pipe instead of the de‐
171 fault audio device. Use sample_rate to enforce a fixed sample
172 rate.
173 autoselect = {1,0}
176 Auto-select last remaining item of filtered list. Currently en‐
177 abled for station selection only.
178 autostart_station = stationid
181 Play this station when starting up. You can get the stationid by
182 pressing i or the key you defined in act_songinfo.
183 ban_icon = </3
186 Icon for banned songs.
187 bind_to = {if!tunX,host!x.x.x.x,..}
190 This sets the interface name to use as outgoing network inter‐
191 face. The name can be an interface name, an IP address, or a
192 host name. (from CURLOPT_INTERFACE)
193 It can be used as a replacement for control_proxy in conjunction
195 with OpenVPN's option route-nopull.
196 buffer_seconds = 5
199 Audio buffer size in seconds.
200 ca_bundle = /etc/ssl/certs/ca-certificates.crt
203 Path to CA certifiate bundle, containing the root and intermedi‐
204 ate certificates required to validate Pandora's SSL certificate.
205 control_proxy = http://user:password@host:port/
208 Non-american users need a proxy to use pandora.com. Only the
209 xmlrpc interface will use this proxy. The music is streamed di‐
210 rectly.
211 decrypt_password = R=U!LH$O2B#
214 device = android-generic
217 encrypt_password = 6#26FRL$ZWD
220 event_command = path
223 File that is executed when event occurs. See section EVENTCMD
224 fifo = $XDG_CONFIG_HOME/pianobar/ctl
227 Location of control fifo. See section REMOTE CONTROL
228 format_list_song = %i) %a - %t%r
231 Available format characters:
232 %i Song number
234 %a Song artist
236 %t Song title
238 %r Rating icon
240 %d Song duration
242 %@
244 The at_icon
246 %s
248 Song’s station, if not the current station.
250 format_msg_none = %s
253 format_msg_info = (i) %s
254 format_msg_nowplaying = |> %s
255 format_msg_time = # %s
256 format_msg_err = /!\ %s
257 format_msg_question = [?] %s
258 format_msg_list = %s
259 Message format strings. %s is replaced with the actual message.
260 format_nowplaying_song = "%t" by "%a" on "%l"%r%@%s
263 Now playing song message format. Available format characters
264 are:
265 %t Song title
267 %a Song artist
269 %l Album name
271 %r Rating icon
273 %@ at_icon if station is quickmix, empty otherwise.
275 %s Real station name if quickmix
277 %u Song detail url
279 format_nowplaying_station = Station "%n" (%i)
282 Now playing station format. Available format characters are:
283 %n Station name
285 %i Station id
287 format_time = %s%r/%t
290 Time format.
291 %e Elapsed time
293 %r Remaining time
295 %s Sign
297 %t Total time
299 gain_mul = 1.0
302 Pandora sends a ReplayGain value with every song. This sets a
303 multiplier so that the gain adjustment can be reduced. 0.0 means
304 no gain adjustment, 1.0 means full gain adjustment, values inbe‐
305 tween reduce the magnitude of gain adjustment.
306 history = 5
309 Keep a history of the last n songs (5, by default). You can rate
310 these songs.
311 love_icon = <3
314 Icon for loved songs.
315 max_retry = 3
318 Max failures for several actions before giving up.
319 partner_password = AC7IBG09A3DTSYM4R41UJWL07VLN8JI7
322 partner_user = android
325 password = plaintext_password
328 Your pandora.com password. Plain-text.
329 password_command = gpg --decrypt ~/password
332 Use output of command as password. This setting is overridden by
333 specifying a password with password.
334 proxy = http://user:password@host:port/
337 Use a http proxy. Note that this setting overrides the
338 http_proxy environment variable. Only "Basic" http authentica‐
339 tion is supported.
340 rpc_host = tuner.pandora.com
343 rpc_tls_port = 443
346 sample_rate = 0
349 Force fixed output sample rate. The default, 0, uses the
350 stream’s sample rate.
351 sort = {name_az, name_za, quickmix_01_name_az, quickmix_01_name_za,
354 quickmix_10_name_az, quickmix_10_name_za}
355 Sort station list by name or type (is quickmix) and name.
356 name_az for example sorts by name from a to z, quick‐
357 mix_01_name_za by type (quickmix at the bottom) and name from z
358 to a.
359 timeout = 30
362 Network operation timeout.
363 tired_icon = zZ
366 Icon for temporarily suspended songs.
367 user = your@user.name
370 Your pandora.com username.
371 volume = 0
374 Initial volume correction in dB. Usually between -30 and +5.
375
378 pianobar can be controlled through a fifo. You have to create it your‐
379 self by executing
380 mkfifo ~/.config/pianobar/ctl
382 Adjust the path if you set up a $XDG_CONFIG_HOME or changed the fifo
384 setting. Afterwards you can write commands directly into the fifo. Ex‐
385 ample (next song):
386 echo -n 'n' > ~/.config/pianobar/ctl
388 n is the keybinding for "next song". If you customized your keybindings
390 you have to use these characters to control pianobar. This behaviour
391 may change in the future!
392 Another example:
394 while true; do;
396 nc -l -p 12345 -s localhost localhost > ~/.config/pianobar/ctl;
397 sleep 1;
398 done
399 echo -ne 'n\x1a' | nc -q 0 127.0.0.1 12345
401
404 pianobar can report certain "events" to an external application (see
405 CONFIGURATION ). This application is started with the event name as
406 it's first argument. More information like error code and description,
407 was well as song information related to the current event, is supplied
408 through stdin.
409 Currently supported events are: artistbookmark, songban, songbookmark,
411 songexplain, songfinish, songlove, songmove, songshelf, songstart, sta‐
412 tionaddgenre, stationaddmusic, stationaddshared, stationcreate, sta‐
413 tiondelete, stationdeleteartistseed, stationdeletefeedback, station‐
414 deletesongseed, stationfetchinfo, stationfetchplaylist, stationfetch‐
415 genre stationquickmixtoggle, stationrename, userlogin, usergetstations
416 An example script can be found in the contrib/ directory of pianobar's
418 source distribution.
419
422 Lars-Dominik Braun <lars@6xq.net>
423 pianobar(1)