annotate README @ 553:82346a6312c2 trunk

[svn] make WMA plugin strings translatable
author nenolod
date Wed, 01 Feb 2006 13:09:00 -0800
parents f3445e7184f7
children bc721c146511
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
70
f3445e7184f7 [svn] blah\!
msameer
parents: 0
diff changeset
1 Audacios (c) GPL 2005
0
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
2
70
f3445e7184f7 [svn] blah\!
msameer
parents: 0
diff changeset
3 Audacios Development Team (see AUTHORS)
0
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
4
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
5
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
6 Based on:
70
f3445e7184f7 [svn] blah\!
msameer
parents: 0
diff changeset
7 BMP - Beep Media Player.
f3445e7184f7 [svn] blah\!
msameer
parents: 0
diff changeset
8 Which was based on.
0
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
9
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
10 XMMS - X Multimedia System (c)1997-2001
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
11
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
12 A Cross platform Multimedia Player
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
13
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
14 Peter Alm, Thomas Nilsson, Olle Hallnas, Håvard Kvålen
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
15
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
16
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
17 NOTE: This document is hardly maintained. Please check the Users' Guide on
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
18 the BMP website.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
19
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
20
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
21 TABLE OF CONTENTS
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
22 *****************
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
23
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
24 1. Disclaimer
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
25 2. Installation
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
26 2.1 Basic Installation
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
27 2.2 Border less Installation
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
28 2.3 Skin Installation
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
29 3. Documentation
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
30 3.1 Controlling BMP
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
31 3.1.1 Key bindings
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
32 3.2 Playlist Editor
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
33 3.3 Equalizer
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
34 3.4 Menu
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
35 3.5 Preferences
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
36 3.5.1 Audio I/O Plugins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
37 3.5.2 Effect/General Plugins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
38 3.5.3 Visualization Plugins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
39 3.5.4 Options
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
40 3.5.5 Fonts
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
41 3.5.6 Title
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
42 3.6 Plugins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
43 3.6.1 Input plugins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
44 3.6.1.1 Cd Audio Player
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
45 3.6.1.2 MPEG Layer 1/2/3 player
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
46 3.6.1.3 Ogg Vorbis player
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
47 3.6.1.4 WAV player
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
48 3.6.2 Output plugins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
49 3.6.2.1 OSS Driver
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
50 3.6.2.2 eSound Output
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
51 3.6.2.3 BSD Sun Output
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
52 3.6.3 Effect plugins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
53 3.6.4 General plugins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
54 3.6.5 Visualization plugins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
55 3.6.5.1 Blur scope
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
56 4. Command Line Options
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
57 5. Features
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
58 5.1 Supported File formats
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
59 5.2 Supported Features
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
60 6. Obtaining BMP
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
61 7. Misc
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
62 7.1 Shoutcast support
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
63 7.2 Tips and tricks
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
64 8. Bugs
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
65 9. Contact Email
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
66
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
67
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
68
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
69
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
70 1. Disclaimer
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
71 -------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
72
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
73 We are not liable for any damage caused by the use of this program.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
74
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
75 BMP is NOT a port of WinAmp (http://www.winamp.com). BMP is a fork of
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
76 XMMS (http://xmms.org) which borrowed the WinAmp GUI.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
77
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
78
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
79 2. Installation
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
80 ---------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
81
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
82 BMP requires the following libraries and their development
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
83 packages installed:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
84
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
85 Glib 2.4
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
86 (http://www.gtk.org/download/)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
87
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
88 GTK+ 2.4
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
89 (http://www.gtk.org/download/)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
90
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
91 libglade >= 2.3.1
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
92 (http://ftp.gnome.org/pub/GNOME/sources/libglade/2.3/)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
93
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
94 The following packages are required for optional features:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
95
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
96 Vorbis input plugin:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
97 libvorbis >= 1.0
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
98 (http://www.xiph.org/ogg/vorbis/download.html)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
99
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
100 ESD output plugin:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
101 esound >= 0.2.3
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
102 (http://ftp.gnome.org/pub/GNOME/desktop/2.6/2.6.0/sources/)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
103
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
104 ALSA output plugin:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
105 alsa-lib >= 1.0
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
106 (http://www.alsa-project.org)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
107
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
108 GNOME VFS support:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
109 gnome-vfs >= 2.6.0
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
110 (http://ftp.gnome.org/pub/GNOME/desktop/2.6/2.6.0/sources/)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
111
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
112 GConf support:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
113 GConf >= 2.6.0
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
114 (http://ftp.gnome.org/pub/GNOME/desktop/2.6/2.6.0/sources/)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
115
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
116 If you compile BMP from a fresh CVS checkout, you will also need
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
117 the following tools:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
118
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
119 automake >= 1.7
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
120 autoconf >= 2.5
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
121
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
122 Note that these tools and libraries are bundled with major Linux
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
123 distributions. Use the packages provided with them where possible. If
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
124 those packages are not sufficiently new, you may need to search
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
125 third-party repositories for them.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
126
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
127
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
128 2.1 Basic Installation
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
129 ----------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
130
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
131 cd bmp-0.9.7
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
132 ./configure
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
133 make
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
134 make install
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
135
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
136 This will put the binary in /usr/local/bin and plugins in
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
137 /usr/local/lib/bmp/
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
138
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
139 Note for packagers: The gnome-vfs option is VERY EXPERIMENTAL. We suggest you
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
140 do not use it in your official distribution packages.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
141
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
142
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
143 2.2 Borderless Installation
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
144 ---------------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
145
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
146 As far as I know most WM's accepts GTK decoration hints so it will
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
147 not have borders. But some WM's can't handle this so you have to
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
148 set in manually.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
149
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
150 AfterStep 1.0 ~/.steprc
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
151 Style "XMMS_Player" NoTitle, NoHandles
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
152 Style "XMMS_Playlist" NoTitle, NoHandles
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
153 Style "XMMS_Equalizer" NoTitle, NoHandles
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
154
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
155 AfterStep 1.4 ~/GNUstep/Library/AfterStep/database
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
156 Style "XMMS_Player" NoTitle, NoHandles
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
157 Style "XMMS_Playlist" NoTitle, NoHandles
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
158 Style "XMMS_Equalizer" NoTitle, NoHandles
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
159
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
160 Fvwm's ~/.fvwm95rc
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
161 Style "XMMS_Player" NoTitle
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
162 Style "XMMS_Playlist" NoTitle
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
163 Style "XMMS_Equalizer" NoTitle
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
164
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
165 CTWM's ~/.ctwmrc
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
166 NoTitle and NoBorder sections:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
167 NoTitle {
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
168 "xmms"
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
169 }
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
170
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
171 NoBorder {
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
172 "xmms"
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
173 }
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
174
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
175 2.3 Skin Installation
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
176 ---------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
177
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
178 BMP will create a directory called ~/.bmp/Skins/. You can unarchive
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
179 the skins the same way as you do for WinAmp.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
180
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
181 However, you don't need to as BMP supports archived skins. BMP
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
182 currently reads the following formats: zip, wsz, tar, tar.gz and
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
183 tar.bz2
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
184
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
185 Just copy the archive to one of the skin path's and BMP will take care
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
186 of the rest.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
187
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
188 In order to support zipped skins you will need to have unzip. Unzip
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
189 is bundled with most Linux distributions.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
190
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
191 BMP looks for skins in these directories (in listing order):
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
192
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
193 <prefix>/share/bmp/Skins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
194 ~/.bmp/Skins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
195
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
196 You can set the environment variable SKINSDIR to another location of
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
197 your choice:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
198
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
199 For BASH:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
200 export SKINSDIR=/path/to/Skins:/more/paths/to/other/locations/of/Skins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
201
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
202 For CSH:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
203 setenv SKINSDIR /path/to/Skins:/more/paths/to/other/locations/of/Skins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
204
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
205
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
206 3. Documentation
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
207 ----------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
208
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
209 This file or http://beepmp.sf.net
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
210
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
211
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
212 3.1 Controlling BMP
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
213 --------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
214
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
215 When you start up BMP, you will get a console very similar to that of
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
216 WinAmp.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
217
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
218 - On the top is the window title bar. To the right you will see 3 buttons,
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
219 Left button will minimize BMP.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
220 Middle button will make BMP only display the title bar.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
221 Right button will end the BMP session.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
222
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
223 - The area in the upper left part displays the following:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
224 - Play state: Paused, Stopped, or Playing
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
225 - Time elapsed in the current song or if you click on it, the reversed.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
226 - Spectrum analyzer of the sound being played. Right mouse click will
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
227 bring up the Visualization menu. Left mouse button will change the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
228 analyzer to an oscilloscope and/or none.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
229
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
230 - To the right of the Spectrum analyzer is the title of the file being played.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
231 This also contains the length of the song being played, as well as its
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
232 position in the [unsorted] playlist. Right clicking in this window will bring
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
233 up a new menu with some more options that are self explaining.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
234
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
235 - In the left part of the Spectrum analyzer you'll have letters (at least if
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
236 you use the default skin) O A I D V. This is known as the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
237 "clutterbar'. Left-clicking on these will open up menus or perform the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
238 listed actions.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
239 O : Options menu
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
240 A : Always on top
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
241 I : File info box
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
242 D : Double size mode
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
243 V : Visualization menu
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
244
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
245 - Underneath the track title are the following static informational data:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
246 - bit rate in KBps (usually 128 or 112)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
247 - Sample Rate in KHz (usually 44)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
248 - Stereo or Mono channel mixing
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
249
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
250 - Underneath the informational data are a few controls you can play with:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
251 - The first slider controls the volume
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
252 - The second slider controls the balance between speakers
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
253 - The button marked "EQ" loads up the graphic equalizer
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
254 - The button marked "PL" loads up the playlist editor
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
255 - The LARGE slide bar moves from left to right as the song plays. You can
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
256 drag this to jump to another location in the current file.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
257
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
258 - On the bottom of the console are the standard buttons you would see on a CD
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
259 player: Previous track, Play, Pause, Stop, Next track, eject, shuffle
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
260 and repeat.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
261
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
262 - The eject button doesn't REALLY eject, of course. :) It opens up the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
263 file requester. The File Requester builds a playlist for the current
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
264 BMP session. You can use it to load files, add files to the list, or
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
265 load all mp3s in a directory.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
266
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
267 - The shuffle button randomizes the sequence of the playlist.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
268
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
269 - The repeat button when enabled makes the playlist loop when it reaches the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
270 end of the playlist.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
271
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
272
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
273 3.1.1 Key bindings
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
274 ------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
275
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
276 Global: (Main, Equalizer and Playlist window)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
277
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
278 z = Previous song
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
279 x = Play
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
280 c = Pause
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
281 v = Stop
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
282 b = Next song
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
283 l = Play file (brings up the Load file(s) dialog)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
284 j = Jump to file (in the existing playlist)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
285 r = Toggle Repeat
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
286 s = Toggle Shuffle
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
287
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
288 Control + h = Play location (url)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
289 Control + p = Preferences dialog
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
290 Control + r = Time remaining
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
291 Control + o = Always on top
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
292 Control + w = Winshade mode
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
293 Control + j = Jump to time
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
294 Control + z = Start of list
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
295 Control + n = No Playlist Advance
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
296 Control + 3 = File info dialog
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
297
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
298 Control + Alt + w = Toggle Equalizer winshade mode
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
299 Shift + Control + w = Toggle Playlist winshade mode
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
300
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
301 Alt + e = Toggle playlist window
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
302 Alt + g = Toggle equalizer window
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
303
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
304 Main window:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
305
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
306 Arrow key up = Volume up 2%
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
307 Arrow key down = Volume down 2%
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
308 Arrow key right = Skip 5 seconds forward in song
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
309 Arrow key left = Skip 5 seconds back in song
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
310
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
311 Playlist window:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
312
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
313 Arrow key up = up one step in playlist
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
314 Arrow key down = Down one step in playlist
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
315
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
316 Delete = Remove selected songs from playlist
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
317 Page Up = Move one page up
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
318 Page Down = Move one page down
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
319 Home = Go to the first song
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
320 End = Go to the last song
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
321 Enter = Play selected song
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
322 Insert = Add file dialog
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
323 Shift + Insert = Add directory dialog
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
324 Alt + Insert = Add url dialog
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
325
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
326 Equalizer shade mode:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
327
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
328 Arrow key up = Volume up 2%
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
329 Arrow key down = Volume down 2%
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
330 Arrow key right = Balance 4% to right
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
331 Arrow key left = Balance 4% to left
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
332
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
333
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
334 3.2 Playlist editor
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
335 -------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
336
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
337 To access the Playlist editor, select the button labeled "PL" on the right
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
338 side of the BMP console.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
339
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
340 This will bring up the actual playlist window, here you'll find 5 buttons.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
341 All of these buttons can be held down to bring up an extra menu.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
342 From left to right:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
343
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
344 file + : will add a file to current playlist, held down mode you'll have
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
345 2 extra options
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
346 dir : will let you pick a directory (recursive)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
347 url : will let you add an url for streaming
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
348
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
349 file - : will delete the highlighted file, held down mode you'll have 3
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
350 more options
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
351 crop : delete all files except the highlighted in the list
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
352 all : delete all files in the list
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
353 misc : *** NOT FUNCTIONAL ***
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
354
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
355 sel all : select all files in current playlist, held down mode you'll have
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
356 2 extra options
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
357 sel zero : select none
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
358 inv sel : invert you selection
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
359
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
360 misc opts : held down you'll have 2 extra options
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
361 fileinfo : opens the file info dialog.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
362 sort : release button on this will bring up another menu with sort options
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
363
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
364 load list : will let you pick a playlist to load, held down you'll have
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
365 2 extra options
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
366 save : will let you save your playlist
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
367 new : will empty the playlist and let you create a new playlist
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
368
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
369 If you want to select/deselect files in the filrequester/playlist editor use
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
370 CTRL for files and SHIFT key for blocks of files. You can also browse the PL
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
371 using the cursor keys and enter to select song. Pressing the delete button will
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
372 remove the song from the playlist. If your mouse is equipped with a mouse
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
373 wheel, you can use this to scroll up and down.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
374
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
375 3.3. Equalizer
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
376 --------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
377
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
378 To access the Equalizer, select the button labeled "EQ" on the right
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
379 side of the BMP console.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
380
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
381 That will bring up the Equalizer window. It looks like an equalizer on a stereo
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
382 and behaves like one as well. Press the button labeled ON to enable the use of
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
383 the equalizer, once you turned it on you use it as a normal equalizer.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
384
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
385 EQ presets will be saved in ~/.bmp/config when you close BMP. You can also
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
386 have your own presets for different song using the "Preset" button, BMP can
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
387 also import/export from WinAmp's preset files.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
388
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
389 If 'Auto' is enabled, BMP will try to load equalizer presets like this:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
390
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
391 1: Look for a preset file in the directory of the file we are about to play.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
392 2: Look for a directory preset file in the same directory.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
393 3: Look for a preset saved with the "auto-load" feature.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
394 4: Finally, try to load the "default" preset.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
395
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
396 The 'preset' button will open up a menu with the following options:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
397
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
398 Load
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
399 Preset : Will open a window with all available presets.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
400 Auto-load preset : Will open a window with all available auto-load
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
401 presets.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
402 Default : Will load the default preset.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
403 Zero : Will reset the equalizer to zero.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
404 From file : Will load from a .preset file
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
405 From WinAMP EQF file : Will load from a WinAMP equalizer file. If you
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
406 choose a library file only the first entry will
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
407 be loaded.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
408 Import
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
409 WinAMP presets : Imports the presets contained in an WinAMP equalizer
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
410 library file (often named WINAMP.q1) and add all
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
411 the entries to the Preset window.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
412 Save
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
413 Preset : Let you name the current preset and save it.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
414 Auto-load preset : Saves the current settings as a preset for the song
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
415 currently playing.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
416 Default : Saves the default value for the equalizer.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
417 From file : Saves the current settings in a preset file.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
418 From WinAMP EQF file : Exports the current settings to a file readable by
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
419 WinAMP.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
420 Delete
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
421 Preset : Let you delete a preset from the list.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
422 Auto-load preset : Let you delete a auto-load preset from the list.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
423
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
424 Configure Equalizer : Change the default names of directory based
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
425 preset files.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
426
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
427 3.4. Menu
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
428 ---------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
429
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
430 There are several menu hot spots on the BMP window. One place is at the left
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
431 hand side of the visual window described in sections 3.1 If you click the right
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
432 mouse button in the main window, the menus will also pop up (same as clicking
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
433 the button on the top left corner).
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
434
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
435 3.5. Preferences
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
436 ----------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
437
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
438 Use the menu to open Options / Preferences or press CTRL-P to bring the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
439 preferences dialog up.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
440
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
441 3.5.1. Appearance
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
442 -----------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
443
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
444 Skins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
445 In the skinlist you can choose a skin. How to install skins is described above.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
446 Click on a skin in the list to change to it.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
447
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
448 Fonts
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
449 You can set the font in the main window by setting the 'Player' font. You can
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
450 change the playlist font by setting the 'Playlist' font.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
451
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
452 Miscellaneous
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
453 Show track numbers in playlist - Enable/disable displaying of track numbers in
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
454 the playlist.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
455 Use custom cursors - Enable/disable custom cursors set by the skin.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
456
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
457
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
458 3.5.2. Mouse
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
459 ------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
460
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
461 Mouse wheel
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
462 Change how BMP handles scroll behaviours.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
463
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
464 3.5.3. Playlist
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
465 ---------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
466
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
467 Filename
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
468 Convert underscores to blanks - Converts '_' (underscores) to ' ' in the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
469 playlist.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
470 Convert %20 to blanks - Converts '%20' to ' ' in the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
471 playlist.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
472
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
473 Metadata
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
474 Load metadata from playlists and files - Loads metadata from files and
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
475 playlists (e.g. ID3 tags).
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
476
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
477 Playback
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
478 Don't advance in playlist - Don't advance to the next song in the playlist when
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
479 the current song ends.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
480 Pause between songs - Set the time (in secons) to pause on songchange
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
481
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
482 Song display
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
483 Title format - Choose the format to display the song names in the playlist.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
484 Custom string - When the above option is set to 'Custom' insert a string of
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
485 substitutes here.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
486
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
487 3.5.6. Plugins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
488 --------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
489
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
490 Enable/disable and configure plugins in this section.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
491
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
492 Choose a tab to list one of the types of plugins:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
493 - Media (filetype/device support)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
494 - General (general plugins)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
495 - Visualization (visualization plugins)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
496 - Effects (effect plugins)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
497 - Output (output plugins)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
498
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
499 3.6 Plugins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
500 -----------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
501 Plugins is what makes BMP work, by moving most of the code out of BMP and
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
502 into a plugin architecture it's possible to change almost everything in BMP.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
503 There are today 5 different types of plugins. Only a few plugins are
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
504 distributed with BMP, you can find information on more of them at:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
505
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
506 http://beepmp.sf.net
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
507
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
508
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
509 3.6.1 Input plugins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
510 -------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
511 The input plugins is what you use to play mp3, mod, wav and even movies with.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
512
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
513
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
514 3.6.1.1 Cd Audio Player
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
515 -----------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
516 Plays audio cd's on Linux, FreeBSD and Solaris. This plugin does not pass
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
517 the sound through BMP, so no visualization can be made nor will the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
518 equalizer settings have any effect.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
519
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
520 Before I explain the usage we better have a look on the configuration
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
521 first.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
522
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
523 In the device tab you should set Device to your cdrom unit. /dev/cdrom
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
524 is generally a good choice on Linux systems. Set 'Directory' to where a
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
525 directory which will be used by BMP to present the available cd tracks in.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
526 Using the normal mount point for the cdrom is recommended unless the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
527 cdrom is automounted if it contains a data track.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
528
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
529 Example:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
530 --------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
531 Device: /dev/cdrom (which on my system is symlinked to /dev/hdc)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
532 Directory: /mnt/cdrom
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
533
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
534 The next setting is used to decide what volume is to be changed, it's either
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
535 the OSS Mixer for CD Audio or the actual volume on the CDROM.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
536
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
537 In the CD Info tab you can choose if the plugin should try and get the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
538 track names from a Internet database server.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
539
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
540 You can either use the CDDB protocol or CD Index. CDDB defaults to a free
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
541 version of CDDB, but it will work with the infamous cddb servers as well.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
542
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
543 Show network window will display some useful information if something goes
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
544 wrong, but you'll have to close and re-open it to update the content of it.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
545
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
546 If a CDDB server is too slow for your taste, you can press 'Get server list'
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
547 to receive a list of alternate servers.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
548
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
549 CD Index is another type of database, but works in a similar manner. If
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
550 you don't have libxml installed when you compiled the plugin, this will be
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
551 grayed out.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
552
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
553 In the "Track names" box you can decide on how the plugin presents the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
554 tracks to you. This is normally handled by the 'Title' (section 3.5.6) setting
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
555 in the main preferences, but you can choose to override them here.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
556
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
557 Available variables are:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
558
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
559 %p = Performer/Artist %t = Track name
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
560 %a = Album %n = Track number
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
561
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
562 So "%n. %t / %p (%a)" would display something like:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
563
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
564 1. New Life / Depeche Mode (Speak & Spell)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
565
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
566 Now to add your CDROM tracks to the playlist. Insert an audio cd into the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
567 CDROM drive and press the Eject button. Go to the directory which you defined
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
568 earlier ( /mnt/cdrom ) and you should see a list of tracks. They will be named
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
569 Track XX.cda, select the tracks you want to play and press OK. If you had
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
570 choosed an Internet database and the CD exists in it, BMP will now display
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
571 the tracks you have chosen with their names according to the 'Name format'
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
572 configuration.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
573
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
574 Now, that wasn't hard now was it?
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
575
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
576 If you want BMP to identify as something else when speaking with servers, you
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
577 can set the environmental variable "XMMS_CDDB_CLIENT_NAME", and BMP will use
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
578 that instead.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
579
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
580
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
581 3.6.1.2 MPEG Layer 1/2/3 player
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
582 -------------------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
583 The main reason why this player exists today is mp3 files, so what could be
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
584 better than a plugin that plays them?.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
585
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
586 It's based off the mpg123 engine and handles MPEG Layer 1/2/3 files and
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
587 VBR (variable bit rate) MP3 files.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
588
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
589 The first configuration tab is just like the MikMod one, and again, if you
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
590 have an older soundcard and the music is going half speed, change the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
591 'Resolution' setting.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
592
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
593 If you have mp3 files named something else than .mp3, you might want to enable
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
594 'Detect files by content' so BMP will know that they are supported. Although
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
595 I'd recommend that you rename the files (or just beat the person who burned his
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
596 high-school bands music with in proper file extensions into giving you a new
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
597 cd) since this is rather slow.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
598
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
599 In the streaming tab you can choose a 'Buffer size' in kilobytes which BMP
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
600 will keep while streaming. This ranges from 4 -> 4096kb (which should be
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
601 sufficient for most people. The 'Pre-buffer' value is how much of the buffer
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
602 BMP should fill before starting to play the stream. (0%-90%)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
603
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
604 I'll let Chad Armstrong describe the two following options.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
605
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
606 "As streaming becomes more popular, there is rising demand for better
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
607 information about the current track being played. This 'Now Playing'
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
608 information (also known as 'Title Streaming') allows for more information to be
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
609 passed back to the listener. In the past, there was a method started by the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
610 Shoutcast group, which embedded this information in the stream itself. The mp3
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
611 standard was never designed to allow for text information to be interleaved
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
612 with audio data, and it is this design which can cause errors in playback. The
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
613 Icecast Team has taken this data completely out of the mp3 data, and has
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
614 provided it in a side channel (via UDP)."
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
615
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
616 - Chad Armstrong (icemonk)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
617
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
618 You're better off having both these options enabled. :)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
619
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
620 In the 'Title' tab you can change the way BMP presents the mp3 files to the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
621 playlist.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
622
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
623 ID3 is data stored in the mp3 file and can include Artist, Album etc. If you
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
624 uncheck 'Use ID3 tags' BMP will display the filename instead of the ID3
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
625 information.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
626
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
627 ID3V2 allows for a lot of extra data to be stored in the mp3 file, and don't
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
628 suffer from the limitations of ID3V1, BMP supports the same data that are
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
629 available in ID3V1 but not the extra data. If a mp3 file contains both ID3V1
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
630 and ID3V2 tags, you might see something different that the 'file info' editor
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
631 displays. If this happens, you might want to turn on 'Disable ID3V2 tags'.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
632
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
633 'Override generic titles' is used if you do not want to use the generic titles
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
634 defined in the preferences. See section 3.5.6.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
635
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
636 The 'ID3 format:' box allows you to alter in which order the information about
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
637 the current song is displayed.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
638
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
639 Example: %p - %t (%a) [%y]
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
640 will display something like "Laibach - Alle Gegen Alle (Nato) [1994]"
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
641
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
642 available fields are:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
643
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
644 %p - Artist (ex: Laibach)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
645 %a - Album (ex: Nato)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
646 %f - File name (ex: laibach-allegegenalle)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
647 %F - File path (ex: /home/thomas/mp3)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
648 %e - File extension (ex: mp3)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
649
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
650 %t - Track name (ex: Alle Gegen Alle)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
651 %n - Track number (ex: 6)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
652 %y - Year (ex: 1994)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
653 %g - Genre (ex: Electronic)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
654 %c - Comment (ex: Cover of D.A.F)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
655
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
656
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
657 3.6.1.3 Ogg Vorbis Player
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
658 -------------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
659
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
660 Plays OGG Vorbis encoded files, see http://www.xiph.org/ogg/vorbis/index.html
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
661 for more information.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
662
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
663
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
664 3.6.1.4 WAV player
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
665 -------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
666 This plugin plays as suggested, wave files. It supports 16bit and 8bit PCM wave
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
667 files.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
668
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
669
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
670 3.6.2 Output plugins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
671 --------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
672 This type of plugins is what is used to send the audio data to your soundcard
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
673 or alternative devices.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
674
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
675
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
676 3.6.2.1 OSS Driver
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
677 ------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
678 This plugin is probably what most of you will use if your system is equipped
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
679 with the OpenSoundSystem (www.opensound.com) drivers or compatible.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
680 Compatible drivers are ALSA with their OSS emulation, and Linux kernel sound
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
681 drivers.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
682
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
683 In the 'Devices' tab you can change the soundcard which BMP is going to use.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
684 If your driver have more than one dsp, you can change the one BMP uses by
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
685 enabling 'Use alternate device' and changing the '/dev/dsp' to suit your needs.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
686
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
687 If you have changed your Audio Device to another soundcard (if you for some
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
688 reason have two cards) don't forget to change the 'Mixer device' setting to the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
689 soundcard you want to use.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
690
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
691 In the 'Buffering' tab you can change how much data the OSS plugin will buffer.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
692 The 'Buffer size' ranges from 200 - 10000ms. If you want the plugin to wait for
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
693 the buffer to be filled before it starts playing the music change the 'Pre-
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
694 buffer' value, this ranges from 0% - 90% of the 'Buffer size' value.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
695
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
696 In the 'Mixer' tab you can change which volume setting BMP should change when
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
697 you alter the volume from BMP. Enable 'Volume controls Master not PCM' if you
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
698 want BMP to change the volume of all sounds instead of only PCM/wave sound.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
699
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
700
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
701 3.6.2.2 eSound Output
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
702 ---------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
703 The 'ESD' plugin will use the 'Enlightened Sound Daemon' to playback the audio.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
704 It's useful if you want to be able to have sound effects in your programs and
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
705 still be able to listen to music with BMP.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
706
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
707 In the 'Server' tab of the configuration, you can tell the plugin where to send
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
708 the audio data. Enable 'Use remote host' and enter the name/ip of the server
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
709 and port to send to. This is probably only useful in a LAN environment, since
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
710 the audio data is sent uncompressed to the remote ESD.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
711
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
712 The 'Buffering' tab works just like the 'OSS Driver' one.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
713
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
714
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
715 3.6.2.3 BSD Sun Output
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
716 ----------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
717 The 'Sun' output plugin will use the native audio(4) interface provided
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
718 by OpenBSD and NetBSD for playback and mixing.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
719
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
720 The $AUDIODEVICE and $MIXERDEVICE environment variables will override the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
721 current configuration settings. Defaults are /dev/audio and /dev/mixer.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
722
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
723 In the 'Devices' tab you can change the audio, audioctl and mixer devices
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
724 BMP is going to use. The audioctl device is used for ioctl(2) calls
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
725 independent of audio data I/O.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
726
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
727 In the 'Buffering' tab you can change how much data the Sun plugin will
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
728 buffer. The 'Buffer size' ranges from 200 - 10000ms. If you want the plugin
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
729 to wait for the buffer to be filled before it starts playing the music,
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
730 change the 'Pre-buffer' value, this ranges from 0% - 90% of the 'Buffer size'
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
731 value.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
732
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
733 In the 'Mixer' tab you can select the volume device to be affected when you
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
734 alter the volume from BMP. `BMP uses mixer exclusively' causes BMP to
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
735 keep the mixer device open instead of re-opening it for each operation.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
736
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
737 There may also be some more options depending on what your audio mixer
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
738 device supports (eg. loudness, spatial, surround, preamp).
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
739
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
740 In the 'Status' tab you can see audio device information and real-time
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
741 playback status.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
742
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
743
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
744 3.6.3 Effect plugins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
745 --------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
746 Effect plugins can alter the sound of the music you are listening to.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
747
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
748
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
749 3.6.4 General plugins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
750 ---------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
751 Mostly used for controlling BMP and passing data to other programs.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
752
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
753
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
754 3.6.5 Visualization plugins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
755 ---------------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
756 Eye candy plugins.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
757
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
758
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
759 3.6.5.1 Blur scope
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
760 -------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
761 A simple blurring oscilloscope, in the configuration you can change the color
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
762 with the standard GTK color dialog.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
763
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
764
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
765 4. Command Line Options
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
766 -----------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
767
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
768 beep-media-player --help will produce:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
769
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
770 Usage: beep-media-player [options] [files] ...
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
771
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
772 Options:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
773 --------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
774
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
775 -h, --help Display this text and exit.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
776 -n, --session Select BMP/XMMS session (Default: 0)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
777 -r, --rew Skip backwards in playlist
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
778 -p, --play Start playing current playlist
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
779 -u, --pause Pause current song
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
780 -s, --stop Stop current song
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
781 -t, --play-pause Pause if playing, play otherwise
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
782 -f, --fwd Skip forward in playlist
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
783 -e, --enqueue Don't clear the playlist
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
784 -m, --show-main-window Show the main window
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
785 -v, --version Print version number and exit.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
786
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
787 You can specify files on the command line, e.g:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
788
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
789 beep-media-player file1.mp3 file2.mp3 file3.mp3
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
790 beep-media-player *.mp3
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
791 beep-media-player playlist.m3u (note: playlists must be named .m3u)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
792
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
793 If you do this while BMP is running the current playlist
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
794 will be cleared and the files/playlist specified on the command
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
795 line will be used instead.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
796
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
797 To keep the current playlist intact use the -e option.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
798
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
799
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
800 5. Features
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
801 -----------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
802
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
803 5.1 Supported File formats
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
804 -------------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
805
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
806 OGG Vorbis
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
807 MP2 and MP3 streams
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
808 WAV/AU samples
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
809
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
810 Others:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
811
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
812 CD audio
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
813 Shout/Icecast
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
814
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
815
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
816 5.2 Supported Features
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
817 ----------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
818
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
819 Seeking in files
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
820 Volume/Balance
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
821 Shuffle play
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
822 Repeat play
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
823 Playlist editor
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
824 Spectrum Analyzer
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
825 One Line mode al'a WinShade in WinAmp
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
826 Oscilloscope
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
827 Timer Elapsed/Timer Remaining
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
828 Plug-in system Output/Input/Effect/General/Visualization
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
829 Equalizer
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
830 Double Size option
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
831 WinAmp 2.0 skin support (can use wsz files)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
832 GTK Requesters (with theme support)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
833 Streaming/Shoutcast(1.0/1.1)/Icecast support
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
834 Auto remove borders if the WM has support for it
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
835 Fast jump in playlist
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
836 Scroll wheel support
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
837 Saves HTTP streams to HD
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
838 HTTP authentication
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
839 Plays MPEG layer 1/2/3, WAV, Ogg Vorbis
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
840 Compiles and works on other Unixes
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
841 Proxy authentication support
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
842
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
843
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
844 6. Obtaining BMP
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
845 -------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
846
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
847 Currently, we only provide source tarballs at:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
848
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
849 http://sourceforge.net/project/showfiles.php?group_id=95272
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
850
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
851 The CVS snapshots listed are not regularly updated. We encourage you
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
852 to download BMP straight from CVS:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
853
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
854 cvs -z3 -d:pserver:anonymous@cvs.sf.net:/cvsroot/beepmp login
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
855 cvs -z3 -d:pserver:anonymous@cvs.sf.net:/cvsroot/beepmp co bmp
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
856
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
857
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
858
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
859 FIXME: add links to user made packages
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
860
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
861
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
862 6.1 Obtaining Skins
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
863 -------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
864
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
865 You can find BMP/XMMS skins made by BMP/XMMS users at:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
866
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
867 http://www.xmms.org/skins.html
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
868 http://themes.org/skins/xmms
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
869
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
870
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
871 7. Misc
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
872 -------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
873
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
874 7.1. Tips and Tricks
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
875 -------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
876
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
877 If you have a windows partition with WinAmp installed, a good idea would be to
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
878 set the SKINSDIR variable to that dir.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
879
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
880 BMP features some command line options like next/previous songs, those
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
881 things can be binded to a key. I use AfterStep and the useless window keys
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
882 for this. Here is an example from my .steprc:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
883
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
884 Key Meta_R A N Exec "bmp" beep-media-player -r
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
885 Key Menu A N Exec "bmp" beep-media-player -f
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
886
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
887 If you want all your mp3's in one playlist an easy way is:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
888 locate .mp3 > /path/to/playlistname
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
889
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
890 (considering you have a fairly recent updatedb, don't blame us if locate don't
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
891 find the file you downloaded 3 minutes ago)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
892
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
893
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
894 8. Bugs
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
895 -------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
896
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
897 BMP is under heavy development and as such, has quite a number of
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
898 bugs. Our bug tracker page is maintained at:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
899
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
900 http://www.sosdg.org/~larne/bugs/
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
901
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
902 It will continue to have bugs as we fix and introduce new ones through
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
903 rewriting and enhancement. Help us along by reporting new bugs, and
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
904 verifying existing ones.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
905
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
906 If you have a fix for any of the bugs, please let us know using the
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
907 tracker or posting to our development mailing list at:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
908
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
909 beepmp-devel@lists.sourceforge.net
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
910
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
911
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
912 9. Contact Email's
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
913 ------------------
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
914
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
915 Project Admins:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
916
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
917 Milosz Derezynski email: mderezynski at users sourceforge net
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
918 Chong Kai Xiong email: descender at phreaker net
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
919
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
920 You can more information about the BMP team from this page:
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
921
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
922 http://sourceforge.net/project/memberlist.php?group_id=95272