File: mp3blaster.1

package info (click to toggle)
mp3blaster 2-0b16-1.1
  • links: PTS
  • area: main
  • in suites: potato
  • size: 1,012 kB
  • ctags: 1,241
  • sloc: cpp: 12,228; ansic: 1,557; sh: 362; makefile: 107
file content (167 lines) | stat: -rw-r--r-- 7,542 bytes parent folder | download
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
.TH mp3blaster 1
.SH NAME
mp3blaster - An interactive text-console based mp3 player.
.SH SYNOPSIS
.TP
\fBmp3blaster\fR [\fBoptions\fR]
.TP
\fBmp3blaster\fR [\fBoptions\fR] \fR [\fBfile ...\fR]
Play one or more mp3's from the command-line
.TP
\fBmp3blaster\fR [\fBoptions\fR] \fB--list\fI|\fB-l playlist.lst
Load a playlist at startup but don't start playing.
.TP
\fB mp3blaster\fR [\fBoptions\fR] \fB--autolist\fI|\fB-a playlist.lst
Load a playlist at startup and start playing.
.SH DESCRIPTION
.I Mp3blaster 
is an interactive text-based program that plays audio files (currently
only mpeg audio streams, commonly known as MP3's). The major difference
with all other text-based mp3 players is that this one has a fully
interactive interface. Another major feature is the very flexible way in
which you can design a playlist.
.PP
Its interface is based on ncurses, a popular text-screen handler, and
consists of three main parts: A playlist editor, a file manager and a
playing mode. By default, you start with the playlist editor (note that
most common mp3 players start with the playing mode section instead). 

.SH Playlist Editor

The playlist consists of one or more \fBgroups\fR. Each group can have
its own \fBgroupname\fR and can contain supported audio files. You can
set the play order for each group to \fBrandom\fR or \fBnormal\fR. Random
means that all files in that group will be played in random (shuffled) 
order, normal will play the files in the order you added them.
.PP
There is also a global play order that can be \fBcurrent (one) group\fR, 
\fBall groups in normal order\fR, \fBall groups in normal order\fR or 
\fBall songs in random order\fR. Only the ``all songs random'' order
ignores the group's individual play order setting; all other global play
orders will take it into account. 
.PP
By default, an empty playlist with one empty group is created at startup,
to which you can start adding files. To find out what keys you can use,
press \fB?\fR. 

.SH File Manager

You can enter the file manager by pressing F1 or 1 from the \fBplaylist
editor\fR. The interface is almost identical to that of the playlist
editor except for the function keys, which might be confusing at first.
In the file manager, you can add files to the group you had currently
selected in the \fBplaylist editor\fR. You can also listen to a file by
selecting it with the highlighted bar and pressing enter over it.
Adding files can be done in 2 ways: Selecting a file by moving the bar over it
and pressing the spacebar, or by recursively selecting all files in the
current directory and all directories in it. If you select some files,
change to another directory (by pressing enter over one) and then select
some more files, the old selection will not be lost, even though you can't
see it on your screen at the time. As soon as you return to the playlist
editor by using F1 or 1, you will see they have been added to the group.
However, you can't deselect selected files as soon as you change into 
another directory: you'll have to remove them from the playlist editor.
Also, the order in which you select files will be the order in which they
are added to the group. A quick way of selecting *all* files in the current
directory is by selection none and then press F2 or 2 (invert selection).
.br
The recursive selection can be done in two ways: By F3 or 3, you add all
mp3's that are found in the current directory and all directories in it,
to the current group. By using F5 or 5, you do the same thing. However,
for each subdir in which mp3 files are found, a new group is added with the
name of the subdir and the mp3's in it will be added to this group. This is
an ultimately fast way of making a playlist grouped by albums! 
An overview of other less frequently used keys:
.TP 5
.B F4
Directly enter a pathname to change to.
.TP 5
.B F6
Convert the currently selected mp3 to a wave(.wav) file.
.TP 5
.B F7
Add a HTTP stream to the playlist.
.TP 5
.B Backspace or h
Change up one directory (..)
.TP 5
.B /
Starts searchmode which times out when no keys have been pressed for 2
seconds. During searchmode, the selection bar jumps to the first matching
name that matches with the input that's being typed. When there's no match,
a bell (or flash) is sounded. Besides changing into a new dir or playing
a soundfile, \fBenter\fR also stops the search.
.TP 5
.B j,k
VI-style keys. j, k act like the down and up arrow keys.

.TP 0
.B Playing Mode

This is a conventional cd-player style window where you can control the
playlist being played, as well as the mixer, that is if you didn't disable
it from the command-line.
All cd-style controls (previous track, rewind, play, fast forward, next track,
pause and stop) are available under the numerical keys 1 to 7. Their functions
should be obvious and don't differ from your average cd/tape player.
The mixer can be controlled using the arrow (or vi-style) keys.
Left/Right changes the highlighted device; up/down selects another
mixer device. You can control any mixer device that has been detected
by your sound driver, which may vary on different systems.  The path
to the mp3-file that's currently being played is in the upper border
of the screen. Directly below you see some information about the
soundfile being played. For mp3 files with an ID3-tag extra
information like the songname, artist, etc. will be shown as well. If
an mp3 does not have an id3tag (or no songname in it), the songname
will be the filename.  There is also a progress bar onscreen that
shows how long a file is being played and when it's finished playing.
There's also a time indicator next to the scrollbar, which displays
elapsed time, total time and remaining time.  You can leave the
playlist editor by pressing 'q'.

.SH OPTIONS
.TP
.B --chroot=rootdir, -c=rootdir
Set <rootdir> as mp3blaster's root dir. This affects 
.B ALL
file operations in mp3blaster!! (including reading and writing of playlists).
Note that only users with uid 0 (i.e. root) can use this option (yet). This
feeature will be changed radically soon.
.TP
.B --debug, -d
Log debug-info in $HOME/.mp3blaster (only useful for debuggers)
.TP
.B --no-mixer, -n
Don't start the built-in mixer.
.TP
.B --playmode/-p=(onegroup,allgroups,groupsrandom,allrandom}
Default playing mode is resp. Play first group only, Play all groups in 
given order (default), Play all groups in random order, Play all songs in
random order.
.TP
.B --runframes/-r=number
Number or frames to decode in one loop. Range: 1 to 10 (default=5). A low 
value means that the interface (while playing) reacts faster but slow CPU's
might hick. A higher number implies a slow interface but less hicks on slow
CPU's.
.TP
.B --no-quit, -q
Don't quit after playing mp3[s] (only makes sense in combination with
--autolist or when you start mp3blaster with mp3's on the commandline)
.TP
.B --sound-device/-s=devicename
Select the audio device you wish to use for sound playback (default /dev/dsp
or /dev/audio for OpenBSD). If you want to play over NAS (Network Audio
System), give the audioserver's address here (usually $DISPLAY, e.g. a host
name followed by a colon and a server number, like bla.foo.com:0)
.SH BUGS
.PP
If you find bugs, please send reports to brama@stack.nl.
.PP
.SH AUTHOR
.I mp3blaster
has been written written and performed by 
.B Bram Avontuur <brama@stack.nl> <http://www.stack.nl/~brama/>
.PP
Please send comments, suggestions, complaints, bug fixes, coffee and porting
experiences to me, including the version number of mp3blaster in your mail.