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: As above, but using ALSA devices: 2-deck setup using a different timecode on each deck: As above, but with the second deck at 45 RPM: 3-deck setup with the third deck at a higher sample rate: Using all three device types simultaneously, one deck on each: Scan multiple music libraries: Scan a second music library using a custom script:

HOMEPAGE¶

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

AUTHOR¶

Mark Hills <mark@pogo.org.uk>