Mercurial > audlegacy
annotate README @ 4490:2e56a47e7a5d
Correctly check for USE_DBUS and USE_EGGSM.
author | Matti Hamalainen <ccr@tnsp.org> |
---|---|
date | Mon, 21 Apr 2008 07:32:45 +0300 |
parents | 996727ab0fe1 |
children | b42602020349 |
rev | line source |
---|---|
2306 | 1 Audacious |
2 A relatively powerful media player | |
0 | 3 |
4332
7f0996dc0c43
Updated copyright year and added a note about Audacious not being XMMS nor BMP.
Matti Hamalainen <ccr@tnsp.org>
parents:
4331
diff
changeset
|
4 Copyright (c) 2005-2008 Audacious Development Team (see AUTHORS) |
0 | 5 |
6 Based on: | |
2306 | 7 BMP - Beep Media Player (c)2002-2005 |
0 | 8 |
2306 | 9 Which was based on: |
0 | 10 XMMS - X Multimedia System (c)1997-2001 |
11 | |
12 A Cross platform Multimedia Player | |
13 | |
14 Peter Alm, Thomas Nilsson, Olle Hallnas, Håvard Kvålen | |
15 | |
16 | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
17 NOTE: This document is hardly maintained. Please check the Users' Guide |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
18 on the Audacious website. |
0 | 19 |
20 | |
21 TABLE OF CONTENTS | |
22 ***************** | |
23 | |
24 1. Disclaimer | |
25 2. Installation | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
26 2.1. Basic Installation |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
27 2.2. Borderless Installation |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
28 2.3. Skin Installation |
0 | 29 3. Documentation |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
30 3.1. Controlling Audacious |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
31 3.1.1. Key bindings |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
32 3.2. Playlist editor |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
33 3.3. Equalizer |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
34 3.4. Menu |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
35 3.5. Preferences |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
36 3.5.1. Appearance |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
37 3.5.2. Mouse |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
38 3.5.3. Playlist |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
39 3.5.4. Plugins |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
40 3.5.5. Audio |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
41 3.6. Plugins |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
42 3.7. Playlist Manager |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
43 4. Obtaining Audacious |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
44 4.1. Obtaining Skins |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
45 5. Bugs |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
46 6. Contact |
0 | 47 |
48 | |
49 | |
50 | |
51 1. Disclaimer | |
52 ------------- | |
53 | |
54 We are not liable for any damage caused by the use of this program. | |
55 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
56 Audacious is NOT a port of WinAmp (http://www.winamp.com). Audacious is |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
57 a fork of XMMS (http://xmms.org) and BMP which borrowed the WinAmp GUI. |
0 | 58 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
59 However, Audacious is neither XMMS, or BMP, but takes a direction of |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
60 its own. |
4332
7f0996dc0c43
Updated copyright year and added a note about Audacious not being XMMS nor BMP.
Matti Hamalainen <ccr@tnsp.org>
parents:
4331
diff
changeset
|
61 |
0 | 62 |
63 2. Installation | |
64 --------------- | |
65 | |
1174 | 66 Audacious requires the following libraries and their development |
0 | 67 packages installed: |
68 | |
4333 | 69 Glib 2.14.0 |
4331 | 70 http://www.gtk.org/download/ |
0 | 71 |
4333 | 72 GTK+ 2.10.0 |
4331 | 73 http://www.gtk.org/download/ |
0 | 74 |
4443 | 75 mcs >= 0.7 |
4331 | 76 http://www.atheme.org/projects/mcs.shtml |
2568 | 77 |
4331 | 78 libmowgli >= 0.4 |
79 http://www.atheme.org/projects/mowgli.shtml | |
0 | 80 |
4331 | 81 If you compile Audacious from a fresh Mercurial checkout, you will also |
82 need the following tools: | |
83 | |
1427 | 84 autoconf >= 2.59 |
0 | 85 |
86 Note that these tools and libraries are bundled with major Linux | |
87 distributions. Use the packages provided with them where possible. If | |
88 those packages are not sufficiently new, you may need to search | |
89 third-party repositories for them. | |
90 | |
91 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
92 2.1. Basic Installation |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
93 ----------------------- |
0 | 94 |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
95 cd audacious-VERSION |
0 | 96 ./configure |
97 make | |
98 make install | |
99 | |
100 This will put the binary in /usr/local/bin and plugins in | |
1174 | 101 /usr/local/lib/audacious/ |
0 | 102 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
103 If you want to use the automatic character detection system, then you |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
104 should use --enable-chardet. |
1427 | 105 |
0 | 106 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
107 2.2. Borderless Installation |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
108 ---------------------------- |
0 | 109 |
110 As far as I know most WM's accepts GTK decoration hints so it will | |
111 not have borders. But some WM's can't handle this so you have to | |
112 set in manually. | |
113 | |
114 AfterStep 1.0 ~/.steprc | |
115 Style "XMMS_Player" NoTitle, NoHandles | |
116 Style "XMMS_Playlist" NoTitle, NoHandles | |
117 Style "XMMS_Equalizer" NoTitle, NoHandles | |
118 | |
119 AfterStep 1.4 ~/GNUstep/Library/AfterStep/database | |
120 Style "XMMS_Player" NoTitle, NoHandles | |
121 Style "XMMS_Playlist" NoTitle, NoHandles | |
122 Style "XMMS_Equalizer" NoTitle, NoHandles | |
123 | |
124 Fvwm's ~/.fvwm95rc | |
125 Style "XMMS_Player" NoTitle | |
126 Style "XMMS_Playlist" NoTitle | |
127 Style "XMMS_Equalizer" NoTitle | |
128 | |
129 CTWM's ~/.ctwmrc | |
130 NoTitle and NoBorder sections: | |
131 NoTitle { | |
132 "xmms" | |
133 } | |
134 | |
135 NoBorder { | |
136 "xmms" | |
137 } | |
138 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
139 |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
140 2.3. Skin Installation |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
141 ---------------------- |
0 | 142 |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
143 Audacious will create a directory called ~/.local/share/audacious/Skins. |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
144 You can unarchive the skins the same way as you do for Winamp. |
0 | 145 |
1174 | 146 However, you don't need to as Audacious supports archived skins. Audacious |
0 | 147 currently reads the following formats: zip, wsz, tar, tar.gz and |
148 tar.bz2 | |
149 | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
150 Just copy the archive to one of the skin paths and Audacious will take |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
151 care of the rest. |
0 | 152 |
153 In order to support zipped skins you will need to have unzip. Unzip | |
154 is bundled with most Linux distributions. | |
155 | |
1174 | 156 Audacious looks for skins in these directories (in listing order): |
0 | 157 |
1174 | 158 <prefix>/share/audacious/Skins |
2685
fc3bb92994dd
[svn] XDG path fixes in documentation, submitted by nine on irc.atheme.org
chainsaw
parents:
2568
diff
changeset
|
159 ~/.local/share/audacious/Skins |
1174 | 160 ~/.audacious/Skins |
0 | 161 |
162 You can set the environment variable SKINSDIR to another location of | |
163 your choice: | |
164 | |
165 For BASH: | |
166 export SKINSDIR=/path/to/Skins:/more/paths/to/other/locations/of/Skins | |
167 | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
168 For C Shell: |
0 | 169 setenv SKINSDIR /path/to/Skins:/more/paths/to/other/locations/of/Skins |
170 | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
171 You should note that skins designed specifically for Audacious are not |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
172 compatible with Winamp. Likewise, we do not support Winamp "modern" skins as |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
173 there is a lot of Winamp-specifics that would have to be reverse-engineered |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
174 or emulated to properly support those skins. |
0 | 175 |
176 3. Documentation | |
177 ---------------- | |
178 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
179 This file or http://audacious-media-player.org/ |
0 | 180 |
181 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
182 3.1. Controlling Audacious |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
183 -------------------------- |
0 | 184 |
1174 | 185 When you start up Audacious, you will get a console very similar to that of |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
186 Winamp. |
0 | 187 |
188 - On the top is the window title bar. To the right you will see 3 buttons, | |
1174 | 189 Left button will minimize Audacious. |
190 Middle button will make Audacious only display the title bar. | |
191 Right button will end the Audacious session. | |
0 | 192 |
193 - The area in the upper left part displays the following: | |
194 - Play state: Paused, Stopped, or Playing | |
195 - Time elapsed in the current song or if you click on it, the reversed. | |
196 - Spectrum analyzer of the sound being played. Right mouse click will | |
197 bring up the Visualization menu. Left mouse button will change the | |
198 analyzer to an oscilloscope and/or none. | |
199 | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
200 - To the right of the Spectrum analyzer is the title of the file being |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
201 played. This also contains the length of the song being played, as well |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
202 as its position in the [unsorted] playlist. Right clicking in this window |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
203 will bring up a new menu with some more options that are self explaining. |
0 | 204 |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
205 - In the left part of the Spectrum analyzer you'll have letters (at least |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
206 if you use the default skin) O A I D V. This is known as the "clutterbar'. |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
207 Left-clicking on these will open up menus or perform the listed actions. |
0 | 208 O : Options menu |
209 A : Always on top | |
210 I : File info box | |
211 D : Double size mode | |
212 V : Visualization menu | |
213 | |
214 - Underneath the track title are the following static informational data: | |
215 - bit rate in KBps (usually 128 or 112) | |
216 - Sample Rate in KHz (usually 44) | |
217 - Stereo or Mono channel mixing | |
218 | |
219 - Underneath the informational data are a few controls you can play with: | |
220 - The first slider controls the volume | |
221 - The second slider controls the balance between speakers | |
222 - The button marked "EQ" loads up the graphic equalizer | |
223 - The button marked "PL" loads up the playlist editor | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
224 - The LARGE slide bar moves from left to right as the song plays. You |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
225 can drag this to jump to another location in the current file. |
0 | 226 |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
227 - On the bottom of the console are the standard buttons you would see on |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
228 a CD player: Previous track, Play, Pause, Stop, Next track, eject, |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
229 shuffle and repeat. |
0 | 230 |
231 - The eject button doesn't REALLY eject, of course. :) It opens up the | |
232 file requester. The File Requester builds a playlist for the current | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
233 Audacious session. You can use it to load files, add files to the list, |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
234 or load all mp3s in a directory. |
0 | 235 |
236 - The shuffle button randomizes the sequence of the playlist. | |
237 | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
238 - The repeat button when enabled makes the playlist loop when it reaches |
0 | 239 end of the playlist. |
240 | |
241 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
242 3.1.1. Key bindings |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
243 ------------------- |
0 | 244 |
245 Global: (Main, Equalizer and Playlist window) | |
246 | |
247 z = Previous song | |
248 x = Play | |
249 c = Pause | |
250 v = Stop | |
251 b = Next song | |
252 l = Play file (brings up the Load file(s) dialog) | |
253 j = Jump to file (in the existing playlist) | |
254 r = Toggle Repeat | |
255 s = Toggle Shuffle | |
256 | |
257 Control + h = Play location (url) | |
258 Control + p = Preferences dialog | |
259 Control + r = Time remaining | |
260 Control + o = Always on top | |
261 Control + w = Winshade mode | |
262 Control + j = Jump to time | |
263 Control + z = Start of list | |
264 Control + n = No Playlist Advance | |
265 Control + 3 = File info dialog | |
266 | |
267 Control + Alt + w = Toggle Equalizer winshade mode | |
268 Shift + Control + w = Toggle Playlist winshade mode | |
269 | |
270 Alt + e = Toggle playlist window | |
271 Alt + g = Toggle equalizer window | |
272 | |
273 Main window: | |
274 | |
275 Arrow key up = Volume up 2% | |
276 Arrow key down = Volume down 2% | |
277 Arrow key right = Skip 5 seconds forward in song | |
278 Arrow key left = Skip 5 seconds back in song | |
279 | |
280 Playlist window: | |
281 | |
282 Arrow key up = up one step in playlist | |
283 Arrow key down = Down one step in playlist | |
284 | |
285 Delete = Remove selected songs from playlist | |
286 Page Up = Move one page up | |
287 Page Down = Move one page down | |
288 Home = Go to the first song | |
289 End = Go to the last song | |
290 Enter = Play selected song | |
291 Insert = Add file dialog | |
292 Shift + Insert = Add directory dialog | |
293 Alt + Insert = Add url dialog | |
294 | |
295 Equalizer shade mode: | |
296 | |
297 Arrow key up = Volume up 2% | |
298 Arrow key down = Volume down 2% | |
299 Arrow key right = Balance 4% to right | |
300 Arrow key left = Balance 4% to left | |
301 | |
302 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
303 3.2. Playlist editor |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
304 -------------------- |
0 | 305 |
306 To access the Playlist editor, select the button labeled "PL" on the right | |
1174 | 307 side of the Audacious console. |
0 | 308 |
309 This will bring up the actual playlist window, here you'll find 5 buttons. | |
310 All of these buttons can be held down to bring up an extra menu. | |
311 From left to right: | |
312 | |
313 file + : will add a file to current playlist, held down mode you'll have | |
314 2 extra options | |
315 dir : will let you pick a directory (recursive) | |
316 url : will let you add an url for streaming | |
317 | |
318 file - : will delete the highlighted file, held down mode you'll have 3 | |
319 more options | |
320 crop : delete all files except the highlighted in the list | |
321 all : delete all files in the list | |
322 misc : *** NOT FUNCTIONAL *** | |
323 | |
324 sel all : select all files in current playlist, held down mode you'll have | |
325 2 extra options | |
326 sel zero : select none | |
327 inv sel : invert you selection | |
328 | |
329 misc opts : held down you'll have 2 extra options | |
330 fileinfo : opens the file info dialog. | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
331 sort : release button on this will bring up another menu with sort |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
332 options |
0 | 333 |
334 load list : will let you pick a playlist to load, held down you'll have | |
335 2 extra options | |
336 save : will let you save your playlist | |
337 new : will empty the playlist and let you create a new playlist | |
338 | |
339 If you want to select/deselect files in the filrequester/playlist editor use | |
340 CTRL for files and SHIFT key for blocks of files. You can also browse the PL | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
341 using the cursor keys and enter to select song. Pressing the delete button |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
342 will remove the song from the playlist. If your mouse is equipped with a |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
343 mouse wheel, you can use this to scroll up and down. |
0 | 344 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
345 |
0 | 346 3.3. Equalizer |
347 -------------- | |
348 | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
349 To access the Equalizer, select the button labeled "EQ" on the right side |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
350 of the Audacious console. |
0 | 351 |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
352 That will bring up the Equalizer window. It looks like an equalizer on a |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
353 stereo and behaves like one as well. Press the button labeled ON to enable |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
354 the use of the equalizer, once you turned it on you use it as a normal |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
355 equalizer. |
0 | 356 |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
357 EQ presets will be saved in ~/.audacious/config when you close Audacious. You |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
358 can also have your own presets for different song using the "Preset" button, |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
359 Audacious can also import/export from Winamp's preset files. |
0 | 360 |
1174 | 361 If 'Auto' is enabled, Audacious will try to load equalizer presets like this: |
0 | 362 |
363 1: Look for a preset file in the directory of the file we are about to play. | |
364 2: Look for a directory preset file in the same directory. | |
365 3: Look for a preset saved with the "auto-load" feature. | |
366 4: Finally, try to load the "default" preset. | |
367 | |
368 The 'preset' button will open up a menu with the following options: | |
369 | |
370 Load | |
371 Preset : Will open a window with all available presets. | |
372 Auto-load preset : Will open a window with all available auto-load | |
373 presets. | |
374 Default : Will load the default preset. | |
375 Zero : Will reset the equalizer to zero. | |
376 From file : Will load from a .preset file | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
377 From Winamp EQF file : Will load from a Winamp equalizer file. If you |
0 | 378 choose a library file only the first entry will |
379 be loaded. | |
380 Import | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
381 Winamp presets : Imports the presets contained in an Winamp equalizer |
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
382 library file (often named Winamp.q1) and add all |
0 | 383 the entries to the Preset window. |
384 Save | |
385 Preset : Let you name the current preset and save it. | |
386 Auto-load preset : Saves the current settings as a preset for the song | |
387 currently playing. | |
388 Default : Saves the default value for the equalizer. | |
389 From file : Saves the current settings in a preset file. | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
390 From Winamp EQF file : Exports the current settings to a file readable by |
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
391 Winamp. |
0 | 392 Delete |
393 Preset : Let you delete a preset from the list. | |
394 Auto-load preset : Let you delete a auto-load preset from the list. | |
395 | |
396 Configure Equalizer : Change the default names of directory based | |
397 preset files. | |
398 | |
399 3.4. Menu | |
400 --------- | |
401 | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
402 There are several menu hot spots on the Audacious window. One place is at the |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
403 left hand side of the visual window described in sections 3.1 If you click |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
404 the right mouse button in the main window, the menus will also pop up (same |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
405 as clicking the button on the top left corner). |
0 | 406 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
407 |
0 | 408 3.5. Preferences |
409 ---------------- | |
410 | |
411 Use the menu to open Options / Preferences or press CTRL-P to bring the | |
412 preferences dialog up. | |
413 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
414 |
0 | 415 3.5.1. Appearance |
416 ----------------- | |
417 | |
418 Skins | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
419 In the skinlist you can choose a skin. How to install skins is described |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
420 above. Click on a skin in the list to change to it. |
0 | 421 |
422 Fonts | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
423 You can set the font in the main window by setting the 'Player' font. You |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
424 can change the playlist font by setting the 'Playlist' font. |
0 | 425 |
426 Miscellaneous | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
427 Show track numbers in playlist - Enable/disable displaying of track numbers |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
428 in the playlist. |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
429 Use custom cursors - Enable/disable custom cursors set by the |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
430 skin. |
0 | 431 |
432 | |
433 3.5.2. Mouse | |
434 ------------ | |
435 | |
436 Mouse wheel | |
1174 | 437 Change how Audacious handles scroll behaviours. |
0 | 438 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
439 |
0 | 440 3.5.3. Playlist |
441 --------------- | |
442 | |
443 Filename | |
444 Convert underscores to blanks - Converts '_' (underscores) to ' ' in the | |
445 playlist. | |
446 Convert %20 to blanks - Converts '%20' to ' ' in the | |
447 playlist. | |
448 | |
449 Metadata | |
450 Load metadata from playlists and files - Loads metadata from files and | |
451 playlists (e.g. ID3 tags). | |
452 | |
453 Playback | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
454 Don't advance in playlist - Don't advance to the next song in the playlist |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
455 when the current song ends. |
0 | 456 Pause between songs - Set the time (in secons) to pause on songchange |
457 | |
458 Song display | |
459 Title format - Choose the format to display the song names in the playlist. | |
460 Custom string - When the above option is set to 'Custom' insert a string of | |
461 substitutes here. | |
462 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
463 3.5.4. Plugins |
0 | 464 -------------- |
465 | |
466 Enable/disable and configure plugins in this section. | |
467 | |
468 Choose a tab to list one of the types of plugins: | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
469 - Decoders (filetype/device support) |
0 | 470 - General (general plugins) |
471 - Visualization (visualization plugins) | |
472 - Effects (effect plugins) | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
473 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
474 3.5.5. Audio |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
475 ------------ |
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
476 |
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
477 The settings in this section are related to the audio system. |
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
478 |
0 | 479 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
480 3.6. Plugins |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
481 ------------ |
0 | 482 |
2306 | 483 Plugins are what makes Audacious work, by moving most of the code out of |
484 Audacious and into a plugin architecture it's possible to change almost | |
485 everything in Audacious. There are today 8 different types of plugins. | |
0 | 486 |
2306 | 487 However to promote maximum flexibility of the platform itself, we no longer |
488 include any plugins with the Audacious core. | |
0 | 489 |
2306 | 490 You will need to download and install our plugin pack for Audacious if you |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
491 expect it to do anything useful (or install someone else's plugin pack if |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
492 one should exist). |
0 | 493 |
2306 | 494 Additionally, you can find a list of plugins at: |
495 http://audacious-media-player.org/Plugins | |
0 | 496 |
2306 | 497 You should note that third-party plugins are not supported by the Audacious |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
498 development team, and that you should report any issues with them on our |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
499 forums, but NEVER on our bugtracker. |
0 | 500 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
501 |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
502 3.7. Playlist Manager |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
503 --------------------- |
0 | 504 |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
505 Audacious supports multiple playlists (think foobar2000). For the manipulation |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
506 of playlists, we have included a playlist manager tool. |
0 | 507 |
2306 | 508 It is accessible from the Playlist menu. |
0 | 509 |
510 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
511 4. Obtaining Audacious |
0 | 512 ---------------------- |
513 | |
514 Currently, we only provide source tarballs at: | |
515 | |
1174 | 516 http://audacious-media-player.org/Downloads |
0 | 517 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
518 Audacious source is managed and also available via Atheme.org |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
519 Mercurial repository, refer to following web-page for information: |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
520 |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
521 http://audacious-media-player.org/index.php?title=Mercurial_Information |
0 | 522 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
523 You may also want to read file "Mercurial-Access". |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
524 |
0 | 525 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
526 4.1. Obtaining Skins |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
527 -------------------- |
0 | 528 |
1174 | 529 You can find Audacious/XMMS skins made by Audacious/XMMS users at: |
0 | 530 |
531 http://www.xmms.org/skins.html | |
532 http://themes.org/skins/xmms | |
533 | |
1174 | 534 You can find more places on our website, at: |
535 | |
536 http://audacious-media-player.org/Skins | |
537 | |
0 | 538 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
539 5. Bugs |
0 | 540 ------- |
541 | |
1174 | 542 Audacious is under heavy development and as such, has quite a number of |
0 | 543 bugs. Our bug tracker page is maintained at: |
544 | |
4372
8e8465e9e5c7
Fixed bugtracker URL, closes bugzilla #217.
Matti Hamalainen <ccr@tnsp.org>
parents:
4333
diff
changeset
|
545 http://bugzilla.atheme.org/ |
0 | 546 |
547 It will continue to have bugs as we fix and introduce new ones through | |
548 rewriting and enhancement. Help us along by reporting new bugs, and | |
549 verifying existing ones. | |
550 | |
551 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
552 6. Contact |
4373
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
553 ---------- |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
554 |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
555 Primarily any end-user type questions should be directed to the |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
556 Audacious web forums: |
0 | 557 |
4373
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
558 http://boards.nenolod.net/ |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
559 |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
560 There is also an IRC channel at irc.atheme.org #audacious. You should note |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
561 that this IRC presence is mainly for development issues and internal project |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
562 use, but that doesn't seem to stop 50-someodd people from visiting there. |
4373
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
563 |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
564 Project admins: |
0 | 565 |
2306 | 566 William Pitcock email: nenolod at sacredspiral.co.uk |
1174 | 567 Tony Vroon email: chainsaw at gentoo.org |