android

pianobar(1)						      General Commands Manual						       pianobar(1)

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 (
) 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_* keys control pianobar's key-bindings. Every one-byte character except for x00 and the special value disabled are allowed here.

       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:

	      %i Song number

	      %a Song artist

	      %t Song title

	      %r Rating icon

       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:

	      %t Song title

	      %a Song artist

	      %l Album name

	      %r Rating icon (only love icon)

	      %@ at_icon if station is quickmix, empty otherwise.

	      %s Real station name if quickmix

	      %u Song detail url

       format_nowplaying_station = Station "%n" (%i)
	      Now playing station format. Available format characters are:

	      %n Station name

	      %i Station id

       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  sup-
	      ported.

       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 executing

	mkfifo ~/.config/pianobar/ctl

       Adjust the path if you set up a $XDG_CONFIG_HOME or changed the fifo setting.  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 behav-
       iour 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 'nx1a' | 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 like error code and description, was well as song information related to the current event, is sup-
       plied through stdin.

       Currently supported events are: artistbookmark, songban, songbookmark, songexplain, songfinish, songlove, songmove,  songshelf,	songstart,
       stationaddmusic,  stationaddshared,  stationcreate,  stationdelete,  stationdeleteartistseed, stationdeletefeedback, stationdeletesongseed,
       stationfetchinfo, stationfetchplaylist, stationquickmixtoggle, stationrename, userlogin, usergetstations

       An example script can be found in the contrib/ directory of pianobar's source distribution.

AUTHOR

       Lars-Dominik Braun <lars@6xq.net>

																       pianobar(1)