Difference between revisions of "Pianobar"

From ArchWiki
Jump to: navigation, search
m (Troubleshooting)
(change category to Category:Music)
 
(23 intermediate revisions by 13 users not shown)
Line 1: Line 1:
[[Category:Audio/Video]]
+
[[Category:Music]]
[[es:Pianobar]]
+
[[ja:Pianobar]]
[[fr:Pianobar]]
+
{{Related articles start}}
[[ro:Pianobar]]
+
{{Related|List of Applications/Multimedia}}
[[sr:Pianobar]]
+
{{Related articles end}}
Pianobar is a free/open-source, console-based client for the personalized online radio [http://www.pandora.com/ Pandora].
 
  
http://6xq.net/projects/pianobar/
+
[http://6xq.net/projects/pianobar/ Pianobar] is a free/open-source, console-based client for the personalized online radio [http://www.pandora.com/ Pandora] (only available in the USA).
 +
 
 +
'''''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==
 
==Installation==
  
Sync and install with pacman:
+
[[Install]] the {{pkg|pianobar}} package.
  # pacman -S 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 {{man|1|pianobar}} for more configuration options.
 +
{{hc|$ ~/.config/pianobar/config|<nowiki>
 +
audio_quality = {high, medium, low}
 +
autostart_station = stationid
 +
 
 +
password = plaintext_password
 +
user = your@user.name</nowiki>}}
  
 
==Troubleshooting==
 
==Troubleshooting==
 +
=== Sound Quality Issues ===
 +
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.}}
 +
# Install {{Pkg|alsa-oss}}. See the [[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>}}
  
If you are experiencing sound/quality issues when running pianobar, and you are
+
=== Network Error ===
currently using [[Advanced Linux Sound Architecture|ALSA]] as your sound driver, the following fix may be useful:
+
If you are receiving the "Network error: Peer certificate cannot be authenticated with given CA certificates", try adding the following line to your .config/pianobar/config file:
 
+
{{bc|<nowiki>ca_bundle = /etc/ca-certificates/extracted/tls-ca-bundle.pem</nowiki>}}
* Install {{Pkg|alsa-oss}}. See the [[Advanced Linux Sound Architecture|ALSA]] page for more information.
 
* Change the default libao driver from alsa to oss.
 
{{hc|/etc/libao.conf|2=default_driver=oss}}
 
* Now to run pianobar:
 
$ aoss pianobar
 
  
{{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]
 +
* https://wiki.k2patel.in/pianobar

Latest revision as of 07:18, 18 June 2018

Pianobar is a free/open-source, console-based client for the personalized online radio Pandora (only available in the USA).

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

Install the pianobar package.

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 pianobar(1) for more configuration options.

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

password = plaintext_password
user = your@user.name

Troubleshooting

Sound Quality Issues

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.

Network Error

If you are receiving the "Network error: Peer certificate cannot be authenticated with given CA certificates", try adding the following line to your .config/pianobar/config file:

ca_bundle = /etc/ca-certificates/extracted/tls-ca-bundle.pem

See also