###################################################################
##                          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.9: 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:

    > New skin!
    > Now uses autoconf/make, resulting in configure script.
    > Now supports i18n, added translations: cs de ja
    > Playlist window now includes basic file status icon, for currently
      playing song, when a file fails to play, unknown type, etc.
    > Added option 'Play next song on error', to playlist tab.
    > Added total playlist time option. (right click -> toggles)
    > Added live/total/normal/remaining time indicators to the skin spec.
    > Added add/remove current song to/from current playlist. (right click)
    > Added dialog for setting presets, presets can also now be a song
      file or stream (right click -> presets, lower two items).
    > Added drop down history for copy/move/open/save dialogs.
    > Added status request to ipc commands.
    > Playlist window sizes of file lists and song columns are now also
      remembered when 'remember window position' is enabled.
    * Fix 'add custom' dialog bug, selected url was not being added to the
      playlist.

  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: ./configure ; make
               use the --enable-japanese option to enable japanese ID3 tags.
  General install: make install
  GNOME install: make gnome-install is deprecated! configure detects gnome for
                 you now.
  Removal: make 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

  IPC (external control and status):
    control:
      Send commands to gqmpeg through "$HOME/.gqmpeg/command", send text 'help'
       and a brief list of available commands will be printed.
      Note: "$HOME/.gqmpeg/command.pid" will contain the current pid of the
            gqmpeg process (if any) that is listening for commands.

    status:
      Send this command to have gqmpeg start printing it's status to a file:

         status_add "key" "/path/to/file"

      and use this to stop it:

         status_rm ["key"|"/path/to/file"]

      You can stop it by using the key or path. When the updating is stopped,
      two things may be printed: 'close' is printed when status_rm is used;
      or 'exit' is printed just before gqmpeg shuts down (quits).

      Information printed is the current song path, title, track position,
      status (play, stop, pause), and seconds played/remaining.
      Status is only updated when items change, for instance when the song
      changes, the time count changes, or the play/pause/stop status changes.
      Note: If the length of path is 0, no song is loaded in the player. Use
            this to determine 'no song selected', because 'track: 0 of 0'
            may be a valid song if the current active song is not in the
            playlist, and the playlist is empty.

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

     Tomas Prochazka <xprocha2@informatics.muni.cz>
        for Czech translation.

     Yuuki NINOMIYA <gm@smn.enjoy.ne.jp>
        for Japanese translation, japanese id3 tags.

     Matthias Warkus <mawarkus@t-online.de>
        for German translation.

     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.

     Lszl, Rbert - 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)

===========

