Difference between revisions of "Pianobar"

From ArchWiki
Jump to: navigation, search
(Added features from the author's site for a more robust and descriptive introduction. Added article summary code. Removed explicit command for installing pianobar via pacman. Added pkg link and official repository link as per sytle guide.)
(Installation: Adding configuration section. Added sample configuration and man exceprt.)
Line 24: Line 24:
 
==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}}.
 +
 +
==Configuration==
 +
First, you need to create a configuration file for Pianobar. This should be located at {{ic|$XDG_CONFIG_HOME/pianobar/config}} or {{ic|~/.config/pianobar/config}}
 +
 +
{{hc|$ man pianobar|<nowiki>
 +
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.</nowiki>}}
 +
 +
Here is an example configuration file. See {{ic|man pandora}} for more configuration options.
 +
{{hc|$ ~/.config/pandora/config|<nowiki>
 +
audio_quality = {high, medium, low}
 +
autostart_station = stationid
 +
 +
password = plaintext_password
 +
user = your@user.name</nowiki>}}
  
 
==Troubleshooting==
 
==Troubleshooting==

Revision as of 02:13, 24 August 2013

Summary help replacing me
This article outlines the installation and some basic troubleshooting for the Pandora client, Pianobar.
Required software
Pianobar
Related
List_of_Applications/Multimedia

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

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 fix may be useful:

  • 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 to run pianobar:
$ aoss pianobar
  • Alternatively, you can use pulseaudio.
/etc/libao.conf
default_driver=pulse

Be sure to remove the dev=default option of the alsa driver or adjust it to specify a specific Pulse sink name or number.

Note: The provided fix may affect other applications that use audio since the default driver is being changed. Switch back to the normal configuration at anytime by editing /etc/libao.conf