Difference between revisions of "Pianobar"

From ArchWiki
Jump to: navigation, search
(Installation: Adding configuration section. Added sample configuration and man exceprt.)
(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.)
Line 21: Line 21:
 
* ''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}}.
Line 48: Line 48:
 
==Troubleshooting==
 
==Troubleshooting==
  
If you are experiencing sound/quality issues when running pianobar, and you are
+
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.
currently using [[Advanced Linux Sound Architecture|ALSA]] as your sound driver, the following fix 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.
* Install {{Pkg|alsa-oss}}. See the [[Advanced Linux Sound Architecture|ALSA]] page for more information.
+
#* Change the default libao driver from alsa to oss.
* Change the default libao driver from alsa to oss.
+
#*{{bc|<nowiki># /etc/libao.conf
{{hc|/etc/libao.conf|2=default_driver=oss}}
+
default_driver=oss</nowiki>}}
* Now to run pianobar:
+
#* Now run pianobar
$ aoss pianobar
+
#** {{bc|$ aoss pianobar}}
* Alternatively, you can use pulseaudio.
+
# Alternatively, you can use pulseaudio.
{{hc|/etc/libao.conf|2=default_driver=pulse}}
+
#*{{bc|<nowiki># /etc/libao.conf
Be sure to remove the dev=default option of the alsa driver or adjust it to specify a specific Pulse sink name or number.
+
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}}
+

Revision as of 02:26, 24 August 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.