Support
-------

  Found a bug, want a feature or tell how great Goggles Music Manager is/sucks.
  Please mail me at s.jansen@gmail.com or file an issue at
  http://code.google.com/p/gogglesmm


Installation
------------

  Read the INSTALL file on how to build and install Goggles Music Manager on
  your machine. Note that as of the 0.9.x the build system has changed, hopefully
  even more easier to use than before.

Name Unification
----------------

  Before 0.10.23 Goggles Music Manager used various abbreviations to refer to itself (musicmanager,gmm,gogglesm).
  To avoid confusion, this naming has been unified in 0.10.23. Since a lot of distributions already used gogglesmm,
  it was decided to use 'gogglesmm' as the standard base name. The following things are affected by this change:

  - The source package has been renamed to 'gogglesmm-x.y.z.tar.*'
  - The executable has been renamed from 'gmm' to 'gogglesmm'
  - The extra desktop files (gmm.desktop and gmm.png) have been renamed to (gogglesmm.desktop and gogglesmm.png)

  If you provide binary packages for Goggles Music Manager please distribute with the gogglesmm name.

Upgrading
---------

  If you've used Goggles Music Manager 0.7.x, please note that you will have to
  reimport your music due to changes in the database. The database for 0.8.x / 0.9.x / 0.10.x users
  are automatically upgraded.

FOX 1.6 / FOX 1.7
------------------

  Any FOX-1.6.x should work. I recommend to get latest version available (1.6.39 at the time of writing).

  Use FOX-1.7.x at your own risk. In general it should work with the latest release
  and development snapshot. If it doesn't, you could try to fix it yourself or wait
  for me to catch up with the latest FOX changes.

Last-FM
-------

  Join the Goggles Music Manager group:
    http://www.last.fm/group/Goggles+Music+Manager

  To start scrobble tracks:

    Go to <edit><preferences> and fill in your lastfm username and password.
    If Goggles Music Manager can successfully authenticate with the lastfm service tracks,
    will automatically get 'scrobbled'. If no internet connection is present (or a invalid
    user/password has been given), tracks to be submitted will be queued until a internet
    connection can be established again.

    The queue is kept in ~/.goggles/scrobbler.cache.

  To stop scrobble tracks:

    Uncheck last.fm or remove the lastfm username and password from preferences dialog.
    Note that tracks won't be queued either.

  Limitations / Implementation Details

    * Uses audioscrobbler realtime submission protocol v1.2
    * No proxy support.
    * Standard 1 minute delay before submitting played tracks.
    * 80% of track need to be played to be counted as played.
      Only tracks longer than 30sec will be submitted to last-fm.

  For other scrobbler compatible services like libre.fm, you may change the submit url
  in the musicmanager settings file '~/.foxrc/musicmanager':

    [LastFM]
    handshake-url="http://89.16.177.55"

    or

    [LastFM]
    handshake-url="http://turtle.libre.fm"


M3U / PLS  Internet Radio Streams
---------------------------------

  libcurl is required to open m3u and pls internet radio stream.

Mini Player
-----------

  Goggles Music Manager 0.9.x contains a new mini player. If you liked the old one better, you can
  disable the new one using the configure command line option:

    --without-new-remote

Audio Configuration
-------------------

  Specific configuration settings for XINE may be set in

    ~/.goggles/xineconf

  Run and play a track in Goggles Music Manager once to automatically create a default configuration.


Keyboard Shortcuts
------------------

    Ctrl-N	Reset default sorting order in current view.
    Ctrl-R  Shuffle track list.
    Ctrl-B	Toggles browse mode on or off.
    Ctrl-G	Toggles Genre list in browse mode.
    Ctrl-Q	Quit Goggles Music Manager.
    Ctrl-O	Import files from given directory.
    Ctrl-J	Jump to playing song in track list.
    Ctrl-F  Find
         /  Find
    Ctrl-S  Show source browser
    Ctrl-P  Start / Pause playback.
    Ctrl-\  Stop playback.
    Ctrl-[  Play previous track.
    Ctrl-]  Play next track.
    Ctrl-T  Toggle Repeat A-B.
    Ctrl-A  Select All in lists.
    Ctrl-W  Close Main Window
    F11			Show Mini Player.
    F12     Show Full Screen.
    F2      Edit selected track, album, artist or genre.
    Del     Delete selected track, album, artist or genre.


Sorting
-------

    The following sort options are available for the track list:

    Browse: [only available in browse mode]
        Sort on album, sort on artist and sort on track number.
        Note that artist and album can be either ascending or descending based
        on the sorting order of the album and artist list.

    Shuffle:
        Try to randomize the order of the tracks.

    By Genre:
        Sort on genre, sort on artist, sort on album and sort on track number.

    By Artist:
        Sort on artist, sort on album, sort on track number

    By Album:
        Sort on album, sort on track number

    By Time:
        Sort on time

    By Track Number:
        Sort on track number

    By Title:
        Sort on title


    For artists and albums special keywords may be set in the preferences
    panel to exclude certain common words from sorting on.


