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.)
(6 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 21: Line 20:
 
* ''remote control and eventcmd interface (send tracks to last.fm, for example)
 
* ''remote control and eventcmd interface (send tracks to last.fm, for example)
 
* ''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.}}
  
 
==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}}.
  
==Troubleshooting==
+
==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}}
  
If you are experiencing sound/quality issues when running pianobar, and you are
+
{{hc|$ man pianobar|<nowiki>
currently using [[Advanced Linux Sound Architecture|ALSA]] as your sound driver, the following fix may be useful:
+
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.
  
* Install {{Pkg|alsa-oss}}. See the [[Advanced Linux Sound Architecture|ALSA]] page for more information.
+
      act_* keys control pianobar's key-bindings.  Every  one-byte  character
* Change the default libao driver from alsa to oss.
+
      except for \x00 and the special value disabled are allowed here.</nowiki>}}
{{hc|/etc/libao.conf|2=default_driver=oss}}
+
 
* Now to run pianobar:
+
Here is an example configuration file. See {{ic|man pandora}} for more configuration options.
$ aoss pianobar
+
{{hc|$ ~/.config/pianobar/config|<nowiki>
* Alternatively, you can use pulseaudio.
+
audio_quality = {high, medium, low}
{{hc|/etc/libao.conf|2=default_driver=pulse}}
+
autostart_station = stationid
Be sure to remove the dev=default option of the alsa driver or adjust it to specify a specific Pulse sink name or number.
+
 
 +
password = plaintext_password
 +
user = your@user.name</nowiki>}}
 +
 
 +
==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.
 +
{{Warning|The provided fixes may affect other applications that use audio as the default driver is being changed.}}
 +
# Install {{Pkg|alsa-oss}}. See the [[Advanced Linux Sound Architecture|ALSA]] page for more information.
 +
#* Change the default libao driver from alsa to oss.
 +
#*{{bc|<nowiki># /etc/libao.conf
 +
default_driver=oss</nowiki>}}
 +
#* Now run pianobar
 +
#** {{bc|$ aoss pianobar}}
 +
# Alternatively, you can use pulseaudio.
 +
#*{{bc|<nowiki># /etc/libao.conf
 +
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|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}}
+
==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 22:15, 6 October 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
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/pianobar/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