summaryrefslogtreecommitdiff
path: root/src/pianobar.1
blob: bcd5f219660a1e2729035a5173059e8bcab22410 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
.TH pianobar 1

.SH NAME
pianobar \- console pandora.com music player

.SH SYNOPSIS
.B pianobar

.SH DESCRIPTION
.B pianobar
is a lightweight console music player for the personalized online radio
pandora.com.

.SH USAGE
Press one of these keys while running
.B pianobar.

.TP
.B a
Add more music to current station. You will be asked for a search string. Just
follow the instructions.

.TP
.B b
Ban current track. It will not be played again and can only removed using the
pandora.com web interface.

.TP
.B c
Create new station. You have to enter a search string and select the song or
artist of your choice.

.TP
.B d
Delete current station.

.TP
.B l
Love currently played song.

.TP
.B n
Skip current song.

.TP
.B p
Pause/Continue

.TP
.B q
Quit
.B pianobar.

.TP
.B r
Rename currently played station.

.TP
.B s
Play another station.

.TP
.B t
Ban song for one month.

.TP
.B u
Show next songs in playlist.

.SH FILES
.I $XDG_CONFIG_HOME/pianobar/config
or
.I ~/.config/pianobar/config
.RS
Per-user configuration file. See
.B CONFIGURATION.

.SH CONFIGURATION
The configuration file consists of simple
.B key = value
lines. Each terminated with a newline (\\n) character. Keys and values are both
case sensitive.

.TP
.B control_proxy = host:port
Non-american users need a proxy to use pandora.com. Only the xmlrpc
interface will use this proxy. The music is streamed directly.

.TP
.B control_proxy_type = {http,socks4,socks4a,socks5}
If you want to use a proxy you need to specify the proxy type you're going to
use. Note that
.B socks5
needs an IP address specified in
.B control_proxy

.TP
.B lastfm_user = your_username
If you want to send your played song to last.fm set this to your last.fm
username.

.TP
.B lastfm_password = plain_password
A password is needed too if you want to scrobble your played song.

.TP
.B lastfm_scrobble_percent = 50-100
When should a track be submitted to last.fm. Percent value. Don't append
percent sign.

.TP
.B password = plaintext_password
Your pandora.com password. Plain-text.

.TP
.B user = your@user.name
Your pandora.com username.

.SH AUTHOR
Lars-Dominik Braun <PromyLOPh@gmail.com>