readme

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

XMMS - X Multimedia System (C) 1997-2004

A Cross platform Multimedia Player

Peter Alm, Thomas Nilsson, Olle Hallnas, H鍁ard Kv錶en


TABLE OF CONTENTS
*****************

1. Disclaimer
2. Installation
   2.1 Basic Installation
   2.2 Border less Installation
   2.3 Skin Installation
3. Documentation
   3.1 Controlling XMMS
       3.1.1 Key bindings
   3.2 Playlist Editor
   3.3 Equalizer
   3.4 Menu
   3.5 Preferences
      3.5.1 Audio I/O Plugins
      3.5.2 Effect Plugins
      3.5.3 General Plugins
      3.5.4 Visualization Plugins
      3.5.5 Options
      3.5.6 Fonts
      3.5.7 Title
   3.6 Plugins
      3.6.1 Input plugins
            3.6.1.1 Cd Audio Player
            3.6.1.2 Mikmod player
            3.6.1.3 MPEG Layer 1/2/3 player
            3.6.1.4 Tone Generator
            3.6.1.5 Ogg Vorbis player
            3.6.1.6 Wave player
      3.6.2 Output plugins
            3.6.2.1 OSS Driver
            3.6.2.2 Disk Writer
            3.6.2.3 eSound Output
            3.6.2.4 BSD Sun Output
            3.6.2.5 ALSA Output
      3.6.3 Effect plugins
            3.6.3.1 Echo
            3.6.3.2 Extra Stereo
            3.6.3.3 Voice removal
      3.6.4 General plugins
            3.6.4.1 IRman Control
            3.6.4.2 Joystick Control
            3.6.4.3 Song Change
      3.6.5 Visualization plugins
            3.6.5.1 Blur scope
            3.6.5.2 OpenGL Spectrum analyzer
            3.6.5.3 Simple Spectrum analyzer
4. Command Line Options
5. Features
   5.1 Supported File formats
   5.2 Supported Features
6. Obtaining XMMS
7. Misc
   7.1 Shoutcast support
   7.2 Tips and tricks
8. Bugs
9. Contact Email




1. Disclaimer
-------------

We are not liable for any damage caused by the use of this program.

XMMS is NOT a port of windows95's WinAmp. We just borrowed the GUI! :)


2. Installation
---------------

These libraries are needed to compile XMMS.

   gtk/glib 1.2.2 or better.
   ftp://ftp.gtk.org/pub/gtk/v1.2/

For libc5 users, you also need to obtain,

   gnu gettext 0.10 (use configure --with-gnu-gettext)
   ftp://prep.ai.mit.edu/pub/gnu/gettext/gettext-0.10.tar.gz

   linuxthreads 0.71
   http://www.xmms.org/files/libc5/linuxthreads.tar.gz

   Thread safe Xlibs (at least aware)
   http://www.xmms.org/files/libc5/XFree86-3.3-libs.tar.gz (thread aware)

If you want XMMS to play mod/s3m/med and formats supported by mikmod
you need to install libmikmod before running ./configure on XMMS.

   http://www.ibiblio.org/pub/linux/apps/sound/libs/

For the OpenGL plugin you'll need Mesa 3.0 or better.

   http://www.mesa3d.org/

To compile the Ogg Vorbis plugin you'll need libvorbis from:

   http://www.vorbis.com/download_unix.psp

2.1 Basic Installation
----------------------

cd xmms-1.2.8
./configure
make
make install

This will put the binary in /usr/local/bin and plugins in
/usr/local/lib/xmms/

2.2 Borderless Installation
---------------------------

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.

AfterStep 1.0 ~/.steprc
Style "XMMS_Player" NoTitle, NoHandles
Style "XMMS_Playlist" NoTitle, NoHandles
Style "XMMS_Equalizer" NoTitle, NoHandles

AfterStep 1.4 ~/GNUstep/Library/AfterStep/database
Style "XMMS_Player" NoTitle, NoHandles
Style "XMMS_Playlist" NoTitle, NoHandles
Style "XMMS_Equalizer" NoTitle, NoHandles

Fvwm's ~/.fvwm95rc
Style "XMMS_Player" NoTitle
Style "XMMS_Playlist" NoTitle
Style "XMMS_Equalizer" NoTitle

CTWM's ~/.ctwmrc
NoTitle and NoBorder sections:
NoTitle {
    "xmms"
}

NoBorder {
    "xmms"
}

2.3 Skin Installation
---------------------

XMMS will create a drawer called ~/.xmms/Skins/ in which you just unarchive the
skins the same way as you do for WinAmp.

However, you don't need to unarchive them since XMMS supports archived skins.
XMMS currently reads the following formats: zip, wsz, tar, tar.gz and tar.bz2

Just copy the archive to one of the skin path's and XMMS will take care of the
rest.

In order to support zipped skins you will need to download unzip.
ftp://sunsite.unc.edu/pub/Linux/utils/compress/unzip-5.31.tar.gz

If you do not wish to have unzip in your path, then set the variable UNZIPCMD
to the directory in which you keep the unzip command.

Use ALT+S when using XMMS to bring up the skin selector. XMMS will remember
which skin you had loaded when you start XMMS the next time. (saved in
~/.xmms/config) in the skin selector you have an option to use random skin on
play, this will pick a random skin on song change.

XMMS looks for skins in these directories:

<prefix>/share/xmms/Skins
~/.xmms/Skins

or you can set the variable SKINSDIR to another location of your choice.

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


3. Documentation
----------------

This file or http://www.xmms.org/docs/readme.php

3.1 Controlling XMMS
--------------------

When you start up XMMS, you will get a console very similar to that of
WinAmp.

- On the top is the window title bar. To the right you will see 3 buttons,
   Left button will minimize XMMS.
   Middle button will make XMMS only display the title bar.
   Right button will end the XMMS session.

- The area in the upper left part displays the following:
   - Play state: Paused, Stopped, or Playing
   - Time elapsed in the current song or if you click on it, the reversed.
   - Spectrum analyzer of the sound being played. Right mouse click will
     bring up the Visualization menu. Left mouse button will change the
     analyzer to an oscilloscope and/or none.

- To the right of the Spectrum analyzer is the title of the file being played.
  This also contains the length of the song being played, as well as its
  position in the [unsorted] playlist. Right clicking in this window will bring
  up a new menu with some more options that are self explaining.

- In the left part of the Spectrum analyzer you'll have letters (at least if
  you use the default skin) O A I D V  left mouse clicking on these will open
  up menus or perform actions.
  O : Options menu
  A : Always on top
  I : File info box
  D : Double size mode
  V : Visualization menu

- Underneath the track title are the following static informational data:
   - bit rate in KBps (usually 128 or 112)
   - Sample Rate in KHz (usually 44)
   - Stereo or Mono channel mixing

- Underneath the informational data are a few controls you can play with:
   - The first slider controls the volume
   - The second slider controls the balance between speakers
   - The button marked "EQ" loads up the graphic equalizer
   - The button marked "PL" loads up the playlist editor
   - The LARGE slide bar moves from left to right as the song plays. You can
     drag this to jump to another location in the current file.

- On the bottom of the console are the standard buttons you would see on a CD
  player: Previous track, Play, Pause, Stop, Next track, eject, shuffle
  and repeat.

   - The eject button doesn't REALLY eject, of course. :) It opens up the
     file requester. The File Requester builds a playlist for the current
     XMMS session. You can use it to load files, add files to the list, or
     load all mp3s in a directory.

   - The shuffle button randomizes the sequence of the playlist.

   - The repeat button when enabled makes the playlist loop when it reaches the
     end of the playlist.


3.1.1 Key bindings
------------------

Global: (Main, Equalizer and Playlist window)

  z = Previous song
  x = Play
  c = Pause
  v = Stop
  b = Next song
  l = Play file (brings up the Load file(s) dialog)
  j = Jump to file (in the existing playlist)
  r = Toggle Repeat
  s = Toggle Shuffle

  Shift + l = Play directory (brings up the Add Directory dialog)

  Control + l = Play location (url)
  Control + p = Preferences dialog
  Control + v = Visualization plugin dialog
  Control + r = Time remaining
  Control + a = Always on top
  Control + w = Winshade mode
  Control + d = Doublesize mode
  Control + e = Easy move
  Control + j = Jump to time
  Control + z = Start of list
  Control + n = No Playlist Advance
  Control + 3 = File info dialog

  Control + Alt + w = Toggle Equalizer winshade mode
  Shift + Control + w = Toggle Playlist winshade mode

  Alt + w = Toggle mainwindow
  Alt + e = Toggle playlist window
  Alt + g = Toggle equalizer window
  Alt + s = Skin selector

Main window:

  Arrow key up    = Volume up 2%
  Arrow key down  = Volume down 2%
  Arrow key right = Skip 5 seconds forward in song
  Arrow key left  = Skip 5 seconds back in song

Playlist window:

  Arrow key up    = up one step in playlist
  Arrow key down  = Down one step in playlist

  Delete          = Remove selected songs from playlist
  Control+ Delete = Keeps the selected tracks and removes the rest
  Q               = Queue/Dequeue the tracks selected
  Shift + Q       = Clear the queue list
  Page Up         = Move one page up
  Page Down       = Move one page down
  Home            = Go to the first song
  End             = Go to the last song
  Enter           = Play selected song
  Insert          = Add file dialog
  Shift + Insert  = Add directory dialog
  Alt + Insert    = Add url dialog

Equalizer shade mode:

  Arrow key up    = Volume up 2%
  Arrow key down  = Volume down 2%
  Arrow key right = Balance 4% to right
  Arrow key left  = Balance 4% to left


3.2 Playlist editor
-------------------

To access the Playlist editor, select the button labeled "PL" on the right
side of the XMMS 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:

file +    : will add a file to current playlist, held down mode you'll have
            2 extra options
dir       : will let you pick a directory (recursive)
url       : will let you add an url for streaming

file -    : will delete the highlighted file, held down mode you'll have 3
            more options
crop      : delete all files except the highlighted in the list
all       : delete all files in the list
misc      : *** NOT FUNCTIONAL ***

sel all   : select all files in current playlist, held down mode you'll have
            2 extra options
sel zero  : select none
inv sel   : invert you selection

misc opts : held down you'll have 2 extra options
fileinfo  : opens the file info dialog.
sort      : release button on this will bring up another menu with sort options

load list : will let you pick a playlist to load, held down you'll have
            2 extra options
save      : will let you save your playlist
new       : will empty the playlist and let you create a new playlist

If you want to select/deselect files in the filrequester/playlist editor use
CTRL for files and SHIFT key for blocks of files. You can also browse the PL
using the cursor keys and enter to select song. Pressing the delete button will
remove the song from the playlist. If your mouse is equipped with a mouse
wheel, you can use this to scroll up and down.

3.3. Equalizer
--------------

To access the Equalizer, select the button labeled "EQ" on the right
side of the XMMS console.

That will bring up the Equalizer window. It looks like an equalizer on a stereo
and behaves like one as well. Press the button labeled 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 ~/.xmms/config when you close XMMS. You can also
have your own presets for different song using the "Preset" button, XMMS can
also import/export from WinAmp's preset files.

If 'Auto' is enabled, XMMS will try to load equalizer presets like this:

1: Look for a preset file in the directory of the file we are about to play.
2: Look for a directory preset file in the same directory.
3: Look for a preset saved with the "auto-load" feature.
4: Finally, try to load the "default" preset.

The 'preset' button will open up a menu with the following options:

Load
   Preset               : Will open a window with all available presets.
   Auto-load preset     : Will open a window with all available auto-load
                          presets.
   Default              : Will load the default preset.
   Zero                 : Will reset the equalizer to zero.
   From file            : Will load from a .preset file
   From WinAMP EQF file : Will load from a WinAMP equalizer file. If you
                          choose a library file only the first entry will
                          be loaded.
Import
   WinAMP presets       : Imports the presets contained in an WinAMP equalizer
                          library file (often named WINAMP.q1) and add all
                          the entries to the Preset window.
Save
   Preset               : Let you name the current preset and save it.
   Auto-load preset     : Saves the current settings as a preset for the song
                          currently playing.
   Default              : Saves the default value for the equalizer.
   From file            : Saves the current settings in a preset file.
   From WinAMP EQF file : Exports the current settings to a file readable by
                          WinAMP.
Delete
   Preset               : Let you delete a preset from the list.
   Auto-load preset     : Let you delete a auto-load preset from the list.

Configure Equalizer     : Change the default names of directory based