|
|
Audio conversion tools for Linux
|
|
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)
