![[Documentation]](graphics/_Documentation.gif)
This version is considered an -BETA- release. This means it may not be stable. You have been warned. We are not liable for any damage caused by the use of this program.
x11amp is NOT a port of windows95's winamp. We just borrowed the GUI! :)
These libraries are needed to compile x11amp!!
gtk/glib 1.2.0 or better.
get it here: ftp://ftp.gtk.org/pub/gtk/v1.2/
For you libc5 users you'll need these extra things.
gnu gettext 0.10 (use configure --with-gnu-gettext)
get it here: ftp://prep.ai.mit.edu/pub/gnu/gettext/gettext-0.10.tar.gz
linuxthreads 0.71
get it here: http://www.x11amp.bz.nu/files/linuxthreads.tar.gz
Thread safe Xlibs (atleast aware) get thread aware libs here: Thread Aware Xlibs
cd x11ampsource
./configure
make
make install
This will put the binary in /usr/local/bin and in/outplugins in
/usr/local/share/x11amp/
x11amp will hopefully load grin
As far as I know most WM's accepts GTK decoration hints so it will not have borders. But some WM's can't handle this so you have to set in manually. do this for x11amp just add this:
Afterstep 1.0 ~/.steprc
Style "x11amp" Icon x11amp.xpm, NoTitle, NoHandles
Afterstep 1.4 ~/GNUstep/Library/AfterStep/database Style "x11amp" Icon x11amp.xpm, NoTitle, NoHandles
Fvwm's ~/.fvwm95rc
Style "x11amp" NoTitle
The poblem here is that all GTK windows will also be borderless :(
x11amp will create a drawer called ~/.x11amp/Skins/ in which you just unarchive the skins the same way as you do for winamp.
Or don't unarchive them, x11amp supports zipped skins..
just copy the skin.zip to a Skin path and boom of you go!
note: you will need unzip to get this to work!
If you don't keep unzip in your path then you can set a variable called UNZIPCMD to the right path.
Use ALT+S when using x11amp to bring up the skin selector. X11Amp will remeber which skin you had loaded when you start X11Amp the next time. (saved in ~/.x11amp/config)
You can also have global skins in /usr/local/share/x11amp/Skins or /usr/share/x11amp/Skins if you are not happy with this just set the SKINSDIR variable to another location of your choice eg.
for bash:
export SKINSDIR=/path/to/Skins:/more/paths/to/other/locations/of/Skins
for csh:
setenv SKINSDIR=/path/to/Skins:/more/paths/to/other/locations/of/Skins
good idea here is SKINSDIR=/dos/programs/winamp/skins if you have windows
and winamp with skins installed :)
This file or http://www.x11amp.bz.nu/doc.html
When you start up X11Amp, you will get a console very similar to that of WinAMP.
To access the Playlist editor, select the button labeled "PL" on the right side of the X11Amp console.
This will bring up the actual playlist window, here you'll find 5 buttons.
All of these buttons can be held down to bring up an extra menu.
From left to right:
+ url : will let you add an url for streaming + dir : will let you pick a directory (recursive) + file : will add a file to current playlist, held down mode you'll have 2 extra options
- misc : *** NOT FUNCTIONAL *** - all : delete all files in the list - crop : delete all files exept the highlighted in the list - file : will delete the highlighted file, held down mode you'll have 3 more options
inv sel : invert your selection sel zero : select none sel all : select all files in current playlist, held down mode you'll have 2 extra options
sort : release button on this will bring up another menu with sort options file inf : as it say, fileinfo :P misc opts : held down you'll have 2 extra options
new list : will empty the playlist and let you create a new playlist save list : will let you save your playlist load list : will let you pick a playlist to load, held down you'll have 2 extra options
Just like in windows, if you want to select/deselect files in the filrequester/playlisteditor use CTRL for files and SHIFT key for blocks of files.
You can also specify files in the command line e.g ./x11amp file1.mp3 file2.mp3 file3.mp3 or wildcard ./x11amp *.mp3 or ./x11amp playlist.m3u Just add the prefix .m3u to your existing playlists and x11amp will load them from command line as a parameter!
If you do this while X11Amp is running, it will remove the current selection of mp3 files and play the one(s) from the command line. This is useful if you are using Midnight Commander like I do :) altho if you use x11amp with -e option it will not clear the playlist just add that song to the existing playlist!
To access the Equalizer, select the button labeled "EQ" on the right side of the X11Amp console.
That will bring up the Equalizer window. it looks like an equlizer on a stereo and behaves like one as well. Press the button labeld ON to enable the use of the equalizer, once you turned it on you use it as a normal equalizer. EQ presets will be saved in ~/.x11amp/config when you close x11amp.
x11amp --help will produce:
Usage: x11amp [options] [files] ...
-h, --help Display this text and exit. -n, --session Select X11Amp session (Default: 0) -r, --rew Skip backwards in playlist -p, --play Start playing current playlist -u, --pause Pause current song -s, --stop Stop current song -f, --fwd Skip forward in playlist -e, --enqueue Add file to current playlist -v, --version Print version number and exit.
Seeking in files
Volume/Balance
Shuffle play
Repeat play
Timer Elapsed/Timer Remaining
Plug-in system
Double Size option
GTK Requesters (with themesupport)
Autoremove borders if the WM has support for it
Wildcard select from commandline
Playlist editor
Equalizer
Spectrum Analyzer
Oscilliscope
Skins (The same skins as winamp)
Streaming (shoutcast)
Wharf (afterstep) version!
YOU tell us
How do I get it?
Get the latest version from the web http://www.x11amp.bz.nu or FTP ftp://ftp.x11amp.org/x11amp/
Want some skins made by linux users? goto http://www.x11amp.bz.nu/skins.html
To make netscape use x11amp on http://www.shoutcast.com you just have to load up
netscape and choose edit/preferences/Navigator/applications add a new handler
set mimetype: audio/x-scpls
set application: x11amp %s
hit the OK button and off you go!
X11Amp features some command line options like next/prevoius songs, those things can be binded to a key. I use Afterstep and the useless window keys for this. Here is an exampel from my .steprc:
Key Meta_R A N Exec "x11amp" x11amp -r Key Menu A N Exec "x11amp" x11amp -f
If you want all your mp3's in one playlist an easy way is: locate .mp3 > /path/to/playlistname
( considering you have a fairly recent updatedb, dont blame us if locate dont finds the file you downloaded 3 minutes ago :P )
I like to have my playlists in a special path (in my case /usr/local/share/x11amp/playlists/) and I really hate browsing to that dir with the playlistbrowser so I start x11amp like this. make a bash script file looking like this:
/usr/local/bin/x11amp
else
/usr/local/bin/x11amp "$1"
fi
Bugs are usual.. otherwise something is wrong and you better report it as a bug!
Programming Mikael Alm (psy@x11amp.bz.nu) Graphics Thomas Nilsson (fatal@x11amp.bz.nu) Everything else Olle Hallnas (crocodile@x11amp.bz.nu)