Difference between revisions of "Package:Pianobar"

From Funtoo
Jump to navigation Jump to search
(Updated tables to type that are used in the Install guide. Added information about keyboard shortcuts.)
(Added fix for problem with pulseaudio and libao.conf. Removed old <code> and <terminal> tags and added a blockquote at the top of the page.)
Line 2: Line 2:
|Summary=Pianobar is a console client for the personalized web radio Pandora.
|Summary=Pianobar is a console client for the personalized web radio Pandora.
|CatPkg=media-sound/pianobar
|CatPkg=media-sound/pianobar
|Maintainer=
|Homepage=https://github.com/PromyLOPh/pianobar
|Homepage=https://github.com/PromyLOPh/pianobar
}}
}}
<blockquote>
Pianobar is a console client for the personalized web radio Pandora.
Pianobar is a console client for the personalized web radio Pandora.
It features the following abilities:
It features the following abilities:
Line 13: Line 13:
* Configure keybindings
* Configure keybindings
* Last.fm scrobbling support (with the help of an external application)
* Last.fm scrobbling support (with the help of an external application)
* Proxy support for listeners outside of the USA
* Proxy support for listeners outside of the USA [[https://github.com/PromyLOPh/pianobar Homepage]]
([https://github.com/PromyLOPh/pianobar Homepage])
</blockquote>
 


== Install ==
== Install ==
To install Pianobar, emerge it:
To install Pianobar, emerge it:
<console>
{{console|body=
###i## emerge pianobar
###i## emerge pianobar
</console>
}}


== Keyboard shortcuts ==
== Keyboard shortcuts ==
Line 50: Line 51:
{{TableEnd}}
{{TableEnd}}


{{note|All of Pianobar's shortcuts can be found by typing <code>?</code> when running pianobar.}}
{{note|All of Pianobar's shortcuts can be listed by typing {{c|?}} when running pianobar.}}


== Pianobar configuration ==
== Pianobar configuration ==
Line 68: Line 69:


=== Keybindings ===
=== Keybindings ===
To configure keybindings, check out <code>man pianobar</code>. All keybindings can be added to <code>~/.config/pianobar/config</code>. All the keybindings in the man page will begin with the line <code>act_</code>.
To configure keybindings, check out {{c|man pianobar}}. All keybindings can be added to {{c|~/.config/pianobar/config}}. All the keybindings in the man page will begin with the line {{c|act_}}.


=== Other configuration options ===
=== Other configuration options ===
Line 89: Line 90:


== Troubleshooting ==
== Troubleshooting ==
=== {{c|ao_alsa WARNING}} message ===
The {{c|ao_alsa WARNING: Unable to open surround playback. Trying default device}} message is often associated with the use of Pulseaudio. To resolve this warning message, edit {{c|/etc/libao.conf}} (you may have to create the file if it does not exist on your system):
{{file|name=/etc/libao.conf|desc=|body=
default_driver=pulse
}}
After a restart of Pianobar, the warning messages should not be displayed anymore.
=== Not compiled with threads support ===
=== Not compiled with threads support ===
If you recieve the following warning message (<code>[aac @ 0x7faccc003cd0] Warning: not compiled with thread support, using thread emulation</code>) while running Pianobar, add threads support to ffmpeg, then rebuild it:
If you recieve the following warning message ({{c|[aac @ 0x7faccc003cd0] Warning: not compiled with thread support, using thread emulation}}) while running Pianobar, add threads support to {{c|ffmpeg}}, then rebuild it:
<console>
{{console|body=
###i## echo "media-video/ffmpeg threads" > /etc/portage/package.use/ffmpeg
###i## echo "media-video/ffmpeg threads" > /etc/portage/package.use/ffmpeg
###i## emerge ffmpeg
###i## emerge ffmpeg
</console>
}}
{{note|As of [https://bugs.funtoo.org/browse/FL-1437 FL-1437], threads support should be enabled on ffmpeg by default.}}
{{note|As of [https://bugs.funtoo.org/browse/FL-1437 FL-1437], threads support should be enabled on ffmpeg by default.}}
{{EbuildFooter}}
{{EbuildFooter}}

Revision as of 22:10, June 21, 2015

Pianobar

   Tip

We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.

Pianobar is a console client for the personalized web radio Pandora. It features the following abilities:

  • Play and manage (create, add more music, delete, rename, etc.) your stations
  • Rate played songs and let Pandora explain why they have been selected
  • Show upcoming songs and song history
  • Configure keybindings
  • Last.fm scrobbling support (with the help of an external application)
  • Proxy support for listeners outside of the USA [Homepage]


Install

To install Pianobar, emerge it:

root # emerge pianobar

Keyboard shortcuts

Pianobar has many shortcuts that allow you to increase or decrease the volume, change station, favorite a song, and many others. The table below includes some of the more commonly used shortcuts.

Shortcut Description
+ Love the song you are currently listening to. This is equivalent to the "thumbs up" button on Pandora.'
- Give a "thumbs down" to the current song.
p Pause or resume the music.
s Change the station.
) Increase the volume of pianobar.
( Decrease the volume of pianobar.
   Note

All of Pianobar's shortcuts can be listed by typing ? when running pianobar.

Pianobar configuration

Easy login

After you have emerged Pianobar, you can run it with pianobar. If you dislike typing your username and password every time that you run pianobar, create the file ~/.config/pianobar/config and add the following lines to it:

   ~/.config/pianobar/config
password = YOURPASSWORD
user = user@email.com

Easy login (with encryption)

If leaving a plaintext password for your Pandora account somewhere on your filesystem makes you nervous, you can use gpg to decrypt a file that contains your password. Change your configuration to reflect the one below if you would like to encrypt your password:

   ~/.config/pianobar/config
password_command = gpg --decrypt ~/.passwords/pianobar
user = user@email.com

Keybindings

To configure keybindings, check out man pianobar. All keybindings can be added to ~/.config/pianobar/config. All the keybindings in the man page will begin with the line act_.

Other configuration options

Option Description
audio_quality The quality of the audio. Can be set to: high, medium, or low.
autostart_station Select a station ID that you would like to play when Pianobar starts.
proxy Use an http proxy to connect to Pandora.

Troubleshooting

ao_alsa WARNING message

The ao_alsa WARNING: Unable to open surround playback. Trying default device message is often associated with the use of Pulseaudio. To resolve this warning message, edit /etc/libao.conf (you may have to create the file if it does not exist on your system):

   /etc/libao.conf
default_driver=pulse

After a restart of Pianobar, the warning messages should not be displayed anymore.

Not compiled with threads support

If you recieve the following warning message ([aac @ 0x7faccc003cd0] Warning: not compiled with thread support, using thread emulation) while running Pianobar, add threads support to ffmpeg, then rebuild it:

root # echo "media-video/ffmpeg threads" > /etc/portage/package.use/ffmpeg
root # emerge ffmpeg
   Note

As of FL-1437, threads support should be enabled on ffmpeg by default.