XWAX(1) 						      General Commands Manual							   XWAX(1)

NAME

       xwax - Digital vinyl on Linux

SYNOPSIS

       xwax [options]

DESCRIPTION

       xwax  is vinyl emulation software for Linux. It allows DJs and turntablists to playback digital audio files (MP3, Ogg Vorbis, FLAC, AAC and
       more), controlled using a normal pair of turntables via timecoded vinyls.

OPTIONS

       The ordering of options is important; many options apply to to subsequent music libraries or decks, which can be given multiple times.  See
       the EXAMPLES below.

       -l path
	      Scan the music library at the given path.

       -p path
	      Load  a  playlist at the given path. This operation is identical to scanning a music library except that the order is defined by the
	      output of the scanner executable.

       -t name
	      Use the named timecode for subsequent decks. See -h for a list of valid timecodes. You will need the corresponding  timecode  signal
	      on vinyl to control playback.

       -33    Set the reference playback speed for subsequent decks to 33 and one third revolutions per minute. This is the default.

       -45    Set the reference playback speed for subsequent decks to 45 revolutions per minute.

       -i path
	      Use the given importer executable for subsequent decks.

       -s path
	      Use the given scanner executable to scan subsequent music libraries.

       -h     Display the help message and default values.

ALSA DEVICE OPTIONS

       The following options are available only when xwax is compiled with ALSA support.

       -a device
	      Create a deck which uses the given ALSA device (eg. plughw:0).

       -r hz  Set the sample rate for subsequent decks.

       -m milliseconds
	      Set the ALSA buffer time for subsequent decks.

JACK DEVICE OPTIONS

       The following options are available only when xwax is compiled with JACK support.

       -j name
	      Create a deck which connects to JACK and registers under the given name.

       xwax does not set the sample rate for JACK devices; it uses the sample rate given in the global JACK configuration.

OSS DEVICE OPTIONS

       The following options are available only when xwax is compiled with OSS support.

       -d pathname
	      Create a deck which uses the given OSS device (eg. /dev/dsp).

       -r hz  Set the sample rate for subsequent decks.

       -b n   Set the number of OSS buffers for subsequent decks.

       -f n   Set the OSS buffer size (2^n bytes).

CONTROLS

       The playback of each deck (direction, speed and position) is controlled via the incoming timecode signal from the turntables.  The keyboard
       provides additional controls.

       Record selection controls:

       cursor up, cursor down
	      Move highlighted record up/down by one.

       page up, page down
	      Scroll the record listing up/down by one page.

       left cursor, right cursor
	      Switch to the previous/next crate of records.

       tab    Toggle between the current crate and the 'All records' crate.

       To filter the current list of records type a portion of a record name. Separate multiple searches  with	a  space,  and	use  backspace	to
       delete.

       Deck-specific controls:

       Deck 0	Deck 1	 Deck 2
       F1	F5	 F9	  Load currently selected track to this deck
       F2	F6	 F10	  Reset start of track to the current position
       F3	F7	 F11	  Toggle timecode control on/off

       Audio display controls:

       +, -   Zoom in/out the close-up audio meters for all decks.

EXAMPLES

       2-deck setup using one directory of music and OSS devices:

	      xwax -l ~/music -d /dev/dsp -d /dev/dsp1

       As above, but using ALSA devices:

	      xwax -l ~/music -d hw:0 -d hw:1

       2-deck setup using a different timecode on each deck:

	      xwax -l ~/music -t serato_2a -d hw:0 -t mixvibes_v2 -d hw:1

       As above, but with the second deck at 45 RPM:

	      xwax -l ~/music -t serato_2a -d hw:0 -t mixvibes_v2 -45 -d hw:1

       3-deck setup with the third deck at a higher sample rate:

	      xwax -l ~/music -r 48000 -a hw:0 -a hw:1 -r 96000 -a hw:2

       Using all three device types simultaneously, one deck on each:

	      xwax -l ~/music -a hw:0 -d /dev/dsp1 -j jack0

       Scan multiple music libraries:

	      xwax -l ~/music -l ~/sounds -l ~/mixes -a hw:0

       Scan a second music library using a custom script:

	      xwax -l ~/music -i ./custom-scan -l ~/sounds -a hw:0

HOMEPAGE

       http://www.xwax.co.uk/

AUTHOR

       Mark Hills <mark@pogo.org.uk>

																	   XWAX(1)