Difference between revisions of "Pianobar"
m (→Troubleshooting) |
Kynikos.bot (talk | contribs) (update link(s) (avoid redirect)) |
||
(11 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
[[Category:Audio/Video]] | [[Category:Audio/Video]] | ||
− | + | {{Related articles start}} | |
− | + | {{Related|List of Applications/Multimedia}} | |
− | + | {{Related articles end}} | |
− | |||
− | |||
− | 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]. |
+ | |||
+ | '''''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== | ||
+ | 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/pianobar/config|<nowiki> | ||
+ | audio_quality = {high, medium, low} | ||
+ | autostart_station = stationid | ||
− | + | password = plaintext_password | |
− | + | user = your@user.name</nowiki>}} | |
− | + | ==Troubleshooting== | |
− | * Change the default libao driver from alsa to oss. | + | 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.}} |
− | * Now | + | # 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>}} | ||
− | + | ==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 12:04, 24 February 2014
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.
- 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
-
- 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.