NAME

       gjay - organizes music collections

SYNOPSIS

       gjay [-a file] [-c color] [-d] [-f] file] [-l length] [-p] [-s] [-u] [-v verbosity] [-P]
       gjay [-hV]

DESCRIPTION

       gjay  (Gtk+  DJ)  analyzes  and  categorizes  collections  of  MP3, OGG, FLAC and WAV music files so that
       interesting playlists can be generated. Each song is assigned  characteristics  (BPM  and  spectrum)  and
       user-assigned attributes (rating and color). "Color" is just a handy way for a user to describe a song.

       gjay  has both a user-visible interface and a background processing component. The user-visible component
       is used to select the base music directory, set song attributes, and generate playlists.  The  background
       component (the daemon) analyzes songs.

       Song  analysis  can  take a while. After the base music directory has been set and the daemon has started
       its analysis, it is possible to quit the user interface portion of the program and allow  the  daemon  to
       continue in the background. GJay can be started in daemon mode by passing -d, in which case it runs until
       song analysis is complete.  It's OK to kill or ctrl+c to quit a running daemon; it saves data as it  goes
       along.

       You  can create playlists from within the GJay or from the command line.  If you generate a playlist from
       the command line, the previous session's playlist preferences for the importance  of  various  attributes
       will be used.

OPTIONS

       -a file, --analyze-standalone=file
              Run  the  analysis  daemon on file and then exit. Print the results of analyzing a file to stdout.
              Does not consult existing file data.

       -a color, --color=color
              Start the playlist with the initial color of color.  color can either be one of the  named  colors
              or a hex tuple in the format of 0xRRGGBB.

       -d, --daemon
              Run gjay as a daemon only with no GUI frontend.

       -f file, --file=file
              Start the playlist with file.

       -l minutes, --length=minutes
              Override the playlist length, the default is set in the preferences.

       -s, --skip-verification
              Skip file verification.

       -u, --m3u-playlist
              When generating a playlist, make it in the m3u format.

       -v verbosity, --verbose=verbosity
              Set the level of how verbose gjay is.

       -P, --player-start
              Start the music player after making a playlist.

       -V, --version
              Show the version and copyright information for the program.

SEE ALSO

       audacious(1),mpd(1)

                                                   2011-03-22                                            GJAY(1)