annotate README.bmp @ 1936:60934ccc817d trunk

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