Mercurial > audlegacy
annotate README @ 4391:a9c8efbfd4c2
s/BMP_PLUGIN_H/AUD_PLUGIN_H/
author | Matti Hamalainen <ccr@tnsp.org> |
---|---|
date | Sun, 30 Mar 2008 00:51:14 +0200 |
parents | 20c70e3a8272 |
children | fdad21c61390 |
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 | |
17 NOTE: This document is hardly maintained. Please check the Users' Guide on | |
1174 | 18 the Audacious website. |
0 | 19 |
20 | |
21 TABLE OF CONTENTS | |
22 ***************** | |
23 | |
24 1. Disclaimer | |
25 2. Installation | |
26 2.1 Basic Installation | |
27 2.2 Border less Installation | |
28 2.3 Skin Installation | |
29 3. Documentation | |
1174 | 30 3.1 Controlling Audacious |
0 | 31 3.1.1 Key bindings |
32 3.2 Playlist Editor | |
33 3.3 Equalizer | |
34 3.4 Menu | |
35 3.5 Preferences | |
36 3.5.1 Audio I/O Plugins | |
37 3.5.2 Effect/General Plugins | |
38 3.5.3 Visualization Plugins | |
39 3.5.4 Options | |
40 3.5.5 Fonts | |
41 3.5.6 Title | |
42 3.6 Plugins | |
2306 | 43 3.7 Playlist Manager |
0 | 44 4. Command Line Options |
45 5. Features | |
2566 | 46 5.1 Supported Features |
1174 | 47 6. Obtaining Audacious |
0 | 48 7. Misc |
49 7.1 Shoutcast support | |
50 7.2 Tips and tricks | |
51 8. Bugs | |
4373
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
52 9. Contact |
0 | 53 |
54 | |
55 | |
56 | |
57 1. Disclaimer | |
58 ------------- | |
59 | |
60 We are not liable for any damage caused by the use of this program. | |
61 | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
62 Audacious is NOT a port of Winamp (http://www.Winamp.com). Audacious is a fork of |
1174 | 63 XMMS (http://xmms.org) and BMP (http://beep-media-player.org) which borrowed the |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
64 Winamp GUI. |
0 | 65 |
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
|
66 However, Audacious is neither XMMS, or BMP, but takes a direction of its |
7f0996dc0c43
Updated copyright year and added a note about Audacious not being XMMS nor BMP.
Matti Hamalainen <ccr@tnsp.org>
parents:
4331
diff
changeset
|
67 own. |
7f0996dc0c43
Updated copyright year and added a note about Audacious not being XMMS nor BMP.
Matti Hamalainen <ccr@tnsp.org>
parents:
4331
diff
changeset
|
68 |
0 | 69 |
70 2. Installation | |
71 --------------- | |
72 | |
1174 | 73 Audacious requires the following libraries and their development |
0 | 74 packages installed: |
75 | |
4333 | 76 Glib 2.14.0 |
4331 | 77 http://www.gtk.org/download/ |
0 | 78 |
4333 | 79 GTK+ 2.10.0 |
4331 | 80 http://www.gtk.org/download/ |
0 | 81 |
2568 | 82 mcs >= 0.1 |
4331 | 83 http://www.atheme.org/projects/mcs.shtml |
2568 | 84 |
4331 | 85 libmowgli >= 0.4 |
86 http://www.atheme.org/projects/mowgli.shtml | |
0 | 87 |
4331 | 88 If you compile Audacious from a fresh Mercurial checkout, you will also |
89 need the following tools: | |
90 | |
1427 | 91 autoconf >= 2.59 |
0 | 92 |
93 Note that these tools and libraries are bundled with major Linux | |
94 distributions. Use the packages provided with them where possible. If | |
95 those packages are not sufficiently new, you may need to search | |
96 third-party repositories for them. | |
97 | |
98 | |
99 2.1 Basic Installation | |
100 ---------------------- | |
101 | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
102 cd audacious-VERSION |
0 | 103 ./configure |
104 make | |
105 make install | |
106 | |
107 This will put the binary in /usr/local/bin and plugins in | |
1174 | 108 /usr/local/lib/audacious/ |
0 | 109 |
1427 | 110 If you want to use the automatic character detection system, then you should |
111 use --enable-chardet. | |
112 | |
0 | 113 |
114 2.2 Borderless Installation | |
115 --------------------------- | |
116 | |
117 As far as I know most WM's accepts GTK decoration hints so it will | |
118 not have borders. But some WM's can't handle this so you have to | |
119 set in manually. | |
120 | |
121 AfterStep 1.0 ~/.steprc | |
122 Style "XMMS_Player" NoTitle, NoHandles | |
123 Style "XMMS_Playlist" NoTitle, NoHandles | |
124 Style "XMMS_Equalizer" NoTitle, NoHandles | |
125 | |
126 AfterStep 1.4 ~/GNUstep/Library/AfterStep/database | |
127 Style "XMMS_Player" NoTitle, NoHandles | |
128 Style "XMMS_Playlist" NoTitle, NoHandles | |
129 Style "XMMS_Equalizer" NoTitle, NoHandles | |
130 | |
131 Fvwm's ~/.fvwm95rc | |
132 Style "XMMS_Player" NoTitle | |
133 Style "XMMS_Playlist" NoTitle | |
134 Style "XMMS_Equalizer" NoTitle | |
135 | |
136 CTWM's ~/.ctwmrc | |
137 NoTitle and NoBorder sections: | |
138 NoTitle { | |
139 "xmms" | |
140 } | |
141 | |
142 NoBorder { | |
143 "xmms" | |
144 } | |
145 | |
146 2.3 Skin Installation | |
147 --------------------- | |
148 | |
2685
fc3bb92994dd
[svn] XDG path fixes in documentation, submitted by nine on irc.atheme.org
chainsaw
parents:
2568
diff
changeset
|
149 Audacious will create a directory called ~/.local/share/audacious/Skins. You can unarchive |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
150 the skins the same way as you do for Winamp. |
0 | 151 |
1174 | 152 However, you don't need to as Audacious supports archived skins. Audacious |
0 | 153 currently reads the following formats: zip, wsz, tar, tar.gz and |
154 tar.bz2 | |
155 | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
156 Just copy the archive to one of the skin paths and Audacious will take care |
0 | 157 of the rest. |
158 | |
159 In order to support zipped skins you will need to have unzip. Unzip | |
160 is bundled with most Linux distributions. | |
161 | |
1174 | 162 Audacious looks for skins in these directories (in listing order): |
0 | 163 |
1174 | 164 <prefix>/share/audacious/Skins |
2685
fc3bb92994dd
[svn] XDG path fixes in documentation, submitted by nine on irc.atheme.org
chainsaw
parents:
2568
diff
changeset
|
165 ~/.local/share/audacious/Skins |
1174 | 166 ~/.audacious/Skins |
0 | 167 |
168 You can set the environment variable SKINSDIR to another location of | |
169 your choice: | |
170 | |
171 For BASH: | |
172 export SKINSDIR=/path/to/Skins:/more/paths/to/other/locations/of/Skins | |
173 | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
174 For C Shell: |
0 | 175 setenv SKINSDIR /path/to/Skins:/more/paths/to/other/locations/of/Skins |
176 | |
2311
8216ff3deb90
[svn] - note that WAL (winamp "modern") skins are not supported
nenolod
parents:
2310
diff
changeset
|
177 You should note that skins designed specifically for Audacious are not compatible |
8216ff3deb90
[svn] - note that WAL (winamp "modern") skins are not supported
nenolod
parents:
2310
diff
changeset
|
178 with Winamp. Likewise, we do not support Winamp "modern" skins as there is a lot of |
8216ff3deb90
[svn] - note that WAL (winamp "modern") skins are not supported
nenolod
parents:
2310
diff
changeset
|
179 Winamp-specifics that would have to be reverse-engineered or emulated to properly |
8216ff3deb90
[svn] - note that WAL (winamp "modern") skins are not supported
nenolod
parents:
2310
diff
changeset
|
180 support those skins. |
0 | 181 |
182 3. Documentation | |
183 ---------------- | |
184 | |
1174 | 185 This file or http://audacious-media-player.org |
0 | 186 |
187 | |
1174 | 188 3.1 Controlling Audacious |
0 | 189 -------------------- |
190 | |
1174 | 191 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
|
192 Winamp. |
0 | 193 |
194 - On the top is the window title bar. To the right you will see 3 buttons, | |
1174 | 195 Left button will minimize Audacious. |
196 Middle button will make Audacious only display the title bar. | |
197 Right button will end the Audacious session. | |
0 | 198 |
199 - The area in the upper left part displays the following: | |
200 - Play state: Paused, Stopped, or Playing | |
201 - Time elapsed in the current song or if you click on it, the reversed. | |
202 - Spectrum analyzer of the sound being played. Right mouse click will | |
203 bring up the Visualization menu. Left mouse button will change the | |
204 analyzer to an oscilloscope and/or none. | |
205 | |
206 - To the right of the Spectrum analyzer is the title of the file being played. | |
207 This also contains the length of the song being played, as well as its | |
208 position in the [unsorted] playlist. Right clicking in this window will bring | |
209 up a new menu with some more options that are self explaining. | |
210 | |
211 - In the left part of the Spectrum analyzer you'll have letters (at least if | |
212 you use the default skin) O A I D V. This is known as the | |
213 "clutterbar'. Left-clicking on these will open up menus or perform the | |
214 listed actions. | |
215 O : Options menu | |
216 A : Always on top | |
217 I : File info box | |
218 D : Double size mode | |
219 V : Visualization menu | |
220 | |
221 - Underneath the track title are the following static informational data: | |
222 - bit rate in KBps (usually 128 or 112) | |
223 - Sample Rate in KHz (usually 44) | |
224 - Stereo or Mono channel mixing | |
225 | |
226 - Underneath the informational data are a few controls you can play with: | |
227 - The first slider controls the volume | |
228 - The second slider controls the balance between speakers | |
229 - The button marked "EQ" loads up the graphic equalizer | |
230 - The button marked "PL" loads up the playlist editor | |
231 - The LARGE slide bar moves from left to right as the song plays. You can | |
232 drag this to jump to another location in the current file. | |
233 | |
234 - On the bottom of the console are the standard buttons you would see on a CD | |
235 player: Previous track, Play, Pause, Stop, Next track, eject, shuffle | |
236 and repeat. | |
237 | |
238 - The eject button doesn't REALLY eject, of course. :) It opens up the | |
239 file requester. The File Requester builds a playlist for the current | |
1174 | 240 Audacious session. You can use it to load files, add files to the list, or |
0 | 241 load all mp3s in a directory. |
242 | |
243 - The shuffle button randomizes the sequence of the playlist. | |
244 | |
245 - The repeat button when enabled makes the playlist loop when it reaches the | |
246 end of the playlist. | |
247 | |
248 | |
249 3.1.1 Key bindings | |
250 ------------------ | |
251 | |
252 Global: (Main, Equalizer and Playlist window) | |
253 | |
254 z = Previous song | |
255 x = Play | |
256 c = Pause | |
257 v = Stop | |
258 b = Next song | |
259 l = Play file (brings up the Load file(s) dialog) | |
260 j = Jump to file (in the existing playlist) | |
261 r = Toggle Repeat | |
262 s = Toggle Shuffle | |
263 | |
264 Control + h = Play location (url) | |
265 Control + p = Preferences dialog | |
266 Control + r = Time remaining | |
267 Control + o = Always on top | |
268 Control + w = Winshade mode | |
269 Control + j = Jump to time | |
270 Control + z = Start of list | |
271 Control + n = No Playlist Advance | |
272 Control + 3 = File info dialog | |
273 | |
274 Control + Alt + w = Toggle Equalizer winshade mode | |
275 Shift + Control + w = Toggle Playlist winshade mode | |
276 | |
277 Alt + e = Toggle playlist window | |
278 Alt + g = Toggle equalizer window | |
279 | |
280 Main window: | |
281 | |
282 Arrow key up = Volume up 2% | |
283 Arrow key down = Volume down 2% | |
284 Arrow key right = Skip 5 seconds forward in song | |
285 Arrow key left = Skip 5 seconds back in song | |
286 | |
287 Playlist window: | |
288 | |
289 Arrow key up = up one step in playlist | |
290 Arrow key down = Down one step in playlist | |
291 | |
292 Delete = Remove selected songs from playlist | |
293 Page Up = Move one page up | |
294 Page Down = Move one page down | |
295 Home = Go to the first song | |
296 End = Go to the last song | |
297 Enter = Play selected song | |
298 Insert = Add file dialog | |
299 Shift + Insert = Add directory dialog | |
300 Alt + Insert = Add url dialog | |
301 | |
302 Equalizer shade mode: | |
303 | |
304 Arrow key up = Volume up 2% | |
305 Arrow key down = Volume down 2% | |
306 Arrow key right = Balance 4% to right | |
307 Arrow key left = Balance 4% to left | |
308 | |
309 | |
310 3.2 Playlist editor | |
311 ------------------- | |
312 | |
313 To access the Playlist editor, select the button labeled "PL" on the right | |
1174 | 314 side of the Audacious console. |
0 | 315 |
316 This will bring up the actual playlist window, here you'll find 5 buttons. | |
317 All of these buttons can be held down to bring up an extra menu. | |
318 From left to right: | |
319 | |
320 file + : will add a file to current playlist, held down mode you'll have | |
321 2 extra options | |
322 dir : will let you pick a directory (recursive) | |
323 url : will let you add an url for streaming | |
324 | |
325 file - : will delete the highlighted file, held down mode you'll have 3 | |
326 more options | |
327 crop : delete all files except the highlighted in the list | |
328 all : delete all files in the list | |
329 misc : *** NOT FUNCTIONAL *** | |
330 | |
331 sel all : select all files in current playlist, held down mode you'll have | |
332 2 extra options | |
333 sel zero : select none | |
334 inv sel : invert you selection | |
335 | |
336 misc opts : held down you'll have 2 extra options | |
337 fileinfo : opens the file info dialog. | |
338 sort : release button on this will bring up another menu with sort options | |
339 | |
340 load list : will let you pick a playlist to load, held down you'll have | |
341 2 extra options | |
342 save : will let you save your playlist | |
343 new : will empty the playlist and let you create a new playlist | |
344 | |
345 If you want to select/deselect files in the filrequester/playlist editor use | |
346 CTRL for files and SHIFT key for blocks of files. You can also browse the PL | |
347 using the cursor keys and enter to select song. Pressing the delete button will | |
348 remove the song from the playlist. If your mouse is equipped with a mouse | |
349 wheel, you can use this to scroll up and down. | |
350 | |
351 3.3. Equalizer | |
352 -------------- | |
353 | |
354 To access the Equalizer, select the button labeled "EQ" on the right | |
1174 | 355 side of the Audacious console. |
0 | 356 |
357 That will bring up the Equalizer window. It looks like an equalizer on a stereo | |
358 and behaves like one as well. Press the button labeled ON to enable the use of | |
359 the equalizer, once you turned it on you use it as a normal equalizer. | |
360 | |
1174 | 361 EQ presets will be saved in ~/.audacious/config when you close Audacious. You can also |
362 have your own presets for different song using the "Preset" button, Audacious can | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
363 also import/export from Winamp's preset files. |
0 | 364 |
1174 | 365 If 'Auto' is enabled, Audacious will try to load equalizer presets like this: |
0 | 366 |
367 1: Look for a preset file in the directory of the file we are about to play. | |
368 2: Look for a directory preset file in the same directory. | |
369 3: Look for a preset saved with the "auto-load" feature. | |
370 4: Finally, try to load the "default" preset. | |
371 | |
372 The 'preset' button will open up a menu with the following options: | |
373 | |
374 Load | |
375 Preset : Will open a window with all available presets. | |
376 Auto-load preset : Will open a window with all available auto-load | |
377 presets. | |
378 Default : Will load the default preset. | |
379 Zero : Will reset the equalizer to zero. | |
380 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
|
381 From Winamp EQF file : Will load from a Winamp equalizer file. If you |
0 | 382 choose a library file only the first entry will |
383 be loaded. | |
384 Import | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
385 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
|
386 library file (often named Winamp.q1) and add all |
0 | 387 the entries to the Preset window. |
388 Save | |
389 Preset : Let you name the current preset and save it. | |
390 Auto-load preset : Saves the current settings as a preset for the song | |
391 currently playing. | |
392 Default : Saves the default value for the equalizer. | |
393 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
|
394 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
|
395 Winamp. |
0 | 396 Delete |
397 Preset : Let you delete a preset from the list. | |
398 Auto-load preset : Let you delete a auto-load preset from the list. | |
399 | |
400 Configure Equalizer : Change the default names of directory based | |
401 preset files. | |
402 | |
403 3.4. Menu | |
404 --------- | |
405 | |
1174 | 406 There are several menu hot spots on the Audacious window. One place is at the left |
0 | 407 hand side of the visual window described in sections 3.1 If you click the right |
408 mouse button in the main window, the menus will also pop up (same as clicking | |
409 the button on the top left corner). | |
410 | |
411 3.5. Preferences | |
412 ---------------- | |
413 | |
414 Use the menu to open Options / Preferences or press CTRL-P to bring the | |
415 preferences dialog up. | |
416 | |
417 3.5.1. Appearance | |
418 ----------------- | |
419 | |
420 Skins | |
421 In the skinlist you can choose a skin. How to install skins is described above. | |
422 Click on a skin in the list to change to it. | |
423 | |
424 Fonts | |
425 You can set the font in the main window by setting the 'Player' font. You can | |
426 change the playlist font by setting the 'Playlist' font. | |
427 | |
428 Miscellaneous | |
429 Show track numbers in playlist - Enable/disable displaying of track numbers in | |
430 the playlist. | |
431 Use custom cursors - Enable/disable custom cursors set by the skin. | |
432 | |
433 | |
434 3.5.2. Mouse | |
435 ------------ | |
436 | |
437 Mouse wheel | |
1174 | 438 Change how Audacious handles scroll behaviours. |
0 | 439 |
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 | |
454 Don't advance in playlist - Don't advance to the next song in the playlist when | |
455 the current song ends. | |
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 | |
463 3.5.6. Plugins | |
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 |
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
474 3.5.7. Audio |
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 |
480 3.6 Plugins | |
481 ----------- | |
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 |
491 expect it to do anything useful (or install someone else's plugin pack if one | |
492 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 |
498 development team, and that you should report any issues with them on our forums, | |
499 but NEVER on our bugtracker. | |
0 | 500 |
2306 | 501 3.7 Playlist Manager |
502 -------------------- | |
0 | 503 |
2306 | 504 Audacious supports multiple playlists (think foobar2000). For the manipulation of |
505 playlists, we have included a playlist manager tool. | |
0 | 506 |
2306 | 507 It is accessible from the Playlist menu. |
0 | 508 |
509 | |
510 4. Command Line Options | |
511 ----------------------- | |
512 | |
2306 | 513 audacious --help will produce: |
0 | 514 |
2306 | 515 Usage: audacious [options] [files] ... |
0 | 516 |
517 Options: | |
518 -------- | |
519 | |
520 -h, --help Display this text and exit. | |
1174 | 521 -n, --session Select Audacious/XMMS session (Default: 0) |
0 | 522 -r, --rew Skip backwards in playlist |
523 -p, --play Start playing current playlist | |
524 -u, --pause Pause current song | |
525 -s, --stop Stop current song | |
526 -t, --play-pause Pause if playing, play otherwise | |
527 -f, --fwd Skip forward in playlist | |
528 -e, --enqueue Don't clear the playlist | |
529 -m, --show-main-window Show the main window | |
530 -v, --version Print version number and exit. | |
2306 | 531 -H, --headless Headless operation |
532 -E, --enqueue-to-temp Enqueues to a temporary playlist. | |
0 | 533 |
534 You can specify files on the command line, e.g: | |
535 | |
2306 | 536 audacious file1.mp3 file2.mp3 file3.mp3 |
537 audacious *.mp3 | |
538 audacious playlist.m3u playlist.pls playlist.xspf | |
0 | 539 |
2306 | 540 If you do this while Audacious is running, the current playlist |
0 | 541 will be cleared and the files/playlist specified on the command |
542 line will be used instead. | |
543 | |
2306 | 544 To keep the current playlist intact use the -E option, which will |
545 create a new temporary playlist with the requested media, or the | |
546 -e option, which will append to your currently selected playlist. | |
0 | 547 |
548 | |
549 5. Features | |
550 ----------- | |
551 | |
2306 | 552 5.1 Supported Features |
0 | 553 ---------------------- |
554 | |
555 Seeking in files | |
556 Volume/Balance | |
557 Shuffle play | |
558 Repeat play | |
559 Playlist editor | |
560 Spectrum Analyzer | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
561 One Line mode al'a WinShade in Winamp |
0 | 562 Oscilloscope |
563 Timer Elapsed/Timer Remaining | |
564 Plug-in system Output/Input/Effect/General/Visualization | |
565 Equalizer | |
566 Double Size option | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
567 Winamp 2.0 skin support (can use wsz files) |
0 | 568 GTK Requesters (with theme support) |
569 Streaming/Shoutcast(1.0/1.1)/Icecast support | |
570 Auto remove borders if the WM has support for it | |
571 Fast jump in playlist | |
572 Scroll wheel support | |
573 Saves HTTP streams to HD | |
574 HTTP authentication | |
575 Plays MPEG layer 1/2/3, WAV, Ogg Vorbis | |
576 Compiles and works on other Unixes | |
577 Proxy authentication support | |
578 | |
579 | |
1174 | 580 6. Obtaining Audacious |
0 | 581 ------------------- |
582 | |
583 Currently, we only provide source tarballs at: | |
584 | |
1174 | 585 http://audacious-media-player.org/Downloads |
0 | 586 |
1174 | 587 The Subversion snapshots listed are not regularly updated. We |
588 encourage you to download Audacious straight from our SVN repository: | |
0 | 589 |
1174 | 590 svn co http://svn.atheme.org/audacious/trunk audacious-devel |
591 | |
0 | 592 |
593 6.1 Obtaining Skins | |
594 ------------------- | |
595 | |
1174 | 596 You can find Audacious/XMMS skins made by Audacious/XMMS users at: |
0 | 597 |
598 http://www.xmms.org/skins.html | |
599 http://themes.org/skins/xmms | |
600 | |
1174 | 601 You can find more places on our website, at: |
602 | |
603 http://audacious-media-player.org/Skins | |
604 | |
0 | 605 |
606 7. Misc | |
607 ------- | |
608 | |
609 7.1. Tips and Tricks | |
610 ------------------- | |
611 | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
612 If you have a windows partition with Winamp installed, a good idea would be to |
0 | 613 set the SKINSDIR variable to that dir. |
614 | |
1174 | 615 Audacious features some command line options like next/previous songs, those |
0 | 616 things can be binded to a key. I use AfterStep and the useless window keys |
617 for this. Here is an example from my .steprc: | |
618 | |
1174 | 619 Key Meta_R A N Exec "Audacious" audacious -r |
620 Key Menu A N Exec "Audacious" audacious -f | |
0 | 621 |
622 If you want all your mp3's in one playlist an easy way is: | |
623 locate .mp3 > /path/to/playlistname | |
624 | |
625 (considering you have a fairly recent updatedb, don't blame us if locate don't | |
626 find the file you downloaded 3 minutes ago) | |
627 | |
628 | |
629 8. Bugs | |
630 ------- | |
631 | |
1174 | 632 Audacious is under heavy development and as such, has quite a number of |
0 | 633 bugs. Our bug tracker page is maintained at: |
634 | |
4372
8e8465e9e5c7
Fixed bugtracker URL, closes bugzilla #217.
Matti Hamalainen <ccr@tnsp.org>
parents:
4333
diff
changeset
|
635 http://bugzilla.atheme.org/ |
0 | 636 |
637 It will continue to have bugs as we fix and introduce new ones through | |
638 rewriting and enhancement. Help us along by reporting new bugs, and | |
639 verifying existing ones. | |
640 | |
641 | |
4373
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
642 9. Contact |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
643 ---------- |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
644 |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
645 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
|
646 Audacious web forums: |
0 | 647 |
4373
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
648 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
|
649 |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
650 There is also an IRC channel at irc.atheme.org #audacious. You should |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
651 note that this IRC presence is mainly for development issues and |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
652 internal project use, but that doesn't seem to stop 50-someodd people |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
653 from visiting there. |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
654 |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
655 Project admins: |
0 | 656 |
2306 | 657 William Pitcock email: nenolod at sacredspiral.co.uk |
1174 | 658 Tony Vroon email: chainsaw at gentoo.org |