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.


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

  Any FOX-1.6.x should work. I recommend to get latest version available (1.6.34 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. You might want consider using the SVN
  version of Goggles Music Manager as well since this should contain the latest updates.


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


ASF / MP4 Support
-----------------

  As of 0.9.x ASF and MP4 tag reading/writing is now buildin by default. If you don't need
  these features and want to decrease the executable size, you may disable these during compilation
  using the following configure commandline options:

    --without-asf

    --without-mp4


Tray Icon
---------

	To use the tray icon Goggles Music Manager needs to be build with dbus support.
  The tray icon is a separate program that requires GTK 2.10 and dbus-glib-1. 

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


Upgrading from 0.7.x
--------------------

  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 users
  are automatically upgraded.


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
    Ctrl-S  Show source browser
    Ctrl-P  Start playback.
    Ctrl-\  Stop playback.
    Ctrl-[  Play previous track.
    Ctrl-]  Play next track.
    Ctrl-T  Toggle Repeat A-B.
    Ctrl-A  Select All in lists.
		F11			Show Mini Player.
    F12     Show Full Screen.
    F2      Edit selected track, album, artist or genre.
    Del     Delete selected track, album, artist or genre.


Importing Music
---------------

    There are currently two ways to import music files into Goggles Music Manager

        1) Import from folder [Music->Import Folder]

            Recursively search any subdirectories of the given folder and import any
            recogizned file.

        2) Import selected files. [Music->Import File(s)]

            Import only the selected files.

    The following files are recognized:

        MPEG-1 Audio Layer 3 (*.mp3)
        Ogg Vorbis (*.ogg)
        Free Lossless Audio Codec (*.flac)
        Musepack (*.mpc)
        Windows Media (*.wma,*.asf)
        MPEG-4 Part 14 (*.mp4,*.m4a,*.m4p,*.aac) (optional)

    If no tag or an incomplete tag is found, it will substitute the missing
    information with either the default tags set in Preferences->Import or
    one of the following options:

        Use filename for song title

            The name of the file (without the extension and full path) is used
            for the	song title.

        Use directory name for album name

            The name of the directory containing the file is used for the album
            name. ie:

                /home/foobar/AlbumName/file.mp3

        Use directory name for artist name

            The name of the directory containing the file is used for the artist name.

                /home/foobar/ArtistName/file.mp3

            If the "Use directory name for album name" is also specified, the name is
            taken from the directory name above the directory containing the files. ie:

                /home/foobar/ArtistName/AlbumName/file.mp3

        Use scanorder for track number

            The trackname will be based on the order of the filenames in the directory.

        Replaces underscores with spaces

            Any underscores in file or directory names used by the tags will be converted
            to spaces.


Editing Tags
------------

    Changing the name of an artist in the Artist list will affect any associated track.

    Changing the name of an album in the Album list will affect any associated track.

    Changing the name of a genre in the Genre list will affect any associated track.


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.


