NAME
pianobar - console pandora.com music player
SYNOPSIS
pianobar
DESCRIPTION
pianobar is a lightweight console music player for the personalized
online radio pandora.com.
FILES
$XDG_CONFIG_HOME/pianobar/config or ~/.config/pianobar/config
Per-user configuration file. See CONFIGURATION.
/etc/libao.conf or ~/.libao
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. Keys and values are both case
sensitive. act_*-keys control pianobar's key-bindings.
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_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.
act_songtired = t
Ban song for one month.
act_upcoming = u
Show next songs in playlist.
act_stationselectquickmix = x
Select quickmix stations.
audio_format = {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.
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.
control_proxy = http://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.
event_command = path
File that is executed when event occurs. See section EVENTCMD
history = 5
Keep a history of the last n songs (5, by default). You can rate
these songs.
password = plaintext_password
Your pandora.com password. Plain-text.
user = your@user.name
Your pandora.com username.
REMOTE CONTROL
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
n is the keybinding for "next song". If you customized your keybindings
you have to use these characters to control pianobar. This behaviour
may change in the future!
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
EVENTCMD
pianobar can report certain "events" to an external application (see
CONFIGURATION ). This application is started with the event name as
it's first argument. More information (artist, title, album,
stationName, error code, error description, song length in
milliseconds, rating) is supplied through stdin.
Currently supported events are: artistbookmark, songban, songbookmark,
songexplain, songfinish, songlove, songmove, songshelf, songstart,
stationaddmusic, stationaddshared, stationcreate, stationdelete,
stationfetchplaylist, stationquickmixtoggle, stationrename
An example script can be found in the contrib/ directory of pianobar's
source distribution.
AUTHOR
Lars-Dominik Braun <PromyLOPh@lavabit.com>
pianobar(1)