Mercurial > audlegacy
annotate README @ 4744:89891f400f98
Patch from Steve Cotton <steve0001@s.cotton.clara.co.uk> to resolve a
playlist bug where entry->tuple is NULL but we try to access it. This
results in huge log files, and resolves Debian bug #491655.
author | William Pitcock <nenolod@atheme.org> |
---|---|
date | Mon, 28 Jul 2008 11:34:39 -0500 |
parents | b42602020349 |
children |
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 |
4495
b42602020349
Officially state that we require GNU Make (which we did before, but didn't admit.)
Matti Hamalainen <ccr@tnsp.org>
parents:
4443
diff
changeset
|
81 GNU Make >= 3.80 |
b42602020349
Officially state that we require GNU Make (which we did before, but didn't admit.)
Matti Hamalainen <ccr@tnsp.org>
parents:
4443
diff
changeset
|
82 |
4331 | 83 If you compile Audacious from a fresh Mercurial checkout, you will also |
84 need the following tools: | |
85 | |
1427 | 86 autoconf >= 2.59 |
0 | 87 |
88 Note that these tools and libraries are bundled with major Linux | |
89 distributions. Use the packages provided with them where possible. If | |
90 those packages are not sufficiently new, you may need to search | |
91 third-party repositories for them. | |
92 | |
93 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
94 2.1. Basic Installation |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
95 ----------------------- |
0 | 96 |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
97 cd audacious-VERSION |
0 | 98 ./configure |
99 make | |
100 make install | |
101 | |
102 This will put the binary in /usr/local/bin and plugins in | |
1174 | 103 /usr/local/lib/audacious/ |
0 | 104 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
105 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
|
106 should use --enable-chardet. |
1427 | 107 |
0 | 108 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
109 2.2. Borderless Installation |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
110 ---------------------------- |
0 | 111 |
112 As far as I know most WM's accepts GTK decoration hints so it will | |
113 not have borders. But some WM's can't handle this so you have to | |
114 set in manually. | |
115 | |
116 AfterStep 1.0 ~/.steprc | |
117 Style "XMMS_Player" NoTitle, NoHandles | |
118 Style "XMMS_Playlist" NoTitle, NoHandles | |
119 Style "XMMS_Equalizer" NoTitle, NoHandles | |
120 | |
121 AfterStep 1.4 ~/GNUstep/Library/AfterStep/database | |
122 Style "XMMS_Player" NoTitle, NoHandles | |
123 Style "XMMS_Playlist" NoTitle, NoHandles | |
124 Style "XMMS_Equalizer" NoTitle, NoHandles | |
125 | |
126 Fvwm's ~/.fvwm95rc | |
127 Style "XMMS_Player" NoTitle | |
128 Style "XMMS_Playlist" NoTitle | |
129 Style "XMMS_Equalizer" NoTitle | |
130 | |
131 CTWM's ~/.ctwmrc | |
132 NoTitle and NoBorder sections: | |
133 NoTitle { | |
134 "xmms" | |
135 } | |
136 | |
137 NoBorder { | |
138 "xmms" | |
139 } | |
140 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
141 |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
142 2.3. Skin Installation |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
143 ---------------------- |
0 | 144 |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
145 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
|
146 You can unarchive the skins the same way as you do for Winamp. |
0 | 147 |
1174 | 148 However, you don't need to as Audacious supports archived skins. Audacious |
0 | 149 currently reads the following formats: zip, wsz, tar, tar.gz and |
150 tar.bz2 | |
151 | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
152 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
|
153 care of the rest. |
0 | 154 |
155 In order to support zipped skins you will need to have unzip. Unzip | |
156 is bundled with most Linux distributions. | |
157 | |
1174 | 158 Audacious looks for skins in these directories (in listing order): |
0 | 159 |
1174 | 160 <prefix>/share/audacious/Skins |
2685
fc3bb92994dd
[svn] XDG path fixes in documentation, submitted by nine on irc.atheme.org
chainsaw
parents:
2568
diff
changeset
|
161 ~/.local/share/audacious/Skins |
1174 | 162 ~/.audacious/Skins |
0 | 163 |
164 You can set the environment variable SKINSDIR to another location of | |
165 your choice: | |
166 | |
167 For BASH: | |
168 export SKINSDIR=/path/to/Skins:/more/paths/to/other/locations/of/Skins | |
169 | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
170 For C Shell: |
0 | 171 setenv SKINSDIR /path/to/Skins:/more/paths/to/other/locations/of/Skins |
172 | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
173 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
|
174 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
|
175 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
|
176 or emulated to properly support those skins. |
0 | 177 |
178 3. Documentation | |
179 ---------------- | |
180 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
181 This file or http://audacious-media-player.org/ |
0 | 182 |
183 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
184 3.1. Controlling Audacious |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
185 -------------------------- |
0 | 186 |
1174 | 187 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
|
188 Winamp. |
0 | 189 |
190 - On the top is the window title bar. To the right you will see 3 buttons, | |
1174 | 191 Left button will minimize Audacious. |
192 Middle button will make Audacious only display the title bar. | |
193 Right button will end the Audacious session. | |
0 | 194 |
195 - The area in the upper left part displays the following: | |
196 - Play state: Paused, Stopped, or Playing | |
197 - Time elapsed in the current song or if you click on it, the reversed. | |
198 - Spectrum analyzer of the sound being played. Right mouse click will | |
199 bring up the Visualization menu. Left mouse button will change the | |
200 analyzer to an oscilloscope and/or none. | |
201 | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
202 - 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
|
203 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
|
204 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
|
205 will bring up a new menu with some more options that are self explaining. |
0 | 206 |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
207 - 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
|
208 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
|
209 Left-clicking on these will open up menus or perform the listed actions. |
0 | 210 O : Options menu |
211 A : Always on top | |
212 I : File info box | |
213 D : Double size mode | |
214 V : Visualization menu | |
215 | |
216 - Underneath the track title are the following static informational data: | |
217 - bit rate in KBps (usually 128 or 112) | |
218 - Sample Rate in KHz (usually 44) | |
219 - Stereo or Mono channel mixing | |
220 | |
221 - Underneath the informational data are a few controls you can play with: | |
222 - The first slider controls the volume | |
223 - The second slider controls the balance between speakers | |
224 - The button marked "EQ" loads up the graphic equalizer | |
225 - 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
|
226 - 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
|
227 can drag this to jump to another location in the current file. |
0 | 228 |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
229 - 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
|
230 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
|
231 shuffle and repeat. |
0 | 232 |
233 - The eject button doesn't REALLY eject, of course. :) It opens up the | |
234 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
|
235 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
|
236 or load all mp3s in a directory. |
0 | 237 |
238 - The shuffle button randomizes the sequence of the playlist. | |
239 | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
240 - The repeat button when enabled makes the playlist loop when it reaches |
0 | 241 end of the playlist. |
242 | |
243 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
244 3.1.1. Key bindings |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
245 ------------------- |
0 | 246 |
247 Global: (Main, Equalizer and Playlist window) | |
248 | |
249 z = Previous song | |
250 x = Play | |
251 c = Pause | |
252 v = Stop | |
253 b = Next song | |
254 l = Play file (brings up the Load file(s) dialog) | |
255 j = Jump to file (in the existing playlist) | |
256 r = Toggle Repeat | |
257 s = Toggle Shuffle | |
258 | |
259 Control + h = Play location (url) | |
260 Control + p = Preferences dialog | |
261 Control + r = Time remaining | |
262 Control + o = Always on top | |
263 Control + w = Winshade mode | |
264 Control + j = Jump to time | |
265 Control + z = Start of list | |
266 Control + n = No Playlist Advance | |
267 Control + 3 = File info dialog | |
268 | |
269 Control + Alt + w = Toggle Equalizer winshade mode | |
270 Shift + Control + w = Toggle Playlist winshade mode | |
271 | |
272 Alt + e = Toggle playlist window | |
273 Alt + g = Toggle equalizer window | |
274 | |
275 Main window: | |
276 | |
277 Arrow key up = Volume up 2% | |
278 Arrow key down = Volume down 2% | |
279 Arrow key right = Skip 5 seconds forward in song | |
280 Arrow key left = Skip 5 seconds back in song | |
281 | |
282 Playlist window: | |
283 | |
284 Arrow key up = up one step in playlist | |
285 Arrow key down = Down one step in playlist | |
286 | |
287 Delete = Remove selected songs from playlist | |
288 Page Up = Move one page up | |
289 Page Down = Move one page down | |
290 Home = Go to the first song | |
291 End = Go to the last song | |
292 Enter = Play selected song | |
293 Insert = Add file dialog | |
294 Shift + Insert = Add directory dialog | |
295 Alt + Insert = Add url dialog | |
296 | |
297 Equalizer shade mode: | |
298 | |
299 Arrow key up = Volume up 2% | |
300 Arrow key down = Volume down 2% | |
301 Arrow key right = Balance 4% to right | |
302 Arrow key left = Balance 4% to left | |
303 | |
304 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
305 3.2. Playlist editor |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
306 -------------------- |
0 | 307 |
308 To access the Playlist editor, select the button labeled "PL" on the right | |
1174 | 309 side of the Audacious console. |
0 | 310 |
311 This will bring up the actual playlist window, here you'll find 5 buttons. | |
312 All of these buttons can be held down to bring up an extra menu. | |
313 From left to right: | |
314 | |
315 file + : will add a file to current playlist, held down mode you'll have | |
316 2 extra options | |
317 dir : will let you pick a directory (recursive) | |
318 url : will let you add an url for streaming | |
319 | |
320 file - : will delete the highlighted file, held down mode you'll have 3 | |
321 more options | |
322 crop : delete all files except the highlighted in the list | |
323 all : delete all files in the list | |
324 misc : *** NOT FUNCTIONAL *** | |
325 | |
326 sel all : select all files in current playlist, held down mode you'll have | |
327 2 extra options | |
328 sel zero : select none | |
329 inv sel : invert you selection | |
330 | |
331 misc opts : held down you'll have 2 extra options | |
332 fileinfo : opens the file info dialog. | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
333 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
|
334 options |
0 | 335 |
336 load list : will let you pick a playlist to load, held down you'll have | |
337 2 extra options | |
338 save : will let you save your playlist | |
339 new : will empty the playlist and let you create a new playlist | |
340 | |
341 If you want to select/deselect files in the filrequester/playlist editor use | |
342 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
|
343 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
|
344 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
|
345 mouse wheel, you can use this to scroll up and down. |
0 | 346 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
347 |
0 | 348 3.3. Equalizer |
349 -------------- | |
350 | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
351 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
|
352 of the Audacious console. |
0 | 353 |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
354 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
|
355 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
|
356 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
|
357 equalizer. |
0 | 358 |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
359 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
|
360 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
|
361 Audacious can also import/export from Winamp's preset files. |
0 | 362 |
1174 | 363 If 'Auto' is enabled, Audacious will try to load equalizer presets like this: |
0 | 364 |
365 1: Look for a preset file in the directory of the file we are about to play. | |
366 2: Look for a directory preset file in the same directory. | |
367 3: Look for a preset saved with the "auto-load" feature. | |
368 4: Finally, try to load the "default" preset. | |
369 | |
370 The 'preset' button will open up a menu with the following options: | |
371 | |
372 Load | |
373 Preset : Will open a window with all available presets. | |
374 Auto-load preset : Will open a window with all available auto-load | |
375 presets. | |
376 Default : Will load the default preset. | |
377 Zero : Will reset the equalizer to zero. | |
378 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
|
379 From Winamp EQF file : Will load from a Winamp equalizer file. If you |
0 | 380 choose a library file only the first entry will |
381 be loaded. | |
382 Import | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
383 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
|
384 library file (often named Winamp.q1) and add all |
0 | 385 the entries to the Preset window. |
386 Save | |
387 Preset : Let you name the current preset and save it. | |
388 Auto-load preset : Saves the current settings as a preset for the song | |
389 currently playing. | |
390 Default : Saves the default value for the equalizer. | |
391 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
|
392 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
|
393 Winamp. |
0 | 394 Delete |
395 Preset : Let you delete a preset from the list. | |
396 Auto-load preset : Let you delete a auto-load preset from the list. | |
397 | |
398 Configure Equalizer : Change the default names of directory based | |
399 preset files. | |
400 | |
401 3.4. Menu | |
402 --------- | |
403 | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
404 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
|
405 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
|
406 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
|
407 as clicking the button on the top left corner). |
0 | 408 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
409 |
0 | 410 3.5. Preferences |
411 ---------------- | |
412 | |
413 Use the menu to open Options / Preferences or press CTRL-P to bring the | |
414 preferences dialog up. | |
415 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
416 |
0 | 417 3.5.1. Appearance |
418 ----------------- | |
419 | |
420 Skins | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
421 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
|
422 above. Click on a skin in the list to change to it. |
0 | 423 |
424 Fonts | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
425 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
|
426 can change the playlist font by setting the 'Playlist' font. |
0 | 427 |
428 Miscellaneous | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
429 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
|
430 in the playlist. |
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
431 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
|
432 skin. |
0 | 433 |
434 | |
435 3.5.2. Mouse | |
436 ------------ | |
437 | |
438 Mouse wheel | |
1174 | 439 Change how Audacious handles scroll behaviours. |
0 | 440 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
441 |
0 | 442 3.5.3. Playlist |
443 --------------- | |
444 | |
445 Filename | |
446 Convert underscores to blanks - Converts '_' (underscores) to ' ' in the | |
447 playlist. | |
448 Convert %20 to blanks - Converts '%20' to ' ' in the | |
449 playlist. | |
450 | |
451 Metadata | |
452 Load metadata from playlists and files - Loads metadata from files and | |
453 playlists (e.g. ID3 tags). | |
454 | |
455 Playback | |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
456 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
|
457 when the current song ends. |
0 | 458 Pause between songs - Set the time (in secons) to pause on songchange |
459 | |
460 Song display | |
461 Title format - Choose the format to display the song names in the playlist. | |
462 Custom string - When the above option is set to 'Custom' insert a string of | |
463 substitutes here. | |
464 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
465 3.5.4. Plugins |
0 | 466 -------------- |
467 | |
468 Enable/disable and configure plugins in this section. | |
469 | |
470 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
|
471 - Decoders (filetype/device support) |
0 | 472 - General (general plugins) |
473 - Visualization (visualization plugins) | |
474 - Effects (effect plugins) | |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
475 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
476 3.5.5. Audio |
2310
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
477 ------------ |
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
478 |
9e0c93a99fcc
[svn] - some more updates, e.g. IRC channel/mailing list/forums
nenolod
parents:
2306
diff
changeset
|
479 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
|
480 |
0 | 481 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
482 3.6. Plugins |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
483 ------------ |
0 | 484 |
2306 | 485 Plugins are what makes Audacious work, by moving most of the code out of |
486 Audacious and into a plugin architecture it's possible to change almost | |
487 everything in Audacious. There are today 8 different types of plugins. | |
0 | 488 |
2306 | 489 However to promote maximum flexibility of the platform itself, we no longer |
490 include any plugins with the Audacious core. | |
0 | 491 |
2306 | 492 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
|
493 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
|
494 one should exist). |
0 | 495 |
2306 | 496 Additionally, you can find a list of plugins at: |
497 http://audacious-media-player.org/Plugins | |
0 | 498 |
2306 | 499 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
|
500 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
|
501 forums, but NEVER on our bugtracker. |
0 | 502 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
503 |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
504 3.7. Playlist Manager |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
505 --------------------- |
0 | 506 |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
507 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
|
508 of playlists, we have included a playlist manager tool. |
0 | 509 |
2306 | 510 It is accessible from the Playlist menu. |
0 | 511 |
512 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
513 4. Obtaining Audacious |
0 | 514 ---------------------- |
515 | |
516 Currently, we only provide source tarballs at: | |
517 | |
1174 | 518 http://audacious-media-player.org/Downloads |
0 | 519 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
520 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
|
521 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
|
522 |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
523 http://audacious-media-player.org/index.php?title=Mercurial_Information |
0 | 524 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
525 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
|
526 |
0 | 527 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
528 4.1. Obtaining Skins |
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
529 -------------------- |
0 | 530 |
1174 | 531 You can find Audacious/XMMS skins made by Audacious/XMMS users at: |
0 | 532 |
533 http://www.xmms.org/skins.html | |
534 http://themes.org/skins/xmms | |
535 | |
1174 | 536 You can find more places on our website, at: |
537 | |
538 http://audacious-media-player.org/Skins | |
539 | |
0 | 540 |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
541 5. Bugs |
0 | 542 ------- |
543 | |
1174 | 544 Audacious is under heavy development and as such, has quite a number of |
0 | 545 bugs. Our bug tracker page is maintained at: |
546 | |
4372
8e8465e9e5c7
Fixed bugtracker URL, closes bugzilla #217.
Matti Hamalainen <ccr@tnsp.org>
parents:
4333
diff
changeset
|
547 http://bugzilla.atheme.org/ |
0 | 548 |
549 It will continue to have bugs as we fix and introduce new ones through | |
550 rewriting and enhancement. Help us along by reporting new bugs, and | |
551 verifying existing ones. | |
552 | |
553 | |
4401
fdad21c61390
Documentation maintenance, removed sections that nobody has bothered to
Matti Hamalainen <ccr@tnsp.org>
parents:
4373
diff
changeset
|
554 6. Contact |
4373
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
555 ---------- |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
556 |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
557 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
|
558 Audacious web forums: |
0 | 559 |
4373
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
560 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
|
561 |
4427
714cb0cc602a
Fix README to fit 80 character width.
Matti Hamalainen <ccr@tnsp.org>
parents:
4401
diff
changeset
|
562 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
|
563 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
|
564 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
|
565 |
20c70e3a8272
Changed the wording of contact-section, recommending users to visit the
Matti Hamalainen <ccr@tnsp.org>
parents:
4372
diff
changeset
|
566 Project admins: |
0 | 567 |
2306 | 568 William Pitcock email: nenolod at sacredspiral.co.uk |
1174 | 569 Tony Vroon email: chainsaw at gentoo.org |