###################################################################
##                          GQmpeg 0.6.3                         ##
##   This software is Copyright (C) 1998, 1999 by John Ellis.    ##
##  Use this software at your own risk. I am not responsible for ##
##        anything this software may do to your computer.        ##
## This software falls under the GNU Public License. Please read ##
##              the COPYING file for more information            ##
###################################################################

Author: John Ellis
e-mail: gqview@email.com  or  gqview@geocities.com
homepage: gqview.netpedia.net
       or www.geocities.com/SiliconValley/Haven/5235/ (alternate site)

======== Requirements

  GTK+-1.2.x: ftp://ftp.gtk.org/pub/gtk (1.0.x will not work!)
  Imlib 1.8: ftp://ftp.labs.redhat.com/pub/imlib
  mpg123 >= 0.59o http://ftp.tu-clausthal.de/pub/unix/audio/mpg123/
  (mpg123 >= 0.59p required for streaming (http://, shoutcast, etc))

  --------------------------
  freeamp also works with GQmpeg when used in mpg123 emulation mode,
  see freeamp.org for details and download.

======== Notes and changes for this release (07/03/99)

  Changes:
    - Added mpg123 0.59r support, (removed warnings).
    - Added (back) freeamp support, should work now with freeamp 1.2.3, seeking
      still does not work, however.
    - Added support for mpg123 --aggressive option to use higher priority, only
      has effect if mpg123 can get a higher priority (mpg123 is setuid root).
    - Skins can now also be located in a system dir
      (eg: /usr/local/share/gqmpeg/skins)
    - Saving an ID3 tag now updates the file in the playlist.
    - Timeout for http streams increased to 20 seconds (from 10).
    - Added NetBSD native sound system support.
    * Fixed ipc on NetBSD (should work now).
    * Fix playlist length count display bug.
    * Fix crash when applying id3 headers and playlist window was not open.
    * Fix buffer over-run causing crash in g_hook_next_valid() when mpg123
      decides to exit or crash.
    * The display is now frozen during playlist load, should be faster now.
    * The volume slider is now occasionally updated to the real volume.

  Notes:
    - Streams are loaded by right clicking and choosing Open->Custom, and
      added to the playlist by pressing the 'add custom' button in the
      playlist window. To change a stream in the playlist, right click it and
      choose 'edit'.
    - Multiple file selection is done by [ctrl] - clicking and
      [shift] - clicking, also [ctrl] - [space] turns on a mode in the clist
      so that pressing space on an item toggles it's selection. (these are
      standard keys and operations for gtk, nothing special).
    - Drag and drop is available in the playlist window to add files /
      directories and to move items in the playlist. Files can also be dropped
      on the main window.
    - The -dockwm option for the WindowMaker dock does not seem to work as
      advertised, it places it in an icon, but doesn't seem to go into the dock.
      (I actually got around to trying it, after downloading 0.52.0)
      A FIX for this is requested.

======== Installation

  Compilation: make
  General install: make install
  GNOME install: make gnome-install
    Note: The gnome-install method only adds installation of an icon and
          menu item to the GNOME application menu.
  Removal: make uninstall, or make gnome-uninstall

======== Description / Features

  GQmpeg is a frontend to mpg123 with extensive themeability and playlist
  support.

  Features:
    - Extensive mpg123 option support.
    - Shuffle, repeat.
    - Shuffle and repeat preferences can be saved in each playlist.
    - Customizable skins, including winamp skin support.
    - A skin can contain an alternative face (shade mode for instance)
    - ID3 tag reading/writing support (v1)
    - Volume controls (can be connected to any available device)
    - Basic file management (move/copy/rename/delete)
    - Tab completion in most dialogs.
    - Presets for playlists.
    - Drag and drop support.
    - Shoutcast (http://server:port) support.

======== Command Line options:

   Note: 'gqmpeg -help' to list all options, this list is probably outdated.

    -debug          enable debug mode (spews lots of wierd junk :)
    -skinhelp       shows the mouse coordinates as you move the mouse to help
                    position items when designing skins
    -skin:skinfile  tells GQmpeg to use the skin in the directory named
                    skinfile, GQmpeg searches for skinfile in the current and
                    HOME/.gqmpeg/skins/ directories.

   The following commands send a command to another running gqmpeg and exit.
   (requires 'allow command parsing' to be enabled)

     option:           function:
     -p  | --play      play
     -s  | --stop      stop
     -ps | --pause     pause
     -n  | --next      next
     -b  | --back      prev

     Note: also echoing the functions above to ~/.gqmpeg/command will work
     example: `echo next > ~/.gqmpeg/command` will tell gqmpeg to skip to
              the next song.

======== Skins:

  To specify a skin use the -skin:skinfile command line parameter (see above).
  When specifying a default skin in the config dialog, the skin must reside
  in HOME/.gqmpeg/skins 
  If valid, a new default skin is loaded when 'ok' or 'apply' is pressed.

  A skin is a directory which contains a file named skindata and xpm files for
  the skin. Creating a skin is explained in the SKIN-SPECS file, you can
  download sample skins to use as a template from the GQmpeg web site:

     http://gqview.netpedia.net

  Winamp skin support:
    All files must be lowercase.
    Support is an added bonus. Most skins will work, however a few will not.
    Please  do not request support to get a particular skin to work.

======== Documentation (brief)

  Shoutcast support:
    (unsupported, very buggy) (not available in binary packages)
    Shoutcast support _requires_ mpg123 0.59pre-p ..
              ... mpg123 0.59o WILL NOT WORK!
    The shoutcast directory of the source code includes a script and
    instructions to use GQmpeg as a netscape plugin for shoutcast(.com)
    pls files.

  Keyboard controls:
       p, [SPACE]     play/pause
       s              stop
       n              next
       b              back
       l              playlist
       m              run mixer
       w              switch skin mode
       i              song information
       -              volume down
       +, =           volume up
       [CTRL] -       balance left
       [CTRL] +, =    balance right
       1 .. 0         presets 1 through 10, respectively

       [CTRL] s       shuffle
       [CTRL] r       repeat
       [CTRL] t       time display
       [CTRL] o       options/preferences
       [CTRL] i       iconify
       [CTRL] a       about
       [CTRL] q       quit

======== Thanks go to the following for fixes, additions, and patches:

     Hubert Feyrer <hubert.feyrer@rz.uni-regensburg.de> and
     Rui-Xiang Guo <rxg@ms25.url.com.tw>
        for NetBSD patches.

     Kimball Thurston <kimball@sgrail.com>
        for sgi mixer support
        and Window Maker docking support.

     Bruno Rohee <rohee@OpenBSD.ORG>
        for BSD cpu utilization code.

     Michael Bruun Petersen <mbp@image.dk>
        for playlist window enhancements.

     László, Róbert - rob@sch.bme.hu
        for additional skin widgets: Numbers and fonts, other fixes.

     Yick W. Tse <ywtse@mailcity.com>
        for ID3 genre updates.

     Sampo Niskanen <sampo@compart.fi>
        for early help with playlists, misc.

     Tino Schwarze <tino.schwarze@informatik.tu-chemnitz.de>.
        for ipc crash fixes.

     [more] (I know, there are more, I don't have time right now to update this)

===========

