Digital vinyl system

Digital vinyl,
without the laptop.

Open source, and free.

Written to a card with Raspberry Pi Imager.

How to build it

About

A two-deck DVS that runs on a Raspberry Pi beside your mixer, with your music on a USB stick. Any browser on your network is the screen, and nothing in the audio path depends on it.

A mix recorded on Waxcode DVS.
Two decks running, the library on a USB stick, and a mix recorded straight back to it.

If you build one and get some use out of it, there’s a tip jar (opens in a new tab). It helps me keep working on this — always appreciated, never expected.

Specification

Decks
2
Control
Serato control vinyl
Engine
Custom xwax, on the box
Audio
HiFiBerry DAC8x + ADC8x
Library
USB stick, read directly
Interface
Any browser on your network
Analysis
Waveforms + beat grids, on load
Recording
Yes, exportable
Licence
Free and open source

How it works

Audio path

Turntable A

Turntable B

ADC8x

DAC8x

Raspberry Pi 5

xwax + the app

Your mixer

Rec — back into the ADC8x

phone, laptop, anything

The build

Waxcode is a free, open-source project. You buy the parts and build it yourself — it's your own equipment, built and used at your own risk, with no warranty of any kind. See Terms.

What to buy

  • Raspberry Pi 5
  • HiFiBerry DAC8x
  • HiFiBerry ADC8x
  • Official 27W USB-C power supply
  • microSD card, 16GB or larger
  • USB stick for your music
  • RCA-to-3.5mm stereo leads or adapters — four, or five if you record
  • Two turntables and Serato control vinyl
  • Official Raspberry Pi 5 active cooler (Heat pads are typically included)
  • Extended 40-pin GPIO header and 16mm standoffs — so the boards clear the cooler

7 steps

  1. 01Fit the heat pads and the active cooler to the Pi, then push the extended GPIO header onto the Pi's own header. Stack the DAC8x onto that, then the ADC8x onto the DAC8x, on 16mm standoffs.
  2. 02Download and install Raspberry Pi Imager (opens in a new tab).
  3. 03In Imager, open App Options, click Edit next to Content Repository, choose Use Custom URL, and paste https://www.waxcode.co/os_list.json then Apply & Restart.
  4. 04Choose Raspberry Pi 5, then Waxcode DVS, then your card. In Customisation:
    • Hostname — waxcode
    • Username — pi, with a password of your own
    • Wi-Fi— your own network. This one you must fill in.
    Then write the card.
  5. 05Put the card in the Pi and power it on. Leave it a few minutes - the first boot sets itself up, and the light blinks quickly while it does.
  6. 06Open http://waxcode.local from any browser on your network. Worth saving the page to your desktop or home screen for quick access.
  7. 07Turntables into Deck A and Deck B. Line A and Line B into two line channels on your mixer, and a USB stick of music into the Pi. That is the whole setup.

On an iPhone or iPad, open http://waxcode.local in Safari, press Share, and scroll down to Add to Home Screen. It then opens full screen with no browser around it, which is the interface as it is meant to be used. Worth lengthening your device’s auto-lock too, so the screen stops dimming between tracks.

Connections

Every socket is a 3.5mm stereo minijack, four on each board, laid out as you face them. The top row listens, the bottom row plays.

Top row · ADC8x · in

Deck Ach 0/1
Deck Bch 2/3
unusedch 4/5
Recch 6/7

Bottom row · DAC8x · out

Phono Ach 0/1
Phono Bch 2/3
Line Ach 4/5
Line Bch 6/7

← as you face the ports →

  • Digital audio always leaves on Line — the tracks you play from the USB stick, whatever the systems input is set to.
  • Passthrough is for playing actual vinyl — it lets a turntable's own signal through the box, for when you are playing a record rather than a track from the stick. On Phono it leaves on the Phono jack at cartridge level and needs your mixer's phono stage. On Line it leaves on the Line jack beside the digital audio, and the Phono jack sits unused.
  • Rec is an input — where the box listens to your mixer's record output. Not somewhere to plug a turntable.

Every socket on the box is 3.5mm stereo, so you will most likely need RCA-to-3.5mm leads or adapters to reach your gear — two for the turntables, two for the mixer, and one more if you record.

The app

The box has no screen. Everything is done from a browser on your phone or laptop — two decks, the library, and the settings behind them.

Position lock

On each deck, beside Key

A padlock marked Position button, on each deck. Position lock enabled is the default state, and is what a deck is set to every time you load a track.

Enabled, the needle's position IS the track's position: drop it a third of the way into the record and you land a third of the way into the track, exactly like a real record. Back cueing, sratching and position manipulation will be accurate and responsive

Disabled, the needle stops carrying the position and becomes a pitch control device instead. The track will always drive forward. Lifting the needle no longer stops the track, and dropping it back down no longer starts a track.

*IMPORTANT* When position lock is disabled small adjustments will read correctly — a nudge to bring two tracks back into phase or a pitch change but back-cueing and scratching or true position changes will not be recognised accurately: the track is still running forward underneath, and these actions will fight that or outright fail.

Using the internal features — loops, play/pause, cue/cuep — during playback, disables position tracking automatically.

Serato side

On each deck

Each deck is told which side of the control record it is reading — Serato A or Serato B. It is per deck, so the two can differ.

Side A and side B carry different timecode signals, and the box only decodes the one it has been told to expect.

Set to the wrong side, the deck never locks on. The needle is down, the record is turning, and the deck sits there as though nothing is happening — which looks far more like a dead deck, a bad needle or a broken cable than a one-tap setting. Before suspecting hardware, check the side matches the side you actually put on.

Phono or Line

Settings · Inputs

Chosen to match what your turntable sends out: Phono for the signal straight off the cartridge, Line for a deck with a preamp built in or one you are running through. It's one setting for the whole box adjusted in settings > inputs, not per deck, and changing it restarts both decks.

It does two jobs at once. It sets how sensitive the box is to the incoming timecode signal, and it decides which output a real record passes through to — a deck set to Phono sends passthrough vinyl out the Phono jacks, Line sends it out the Line jacks. Digital audio always leaves on Line whichever way this is set.

Two things give it away when it is set wrong. No passthrough signal at all, because a real record leaves by the jacks this names — the wrong choice sends it to the pair you are not plugged into. And the record not feeling right under your hand, because the sensitivity moves with the setting.

Who made it

A one-person project in the UK, built by a DJ who wanted this to exist and could not buy it. If you are building one, get in touch.

The code

  • waxcode (opens in a new tab)

    The box software: library, waveform and beat grid analysis, recording, the browser interface, and the provisioning that builds a card.

  • waxcode-xwax (opens in a new tab)

    The DVS engine. A fork of xwax with key lock, a control protocol and the modifications the Waxcode build needs.

Built on

The parts Waxcode does not do itself. Two of them settle its licence: Rubber Band and Queen Mary’s DSP are GPL, so anything built on them is too.

  • Rubber Band — key lock — holding pitch while the tempo moves GPL-2.0-or-later
  • Queen Mary DSP — beat tracking GPL-2.0-or-later
  • KISS FFT — the transform inside the beat tracker BSD-3-Clause
  • FFTW — spectral analysis GPL-2.0-or-later
  • libsamplerate — resampling as the platter changes speed BSD-2-Clause
  • ALSA — every sample in and out of the HATs LGPL-2.1-or-later
  • FFmpeg and SoX — decoding and converting what you load GPL-2.0-or-later
  • Node.js and React — the server and the browser that controls it MIT

Show all — every library, with links and licences.

Mailing list

One short email when there is a new version worth writing to a card. Nothing else, and you can leave any time.