readme

xmms-1.2.10.tar.gz学习使用的就下吧

Example: tone://2000

will play a 2000Hz tone.

Example: tone://2000;2005

will play a 2000Hz tone and a 2005Hz tone at the same time. Notice the 5Hz
beats between the two tones.

The use of this baffles me, but at least I can use it to annoy my neighbors
dog.


3.6.1.5 Ogg Vorbis Player
-------------------------

Plays OGG Vorbis encoded files, see http://www.xiph.org/ogg/vorbis/
for more information.


3.6.1.6 Wave player
-------------------
This plugin plays as suggested, wave files. It supports 16bit and 8bit PCM wave
files.


3.6.2 Output plugins
--------------------
This type of plugins is what is used to send the audio data to your soundcard
or alternative devices.


3.6.2.1 OSS Driver
------------------
This plugin is probably what most of you will use if your system is equipped
with the OpenSoundSystem (www.opensound.com) drivers or compatible.
Compatible drivers are ALSA with their OSS emulation, and Linux kernel sound
drivers.

In the 'Devices' tab you can change the soundcard which XMMS is going to use.
If your driver have more than one dsp, you can change the one XMMS uses by
enabling 'Use alternate device' and changing the '/dev/dsp' to suit your needs.

If you have changed your Audio Device to another soundcard (if you for some
reason have two cards) don't forget to change the 'Mixer device' setting to the
soundcard you want to use.

In the 'Buffering' tab you can change how much data the OSS plugin will buffer.
The 'Buffer size' ranges from 200 - 10000ms. If you want the plugin to wait for
the buffer to be filled before it starts playing the music change the 'Pre-
buffer' value, this ranges from 0% - 90% of the 'Buffer size' value.

In the 'Mixer' tab you can change which volume setting XMMS should change when
you alter the volume from XMMS. Enable 'Volume controls Master not PCM' if you
want XMMS to change the volume of all sounds instead of only PCM/wave sound.


3.6.2.2 Disk Writer
-------------------
The 'Disk Writer' plugin will only output the music into a .wav file in
the 'Path' you set in it's configuration window.


3.6.2.3 eSound Output
---------------------
The 'ESD' plugin will use the 'Enlightened Sound Daemon' to playback the audio.
It's useful if you want to be able to have sound effects in your programs and
still be able to listen to music with XMMS.

In the 'Server' tab of the configuration, you can tell the plugin where to send
the audio data. Enable 'Use remote host' and enter the name/ip of the server
and port to send to. This is probably only useful in a LAN environment, since
the audio data is sent uncompressed to the remote ESD.

The 'Buffering' tab works just like the 'OSS Driver' one.


3.6.2.4 BSD Sun Output
----------------------
The 'Sun' output plugin will use the native audio(4) interface provided
by OpenBSD and NetBSD for playback and mixing.

The $AUDIODEVICE and $MIXERDEVICE environment variables will override the
current configuration settings. Defaults are /dev/audio and /dev/mixer.

In the 'Devices' tab you can change the audio, audioctl and mixer devices
XMMS is going to use. The audioctl device is used for ioctl(2) calls
independent of audio data I/O.

In the 'Buffering' tab you can change how much data the Sun plugin will
buffer. The 'Buffer size' ranges from 200 - 10000ms. If you want the plugin
to wait for the buffer to be filled before it starts playing the music,
change the 'Pre-buffer' value, this ranges from 0% - 90% of the 'Buffer size'
value.

In the 'Mixer' tab you can select the volume device to be affected when you
alter the volume from XMMS. `XMMS uses mixer exclusively' causes XMMS to
keep the mixer device open instead of re-opening it for each operation.

There may also be some more options depending on what your audio mixer
device supports (eg. loudness, spatial, surround, preamp).

In the 'Status' tab you can see audio device information and real-time
playback status.


3.6.2.5 ALSA Output
-------------------
Undocumented.


3.6.3 Effect plugins
--------------------
Effect plugins can alter the sound of the music you are listening to.


3.6.3.1 Echo
------------
Adds an echo effect to the audio.

In the configuration you can change 'Delay' 'Feedback' 'Volume' and enable
'Surround Echo'


3.6.3.2 Extra Stereo
--------------------
Enhances the stereo effect on the audio.

In the configuration screen you can choose intensity.


3.6.3.3 Voice removal
---------------------
A simple voice removal plugin, no configuration.


3.6.4 General plugins
---------------------
Mostly used for controlling XMMS and passing data to other programs.


3.6.4.1 IRman Control
---------------------
With this plugin you can use a remote control compatible with IRman to
control XMMS. To set the functions on the remote control, open the
configuration screen and choose on which device the IRman is on. Press the
function you want to assign and then press the button on the remote which
you want it to use for the current function.

Device
	Device
		The serial device your IRman is plugged into.
		(COM1 = /dev/ttyS0, COM2 = /dev/ttyS1)

	IR code length
		Undocumented

Controls

	Play - Repeat
		These will effectively press the appropriate corresponding
		button in XMMS and cause that action to immediately take
		effect.

	+100
		Allows you to specify a number between 100 & 199. To properly
		enter one of these numbers, you first press the corresponding
		button on your remote control for the +100 action. Then within
		2 seconds, you must press the next number and so on.

		Example:

		To enter 115 you press the +100 button, then within 2 seconds
		press the 1 button, then within 2 seconds press the 5 button.	

	Playlist
		This tells the XMMS IRman plugin that you are about to enter
		in a number for the playlist you'd like to load. You have 2
		seconds after pressing the corresponding playlist button on
		your remote control to enter in the appropriate number.

	0-9
		These are used to either jump to a certain track number in a
		loaded playlist, or to load a specific playlist. To jump to a
		track, simply press the corresponding number and it will begin
		playing the specified track number. To enter numbers larger
		than 9, you have 2 seconds between each number press to enter
		the next number. 

		Example:

		To jump to track 54, you must press the 4 button within 2
		seconds after pressing the 5 button.

Playlists:
	0-99
		Here you may specify up to 100 different playlists you have
		already saved on your harddrive. Simply type in the absolute
		path to the playlist (m3u) file for as many entries as you
		need. The number associated with the path you specify is the
		number that you will use to load that playlist.

		Example:

		To load playlist number 0, you first press the corresponding
		"playlist" button on your remote control, then within 2
		seconds you must press the 0 button.


3.6.4.2 Joystick Control
------------------------
This plugin allows you to control XMMS from a joystick. The configuration is
rather straight forward and since I don't have a joystick, I'll leave it up you
to figure it out.


3.6.4.3 Song Change
-------------------
This plugin will run a defined program each time you change song in XMMS.

In the configuration you can define what will happen when the song changes or
when the Playlist reaches the end.

Available information you might want to pass to the program are:

   %F - frequency (in hertz)
   %c - number of channels
   %f - filename (full path)
   %l - length (in milliseconds)
   %n - name
   %r - rate
   %s - name
   %t - playlist position

example: echo "%n" >>~/xmms_log

will fill your ~/xmms_log file with all the songs you have listened to.


3.6.5 Visualization plugins
---------------------------
Eye candy plugins.


3.6.5.1 Blur scope
-------------------
A simple blurring oscilloscope, in the configuration you can change the color
with the standard GTK color dialog.


3.6.5.2 OpenGL Spectrum analyzer
--------------------------------
Displays a rotating spectrum analyzer disc. In the configuration you can enable
3DFX fullscreen mode. If you have a DRI enabled version of XFree it will
display it windowed but captures the mouse. (at least on my system). To leave
fullscreen mode press the Escape key on your keyboard.

The "z x c v b" keys are bound to the same as it is in the main window of XMMS.
Use the arrow keys to change the X and Z axis, and Q + W to change the Y axis.

Pressing Enter will change back to the default settings.


3.6.5.3 Simple Spectrum analyzer
--------------------------------
Displays the oh-so-standard green-yellow-red spectrum bars. No configuration.


4. Command Line Options
-----------------------

xmms --help will produce:

Usage: xmms [options] [files] ...

Options:
--------

-h, --help              Display this text and exit.
-n, --session           Select XMMS 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
-t, --play-pause        Pause if playing, play otherwise
-f, --fwd               Skip forward in playlist
-e, --enqueue           Don't clear the playlist
-m, --show-main-window  Show the main window
-v, --version           Print version number and exit.

You can specify files on the command line, e.g:
xmms file1.mp3 file2.mp3 file3.mp3
xmms *.mp3
xmms playlist.m3u (note: playlists must be named .m3u)

If you do this while XMMS is running the current playlist
will be cleared and the files/playlist specified on the command
line will be used instead.

To keep the current playlist intact use the -e option.

5. Features
-----------

5.1 Supported File formats
-------------------------

OGG Vorbis
MP2 and MP3 streams
WAV/AU samples

module formats:
mod, xm, s3m, med, it
669, amf, dsm, far
gdm, imf, m15, mtm
stm, stx, ult, uni

others:
cd audio, shout/icecast


5.2 Supported Features
----------------------

Seeking in files
Volume/Balance
Shuffle play
Repeat play
Playlist editor
Spectrum Analyzer
One Line mode al'a WinShade in WinAmp
Oscilloscope
Timer Elapsed/Timer Remaining
Plug-in system Output/Input/Effect/General/Visualization
Equalizer
Double Size option
WinAmp 2.0 skin support (can use wsz files)
GTK Requesters (with theme support)
Streaming/Shoutcast(1.0/1.1)/Icecast support
Auto remove borders if the WM has support for it
Gnome/AfterStep/WindowMaker dock app
Fast jump in playlist
Scroll wheel support
Save to wav option
Saves http streams to HD
HTTP authentication
Plays MPEG layer 1/2/3 also wav and formats supported by mikmod
Compiles and works on other UNIX's
Proxy authentication support


6. Obtaining XMMS
-------------------
How do I get it?

XMMS is mainly distributed on http://www.xmms.org/download.php

FTP Mirrors:
   ftp://ftp.xmms.org/pub/xmms/
   ftp://ftp.sunet.se/pub/multimedia/xmms/

Want some skins made by linux users?
   http://www.xmms.org/skins.php
   http://themes.freshmeat.net/browse/966/


7. Misc
-------

7.1. Shoutcast support
---------------------

To make Netscape use XMMS on http://www.shoutcast.com you just have to load up
Netscape and choose view/preferences/Navigator/applications add a new handler
set mimetype: audio/x-scpls
set application: xmms %s
hit the OK button and off you go!

And for http://www.mp3.com

Set mimetype: audio/x-mpegurl
Set suffix: m3u
Set application: xmms %s

7.2. Tips and Tricks
-------------------

If you have a windows partition with WinAmp installed, a good idea would be to
set the SKINSDIR variable to that dir.

XMMS features some command line options like next/previous songs, those
things can be binded to a key. I use AfterStep and the useless window keys
for this. Here is an example from my .steprc:

Key     Meta_R  A       N       Exec "xmms" xmms -r
Key     Menu    A       N       Exec "xmms" xmms -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, don't blame us if locate don't
find the file you downloaded 3 minutes ago)

8. Bugs
-------
There are no known bugs as of this moment, but if you do find one, please visit
http://bugs.xmms.org and let us know.

9. Contact Email's
------------------

Peter Alm      (developer)     peter at xmms.org
H鍁ard Kv錶en  (developer)     havardk at xmms.org
Thomas Nilsson (docs, support) thomas at xmms.org
Olle H鋖ln鋝   (docs, support) olle at xmms.org