Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
This branch is 118 commits ahead, 86 commits behind PromyLOPh:master.

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



Build status


Older releases can be found at GitHub Release page.


  • 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


Port of pianobar - console based player







No packages published


  • C 73.8%
  • C++ 15.5%
  • Shell 4.3%
  • Roff 2.8%
  • Makefile 1.5%
  • Python 1.0%
  • Other 1.1%