Skip to content
Go to file
This branch is 103 commits ahead, 69 commits behind PromyLOPh:master.


Failed to load latest commit information.
Latest commit message
Commit time

pianobar is a console client for the personalized web radio Pandora ported to Windows.



Releases can be found at GitHub Release page.

Build status


  • Play and manage (create, add more music, delete, rename, ...) your stations.
  • Rate played songs and let pandora explain why they have been selected.
  • Show upcoming songs/song history.
  • Configure keybindings.
  • scrobbling support (external application)
  • Proxy support for listeners outside the USA.

Source Code

Original source code can be downloaded at or


Checkout pianobar-windows-build where you will find configured solution for Visual Studio 2015.

This repository is linked by GitHub submodule.


Please examine pianobar.cfg.example for more details or ask in issue if you find something missing.

Available actions

  • act_help - show act_help
  • act_songlove - love song
  • act_songban - ban song
  • act_stationaddmusic - add music to station
  • act_stationcreate - create new station
  • act_stationdelete - delete station
  • act_songexplain - explain why this song is played
  • act_stationaddbygenre - add genre station
  • act_history - song history
  • act_songinfo - print information about song/station
  • act_addshared - add shared station
  • act_songnext - next song
  • act_songpausetoggle - pause/resume playback
  • act_songpausetoggle2 - same as above, but allow second bind
  • act_quit - quit
  • act_stationrename - rename station
  • act_stationchange - change station
  • act_songtired - tired (ban song for 1 month)
  • act_upcoming - upcoming songs
  • act_stationselectquickmix - select quickmix stations
  • act_bookmark - bookmark song/artist
  • act_voldown - decrease volume
  • act_volup - increase volume
  • act_managestation - delete seeds/feedback
  • act_songplay - resume playback
  • act_songpause - pause playback
  • act_volreset - reset volume
  • act_settings - change settings


You can now bind hotkey to an action, for example:

    hk_act_songlove = c + shift + ctrl
    hk_act_songlove = f9

Hotkey use format: hk_<action_name> = <key> + [modifier1] + [modifier2]...

can be any printable character on your keyboard or one of the named keys:

    numpad0, numpad1, numpad2, numpad3, numpad4, numpad5, numpad6, numpad7,
    numpad8, numpad9, multiply, add, separator, subtract, decimal, divide,
    f1, f2, f3, f4, f5, f6, f7, f8, f9, f10, f11, f12, f13, f14, f15, f16,
    f17, f18, f19, f20, f21, f22, f23, f24, browser_back, browser_forward,
    browser_refresh, browser_stop, browser_search, browser_favorites,
    browser_home, volume_mute, volume_down, volume_up, media_next_track,
    media_prev_track, media_stop, media_play_pause, launch_mail,
    launch_media_select, launch_app1, launch_app2

Example bindings:

#hk_act_songpausetoggle = media_play_pause
#hk_act_songnext = media_next_track
You can’t perform that action at this time.