Difference between revisions of "Pianobar"

From ArchWiki
Jump to: navigation, search
(Changed a note into a warning and made some other content into a note to better fit the style guide and the content. Made the fact that two potential fixes are listed more clear. Cleaned up wording and formatting.)
(Troubleshooting)
(3 intermediate revisions by 2 users not shown)
Line 11: Line 11:
 
{{Article summary wiki|List_of_Applications/Multimedia}}
 
{{Article summary wiki|List_of_Applications/Multimedia}}
 
{{Article summary end}}
 
{{Article summary end}}
 
 
Pianobar is a free/open-source, console-based client for the personalized online radio [http://www.pandora.com/ Pandora].
 
Pianobar is a free/open-source, console-based client for the personalized online radio [http://www.pandora.com/ Pandora].
  
Line 22: Line 21:
 
* ''proxy support for listeners outside the USA''
 
* ''proxy support for listeners outside the USA''
 
{{Tip|Since Pianobar is a command line interface based program it can be placed in a different vterm than your desktop and be left to run.}}
 
{{Tip|Since Pianobar is a command line interface based program it can be placed in a different vterm than your desktop and be left to run.}}
 +
 
==Installation==
 
==Installation==
 
Pianobar can be installed from the [[Official Repositories]] with the package {{pkg|pianobar}}.
 
Pianobar can be installed from the [[Official Repositories]] with the package {{pkg|pianobar}}.
Line 47: Line 47:
  
 
==Troubleshooting==
 
==Troubleshooting==
 
 
If you are experiencing sound/quality issues when running pianobar, and you are currently using [[Advanced Linux Sound Architecture|ALSA]] as your sound driver, the following fixes may be useful.
 
If you are experiencing sound/quality issues when running pianobar, and you are currently using [[Advanced Linux Sound Architecture|ALSA]] as your sound driver, the following fixes may be useful.
 
{{Warning|The provided fixes may affect other applications that use audio as the default driver is being changed.}}
 
{{Warning|The provided fixes may affect other applications that use audio as the default driver is being changed.}}
Line 60: Line 59:
 
default_driver=pulse</nowiki>}}
 
default_driver=pulse</nowiki>}}
 
{{Note|<nowiki>Be sure to remove the dev=default option of the alsa driver or adjust it to specify a specific Pulse sink name or number.</nowiki>}}
 
{{Note|<nowiki>Be sure to remove the dev=default option of the alsa driver or adjust it to specify a specific Pulse sink name or number.</nowiki>}}
 +
 +
==See also==
 +
* [http://6xq.net/projects/pianobar/ Project's homepage]
 +
* [https://github.com/PromyLOPh/pianobar/ Project's GitHub]
 +
* http://ketan.lithiumfox.com/doku.php/pianobar

Revision as of 02:37, 6 September 2013

Template:Article summary start Template:Article summary text Template:Article summary heading Template:Article summary link Template:Article summary heading Template:Article summary wiki Template:Article summary end Pianobar is a free/open-source, console-based client for the personalized online radio Pandora.

Features

  • play and manage (create, add more music, delete, rename, ...) stations
  • rate songs and explain why they have been selected
  • upcoming songs/song history
  • customize keybindings and text output
  • remote control and eventcmd interface (send tracks to last.fm, for example)
  • proxy support for listeners outside the USA
Tip: Since Pianobar is a command line interface based program it can be placed in a different vterm than your desktop and be left to run.

Installation

Pianobar can be installed from the Official Repositories with the package pianobar.

Configuration

First, you need to create a configuration file for Pianobar. This should be located at $XDG_CONFIG_HOME/pianobar/config or ~/.config/pianobar/config

$ man pianobar
CONFIGURATION
       The  configuration file consists of simple key = value lines, each ter‐
       minated 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_* keys control pianobar's key-bindings.  Every  one-byte  character
       except for \x00 and the special value disabled are allowed here.

Here is an example configuration file. See man pandora for more configuration options.

$ ~/.config/pandora/config
audio_quality = {high, medium, low}
autostart_station = stationid

password = plaintext_password
user = your@user.name

Troubleshooting

If you are experiencing sound/quality issues when running pianobar, and you are currently using ALSA as your sound driver, the following fixes may be useful.

Warning: The provided fixes may affect other applications that use audio as the default driver is being changed.
  1. Install alsa-oss. See the ALSA page for more information.
    • Change the default libao driver from alsa to oss.
    • # /etc/libao.conf
      default_driver=oss
    • Now run pianobar
      • $ aoss pianobar
  2. Alternatively, you can use pulseaudio.
    • # /etc/libao.conf
      default_driver=pulse
Note: Be sure to remove the dev=default option of the alsa driver or adjust it to specify a specific Pulse sink name or number.

See also