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.