Difference between revisions of "Package:Pianobar"

From Funtoo
Jump to: navigation, search
(Updated tables to type that are used in the Install guide. Added information about keyboard shortcuts.)
Line 5: Line 5:
 
|Homepage=https://github.com/PromyLOPh/pianobar
 
|Homepage=https://github.com/PromyLOPh/pianobar
 
}}
 
}}
 
 
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 25: Line 24:
 
== Keyboard shortcuts ==
 
== 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.
 
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.
{| {{table}}
+
{{TableStart}}
!Shortcut
+
<tr class="active">
!Purpose
+
<th>Shortcut</th>
|-
+
<th>Description</th>
|"+"
+
</tr><tr>
|Love the song you are currently listening to. This is equivalent to the "thumbs up" button on Pandora.
+
<td>+</td>
|-
+
<td>Love the song you are currently listening to. This is equivalent to the "thumbs up" button on Pandora.'</td>
|"-"
+
</tr><tr>
|Give a "thumbs down" to the current song.
+
<td>-</td>
|-
+
<td>Give a "thumbs down" to the current song.</td>
|"p"
+
</tr><tr>
|Pause or resume the music.
+
<td>p</td>
|-
+
<td>Pause or resume the music.</td>
|"s"
+
</tr><tr>
|Change the station.
+
<td>s</td>
|-
+
<td>Change the station.</td>
|")"
+
</tr><tr>
|Increase the volume of pianobar.
+
<td>)</td>
|-
+
<td>Increase the volume of pianobar.</td>
|"("
+
</tr><tr>
|Decrease the volume of pianobar.
+
<td>(</td>
|}
+
<td>Decrease the volume of pianobar.</td>
 +
</tr><tr>
 +
</tr>
 +
{{TableEnd}}
 +
 
 +
{{note|All of Pianobar's shortcuts can be found by typing <code>?</code> when running pianobar.}}
  
 
== Pianobar configuration ==
 
== Pianobar configuration ==
Line 67: Line 71:
  
 
=== Other configuration options ===
 
=== Other configuration options ===
{| {{table}}
+
{{TableStart}}
!Option
+
<tr class="active">
!Description
+
<th>Option</th>
|-
+
<th>Description</th>
|audio_quality
+
</tr><tr>
|The quality of the audio. Can be set to: high, medium, or low.
+
<td>audio_quality</td>
|-
+
<td>The quality of the audio. Can be set to: high, medium, or low.</td>
|autostart_station
+
</tr><tr>
|Select a station ID that you would like to play when Pianobar starts.
+
<td>autostart_station</td>
|-
+
<td>Select a station ID that you would like to play when Pianobar starts.</td>
|proxy
+
</tr><tr>
|Use a http proxy.
+
<td>proxy</td>
|}
+
<td>Use an http proxy to connect to Pandora.</td>
 +
</tr><tr>
 +
</tr>
 +
{{TableEnd}}
  
 
== Troubleshooting ==
 
== Troubleshooting ==
Line 88: Line 95:
 
###i## emerge ffmpeg
 
###i## emerge ffmpeg
 
</console>
 
</console>
{{fancynote| 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 00:32, October 15, 2014

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 found 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

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.