NAME

jukeboxc - command line jukebox network client


SYNOPSIS

  jukeboxc [options] [--] [.|selector...]
  options:
    -h, --help          - Show the help message then exit
    -V, --version       - Show the version message then exit
    -d, --debug         - Print debug messages
    -g, --gui           - Launch graphical jukebox client (jukeboxc.jar)
    -a, --all           - Select everything (not just your favourites)
    -j, --strict        - Search for selectors only in "Jukebox" tags
    -m, --mandatory     - Search treating all selectors as mandatory
    -n, --list          - Just list matching tracks (don't play them)
    -x, --extra         - Show artist/album/title as well (implies -n)
    -e, --elide         - Suppress duplicate artist/albums (implies -x)
    -v, --withtags      - Include tags when listing tracks (implies -x)
    -s, --sequential    - Play tracks sequentially, then stop
    -c, --continuous    - Play continuously (even if -s)
    -f, --playlist file - Play tracks from a playlist file
    -T, --tagstats      - List known selectors/categories/tags
    -0, --stop          - Stop the jukebox
    -H, --host host     - Override default jukebox hostname (jukebox)
    -P, --port port     - Override default jukebox tcp port (1221)


DESCRIPTION

jukeboxc is a jukebox network client that can either operate as a command line utility or it can launch the graphical jukebox client (jukeboxc.jar). The -g option launches the graphical jukebox client. For more details, see ``man jukeboxc.jar''.

Without the -g option, jukeboxc is a command line jukebox network client with the same functionality as the graphical version. Many of jukebox's options are accepted and mean the same thing except that they operate via the jukebox server instead of directly on a local wav/mp3/ogg/flac collection. For more details, see ``man jukebox''.

The -0 option stops the jukebox server playing music. The jukebox server can also be stopped by using ``.'' as the only selector/argument.

The -H and -P options override the host and port to connect to. These (and -h) are the only options that may be used with the -g option.


EXAMPLES

See ``man jukebox'' for examples.


NOTE

The long options are only available if the value of the juke_opts variable in /etc/jukebox.conf is ``long''. This is because the standard perl module, Getopt::Long, requires the presence of a ``--'' argument before any arguments that begin with ``+'' because it thinks they are options (unless $POSIXLY_CORRECT is set in the environment). Since it is expected that this program will receive many command line arguments that begin with ``+'', the default is to only handle single letter options via the Getopt::Std module. Note that, with either short or long options, ``--'' must be used whenever there are search terms that begin with ``-'' because these really do look like options.


FILES

  /etc/jukebox.conf - System wide configuration file
  ~/.jukeboxrc      - User specific configuration file


SEE ALSO

  rip(1), riptrack(1), mktoc(1), toc2names(1), toc2tags(1),
  cdr(1), cdrw(1), burn(1), burnw(1), cdbackup(1), mp3backup(1),
  jukebox(1), jukeboxc(1), jukeboxc.jar(1), jukeboxd(8),
  jukeboxd-init.d(8), jukebox.conf(5),
  http://raf.org/jukebox/Jukebox-HOWTO


AUTHOR

raf <raf@raf.org>