This repository has been archived by the owner on Feb 9, 2021. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 12
/
Copy path00-man
190 lines (190 loc) · 5.64 KB
/
00-man
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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
.\"
.\" Copyright (c) 2006-2011 Ed Schouten <ed@80386.nl>
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.TH HERRIE 1 "January 1, 2008" "Ed Schouten"
.SH NAME
herrie \- interactive music playlist player
.SH SYNOPSIS
.B herrie
.RB [ -pvx ]
.RB [ -c
.IR configfile ]
.RI [ file
.IR ... ]
.SH DESCRIPTION
.B herrie
is a command line music player. It supports multiple audio file formats
(including MP3 and Ogg Vorbis) and has the ability to send playback
statistics to AudioScrobbler. The word `herrie' is Dutch for `clamour'.
.PP
.B herrie
uses a split-screen user interface: a playlist at the top and a
filebrowser at the bottom. The application has two modes of operation,
called `party mode' and `XMMS mode'. When the application is started in
party mode, the first song in the playlist gets started. It will also be
removed from the playlist as well. When the application is started in
XMMS mode, any song can be started and will not be removed from the
playlist. The default mode is party mode.
.PP
The following command line options are available:
.TP
.BI "-c " "configfile"
By default,
.B herrie
searches in
.I ~/.herrie/config
or in the system wide global configuration file
.I %%CONFFILE%%
for options. The
.B -c
options allows you to load additional configuration files.
.TP
.B -p
Automatically start playback on startup.
.TP
.B -v
Display version information and a list of supported file formats.
.TP
.B -x
This switch causes
.B herrie
to start up in XMMS mode.
.PP
Files that are passed on the command line will be appended to the
playlist.
.SH KEYBOARD BINDINGS
Both the file browser and the playlist share some common keyboard
bindings:
.TP
.B j or down arrow
Move the selection one entry down.
.TP
.B k or up arrow
Move the selection one entry up.
.TP
.B ^F, page down or spacebar
Move the selection one page down.
.TP
.B ^B or page up
Move the selection one page up.
.TP
.B f
Show the full pathname of the selected song.
.TP
.B F
Jump to the selected file in the file browser.
.TP
.B g or home
Move the selection to the top.
.TP
.B G or end
Move the selection to the bottom.
.TP
.B /
Search the entries for a specified regular expression and select the
first matching entry below the current selection. If no match is found,
the search will continue at the top of the list. As a final attempt, the
other window is searched as well.
.TP
.B ?
Search the entries for a specified regular expression and select the
first matching entry above the current selection. If no match is found,
the search will continue at the bottom of the list. As a final attempt, the
other window is searched as well.
.TP
.B n
Perform another search for the last entered search string.
.TP
.B N
Perform another search for the last entered search string in the
opposite direction.
.PP
There are also some bindings that only apply to the playlist:
.TP
.B d
Remove the currently selected song from the playlist.
.TP
.B D
Remove all songs from the playlist.
.TP
.B R
Randomize the playlist.
.TP
.B x
When in XMMS mode, it starts the selected song. In party mode, this key
will always start playback of the first song in the list.
.TP
.B [
Move the currently selected song upward.
.TP
.B ]
Move the currently selected song downward.
.TP
.B {
Move the currently selected song to the top of the playlist.
.TP
.B }
Move the currently selected song to the bottom of the playlist.
.TP
.B ~
Navigate back to the directory specified in
.B gui.browser.defaultpath .
.PP
The file browser also has some bindings that allow you to traverse the
file system or add files, directories or playlists (M3U and PLS) to the
playlist:
.TP
.B a
Add items after the current selected item in the playlist.
.TP
.B A
Add items at the end of the playlist.
.TP
.B i
Add items before the current selected item in the playlist.
.TP
.B I
Add items at the beginning of the playlist.
.TP
.B h or left arrow
Go one directory up.
.TP
.B l or right arrow
Enter the selected directory.
.TP
.B L
Locate all files in the current and underlying directories matching a
search string. When finished, all matching files will be showed in a
list. To remove an existing filter, go one directory up.
.TP
.B C
Change the current directory by entering a pathname. This pathname may
be relative to the current directory. When the address refers to a file
or web location, it will be displayed as well.
.TP
.B x
Replace the contents of the playlist with the current selection.
.PP
And last but not least, there are also some general keyboard bindings: