table of contents
pianobar(1) | General Commands Manual | pianobar(1) |
NAME¶
pianobar - console pandora.com music playerSYNOPSIS¶
pianobarDESCRIPTION¶
pianobar is a lightweight console music player for the personalized online radio pandora.com.FILES¶
$XDG_CONFIG_HOME/pianobar/config or ~/.config/pianobar/configPer-user configuration file. See
CONFIGURATION.
Global/per-user audio output configuration.
See libao documentation at http://xiph.org/ao/doc/config.html
CONFIGURATION¶
The configuration file consists of simple key = value lines, each terminated with a newline (\n) character. Note that keys and values are both case sensitive, and there must be exactly one space on each side of the equals sign.- act_help = ?
- Show keybindings.
- act_songlove = +
- Love currently played song.
- act_songban = -
- Ban current track. It will not be played again and can only
removed using the pandora.com web interface.
- act_stationaddmusic = a
- Add more music to current station. You will be asked for a
search string. Just follow the instructions. If you're clueless try '?'
(without quotes).
- act_bookmark = b
- Bookmark current song or artist.
- act_stationcreate = c
- Create new station. You have to enter a search string and
select the song or artist of your choice.
- act_stationdelete = d
- Delete current station.
- act_songexplain = e
- Explain why this song is played.
- act_stationaddbygenre = g
- Add genre station provided by pandora.
- act_history = h
- Show history.
- act_songinfo = i
- Print information about currently played song/station.
- act_addshared = j
- Add shared station by id. id is a very long integer without
"sh" at the beginning.
- act_managestation = =
- Delete artist/song seeds or feedback.
- act_songmove = m
- Move current song to another station
- act_songnext = n
- Skip current song.
- act_songpause = p
- Pause/Continue
- act_quit = q
- Quit pianobar.
- act_stationrename = r
- Rename currently played station.
- act_stationchange = s
- Select another station. The station list can be filtered
like most lists by entering a search string instead of a station number.
- act_songtired = t
- Ban song for one month.
- act_upcoming = u
- Show next songs in playlist.
- act_stationselectquickmix = x
- Select quickmix stations. You can toggle the selection with
't', select all with 'a' or select none with 'n'.
- act_voldown = (
- Decrease volume.
- act_volup = )
- Increase volume.
- at_icon = @
- Replacement for %@ in station format string. It's " @
" by default.
- audio_format = {aacplus-lofi,aacplus,mp3,mp3-hifi}
- Select audio format. aacplus is default if both libraries
(faad, mad) are available. mp3-hifi is available for Pandora One customers
only.
- autoselect = {1,0}
- Auto-select last remaining item of filtered list. Currently
enabled for station selection only.
- autostart_station = stationid
- Play this station when starting up. You can get the
stationid by pressing i or the key you defined in
act_songinfo.
- ban_icon = </3
- Icon for banned songs.
- control_proxy = http://user:password@host:port/
- Non-american users need a proxy to use pandora.com. Only
the xmlrpc interface will use this proxy. The music is streamed directly.
- decrypt_password = R=U!LH$O2B#
-
- device = android-generic
-
- encrypt_password = 6#26FRL$ZWD
-
- event_command = path
- File that is executed when event occurs. See section
EVENTCMD
- fifo = /home/user/.config/pianobar/ctl
- Location of control fifo. Defaults to
$XDG_CONFIG_HOME/pianobar/ctl (which is usually the value above). See
section REMOTE CONTROL
- format_list_song = %i) %a - %t%r
- Available format characters:
- format_msg_none = %s
-
- format_msg_info = (i) %s
-
- format_msg_nowplaying = |> %s
-
- format_msg_time = # %s
-
- format_msg_err = /!\ %s
-
- format_msg_question = [?] %s
-
- format_msg_list = %s
- Message format strings. %s is replaced with the
actual message.
- format_nowplaying_song = "%t" by "%a" on "%l"%r%@%s
- Now playing song message format. Available format
characters are:
- format_nowplaying_station = Station "%n" (%i)
- Now playing station format. Available format characters
are:
- history = 5
- Keep a history of the last n songs (5, by default). You can
rate these songs.
- love_icon = <3
- Icon for loved songs.
- partner_password = AC7IBG09A3DTSYM4R41UJWL07VLN8JI7
-
- partner_user = android
-
- password = plaintext_password
- Your pandora.com password. Plain-text.
- proxy = http://user:password@host:port/
- Use a http proxy. Note that this setting overrides the
http_proxy environment variable. Only "Basic" http
authentication is supported.
- sort = {name_az, name_za, quickmix_01_name_az, quickmix_01_name_za, quickmix_10_name_az, quickmix_10_name_za}
- Sort station list by name or type (is quickmix) and name.
name_az for example sorts by name from a to z, quickmix_01_name_za by type
(quickmix at the bottom) and name from z to a.
- tls_fingerprint = D9980BA2CC0F97BB03822C6211EAEA4A06EEF427
- Hex-encoded SHA1 fingerprint of Pandora's TLS certificate.
- user = your@user.name
- Your pandora.com username.
- volume = 0
- Initial volume correction in dB. Usually between -30 and
+5.
REMOTE CONTROL¶
pianobar can be controlled through a fifo. You have to create it yourself by executingmkfifo ~/.config/pianobar/ctl
echo -n 'n' > ~/.config/pianobar/ctl
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