Uncle Magic's Liquid Turntable

Documentation

Documentation for the Uncle Magic's Liquid Turntable - a Beat Reactive, color turntable for Liquid Light Shows and other underlit tomfoolery. Reads OSC tempo information from Pulse, BPM from Resolve, and tap tempo.

Find a document

Nothing matches. Clear the filter to see everything.

Guides (HTML)

User Guide

How to run it: the panel knobs, tempo and tap, speed and reversing, the lighting, the web pages, OSC, network setup, safety and troubleshooting.

For: anyone using the turntable

Hardware Overview

How it is built: the boards, power rails and protection, signal flow, connectors, the LED ring board, the motor and mechanics, the supply, ordering.

For: builders and anyone repairing it

FAQ

The things that catch people out, with short answers: a phone browser that can't reach the unit (Android's Nearby devices permission), Art-Net that doesn't arrive, presets that weren't kept, the tempo, network and power.

For: anyone using the unit, before reaching for Troubleshooting

Breadboard Guide

A picture-by-picture guide to prototyping the whole controller on three breadboards: the ESP32, the motor driver, the panel, the lighting and an optional fan, with a wire table and a test at each step.

For: beginners prototyping before the PCB arrives

Live, LEDitor and settings demo

The unit's own Live control, LEDitor and settings pages working in a browser with no turntable: start and stop the platter, set the tempo, change presets and palettes, use both editors on the real LED engine's output, and look through every settings tab as a unit comes. One file, no internet needed; nothing is kept after a reload.

For: anyone trying the controls or designing presets away from the unit

Reading the HTML on GitHub? GitHub shows .html files as source. Use the Markdown links, or clone the repository and open the HTML in a browser. The unit itself also serves the User Guide, the Hardware Overview and the FAQ at /docs/USER_GUIDE.html, /docs/HARDWARE_OVERVIEW.html and /docs/FAQ.html, with no internet needed.

Reference

Markdown documents. The README is the short design reference; the detailed README keeps the reasoning behind the choices; the changelog is the history.

DocumentWhat it coversFormat
READMEShort design reference: hardware, firmware pinout, OSC and web APIs, design notes, building and flashing, testing, board notes, heat, open items, repository layout.
README (detailed)The full design discussion with the reasoning behind each decision.
ChangelogDated record of design and firmware changes, newest first.
Documentation buildRebuilds the two HTML guides and the copy embedded in the firmware from their Markdown (python docs/build_docs.py).

Fixture files

For driving the ring from lighting software over Art-Net or sACN (the unit's Art-Net / sACN effect). Pick the file and mode that match Layout on the unit's Art-Net settings; the User Guide's lighting section says how each is used.

FileWhat it is forDownload
GDTF fixtureLighting consoles and visualisers (grandMA3, ETC Eos, ChamSys MagicQ, Avolites Titan, Onyx, Vectorworks, Capture). A mode for each layout: 2 universes (178 pixels), 1 universe (170 elements) and Grid (31 x 15 over three universes); each pixel at its place on the ring.
Resolume ArenaThe Grid layout as one fixture (31 x 15 RGB pixels) and an Advanced Output setup with it in one slice over the ring. The fixture goes in Documents/Resolume Arena/Fixture Library, the setup in Presets/Advanced Output.

Hardware design files

Schematics, PCB outputs and the JLCPCB order files for the two boards. KiCad sources (.kicad_sch, .kicad_pcb) are in each board's folder.

Main board (kicad_mainboard/)

ItemWhat it isFiles
SchematicAll five sheets (power, controller, motor, LED, panel IO), rendered.
PCB rendersTop and bottom views of the routed board.
Check reportsLatest electrical-rules and design-rules runs.
JLCPCB order notesPart numbers, library types, orientation checks and the dated order history.
Assembly cost comparisonSMD-only against full (SMD and through-hole) assembly.
BOM, placements and costBill of materials and placement files for JLCPCB, and the priced BOM.

LED ring board (kicad_led_ring_offset/)

ItemWhat it isFiles
Schematic and PCB178 SK6812 LEDs in an offset (brick) matrix, 203 mm square.
Check reportsLatest electrical-rules and design-rules runs.
JLCPCB order notesPart numbers, the placement-import finding and the order history.
Assembly cost comparisonSMD-only against full assembly.
BOM, placements and costBill of materials and placement files, and the priced BOM.

Enclosure and mechanics

Drafts for the case and the motor mount. None of it is built or tested yet.

ItemWhat it isFiles
Motor mount and box layoutSuggested 14.2 x 11.1 in layout, the height stack, the aluminium motor plate on standoffs, the inset aluminium backplate (grooved in for leak protection), the ring heat plate, earthing and the assumptions to check.
RendersPlan view, exploded 3D view, backplate close-up and the mount.
OpenSCAD sourcesParametric models for the layout and the motor mount.
Tinkercad and cutting filesA page with a ZIP of everything and one closed-mesh STL per part of the case and mount, plus the motor plate, backplate and ring heat plate outlines as SVG and DXF for cutting. export_stl.py regenerates and checks them.

Diagrams and screenshots

Diagrams (SVG)

DiagramWhat it showsFile
Power flow12 V and 5 V supplies through the fuses and protection to the motor rail, the regulator and the LED ring.
Signal flowThe processor, the motor driver, the expander, the LED ring's data and clock through their buffers, and the panel controls.
One-universe Art-Net pairsThe ring from the front with the eight pairs of LEDs that share an element in the one-universe Art-Net layout, and the channels each takes; hover over an LED for its address.

Web page screenshots (PNG)