Uncle Magic's Liquid Turntable: User Guide#
A motorized platter that turns in time with your music and glows in any colour you choose. Tell it the tempo (from your show software, or by tapping a button), and the platter turns at a speed that matches the beat while a ring of LEDs lights it. Everything can be driven from the knobs on the panel, from a phone or laptop, or from show-control software.
For how the unit is built, see the Hardware Overview.
1. Quick start#
- Check the connections, with the power off. The motor cable, the LED ring cable and the panel controls are plugged in, and the network cable is connected (or you have Wi-Fi set up, see section 8).
- Switch on. The unit starts stopped: the platter does not move and the LEDs show the user colour solid (preset 1: white at full brightness unless you changed it). This is normal.
- Start the platter. Turn the main knob clockwise a few clicks. The platter begins to turn and speeds up smoothly. (Or press Start on the phone page, below.)
- Give it a tempo. Tap the TAP button in time with the music four times or so. The platter settles to a speed that matches your taps. (If your show software is already sending tempo, the platter follows that and you don't need to tap.)
- Pick a colour. Turn the HUE knob to choose a colour, SAT for how rich it is, and VAL for how bright.
- Stop. Turn the main knob down to zero, or press it while the platter is already at its home speed (below). The platter slows to a stop.
To control it from a phone, open http://liquidturntable.local/live in a browser on the same network. If that address doesn't work, see section 6.
2. The panel#
| Control | Turn | Press |
|---|---|---|
| Main knob (speed) | Changes speed. Each click is 1% of full tempo speed. Turning past zero reverses the platter. | Short press: jumps to the home speed. Press again while at home to stop. Hold 1 second, then release: the current speed becomes the new home. Hold 5 seconds: home goes back to the factory value (full tempo speed, forward). |
| HUE knob | Turns every colour round the colour wheel (the hue shift). 120 clicks make one full trip. | Hue shift back to 0 (the presets' own colours). |
| SAT knob | How rich the colours are (0% = white, 100% = as the preset draws them), 1% per click. | Toggles white. The first press makes the light white; the next press puts the colours back as they were. |
| VAL knob | Picks the preset (it starts doing this), or, after a press, changes brightness, 1% per click. | Switches the knob between picking presets and brightness. |
| TAP button | Sets the tempo by tapping (see section 4). |
The panel has connections for three more knobs (EXP1-EXP3). Two of them work on the presets:
| Control | Turn | Press |
|---|---|---|
| EXP1 knob | Picks the palette: 0 (the preset's own) up to 11, or up to your last own palette (12-19), wrapping | Palette back to 0 |
| EXP2 knob | Effect speed: 8 clicks double it (or halve it, turning down), from a quarter of the preset's speed to four times it | Back to the preset's own speed |
| EXP3 knob | Not used yet | (no button on this header) |
Both carry over when you pick another preset, as the hue shift and saturation do. A preset with a speed of 0 stays still whatever EXP2 says.
3. Running the platter#
How fast does it go?#
The platter turns one revolution every 12 beats. So the tempo sets the speed:
| Tempo (BPM) | Time for one revolution | Platter speed |
|---|---|---|
| 60 | 12 s | 5 RPM |
| 90 | 8 s | 7.5 RPM |
| 120 | 6 s | 10 RPM |
| 140 | 5.1 s | 11.7 RPM |
| 170 | 4.2 s | 14.2 RPM |
| 204 and above | 3.5 s | 17 RPM (the limit) |
The table is at 100% speed. The limit of 17 RPM is on the platter's speed itself, after the speed setting: at 50% the platter turns at half the tempo's speed, so it stays in time with the beat up to about 408 BPM (300 BPM at 50% is 12.5 RPM). Whenever the tempo and the speed setting together ask for more than 17 RPM, the platter stays at 17 RPM, out of time with the beat, and the phone page shows a warning.
The speed knob#
The main knob sets how much of that tempo speed you want, from 0% to 100% either way:
- 100% turns the platter in time with the music.
- 50% turns it at half that speed.
- Zero stops it. Turning the knob past zero reverses the platter: it slows down, stops, and turns the other way.
- The platter never turns slower than a minimum speed (about 0.6 RPM). Below about 1% on the knob it stops; from about 2% it turns at that minimum and speeds up from there.
Smooth starts, stops and changes#
The platter is heavy, so every change of speed is eased in: starting, stopping, changing tempo, turning the knob, and reversing. From a standstill to 10 RPM takes about a second, and a stop from top speed takes about a second and a half. A reversal slows down, turns round and speeds up again without the motor ever switching off.
Reverse direction (setting)#
If "clockwise" turns the platter the wrong way, tick Reverse motor direction on the settings page (see section 6). This is remembered.
4. Tempo: how the platter knows the beat#
The unit takes its tempo from the first of these that is available:
- Show software over the network (OSC
/bpm). The normal way to run a show. - A tempo-controller feed (such as the tempo slider in Resolume). Used if the first is missing.
- Tapping. Used when neither of the above is sending.
Tempo only changes the speed. It never starts or stops the platter: that is always your decision, with the knob or the phone page.
Tap tempo#
Tap the TAP button, or press Tap on the phone page, in time with the music.
- The first tap just starts the count. From the second tap the tempo is set from the average of your last four taps.
- Taps more than 15 seconds apart start a fresh count.
- Valid tempos are 20 to 500 BPM.
- Tapping only changes the tempo while no show software is sending one. Every tap still sends a "tap" message on the network, so other equipment can follow it.
- On the tapped tempo, each tap is a beat. The unit counts beats itself at the local tempo (four to the bar), and each tap puts the beat where you tapped, so punch and the pulse hit on your taps. When show software stops sending, the unit carries on counting from its last beat at the same tempo, so the lights don't jump.
On the phone page, the line under the tempo tells you where it is coming from: from OSC /bpm, from OSC tempo controller, or local (tap / set).
Starting tempo#
When the unit switches on it uses a starting tempo (120 BPM until you change it on the settings page) until it hears something better.
5. Lighting#
The LED ring always runs one of the unit's presets: an effect (what moves, or nothing for a still colour) drawn with a palette (its colours). Preset 1, which the unit starts on, is the user colour: one colour, still. It is built in and can't be saved over, so it is always there to fall back on. The unit drives the ring itself (its LED engine), about a hundred times a second, so a change shows at once.
On top of whatever the preset draws:
- Hue shift (the HUE knob) turns every colour round the colour wheel; 0 shows the preset's own colours. Preset 1, the user colour, is white as the unit comes, and white has no hue, so there HUE and SAT change nothing until you pick a colour (the live page's colour picker, or the starting colour on the settings page). With the user colour red, the hue shift simply is the colour: turning HUE sweeps the whole wheel.
- Saturation (the SAT knob) fades every colour towards white: 100% is as the preset draws it, 0% no colour at all.
- Brightness (the VAL knob, after a press of its button) is the overall brightness. Each click is an even step to the eye, all the way down: the ring dims smoothly to a faint glow rather than in visible jumps (half way round the knob is about a fifth of the full light). Turning it down also lowers the power the ring draws.
- At switch-on the unit shows preset 1, and the user colour is the starting colour from the settings page (white at full brightness unless you change it); the hue shift is 0, saturation 100% and brightness full. The live page's colour picker changes the user colour. The ring stays dark for the first second or two while the unit starts up.
- Colour temperature (settings page) shifts the whole light warmer or cooler, like a filter: neutral is 6500, lower is warmer and more orange, higher is bluer. It is handy for making white look like tungsten or daylight, and it also tints every other colour the same way.
- The ring's settings (LED type, power limit, wiring) are on the LEDs tab of the settings page; see The LED engine. They are set correctly as delivered.
Presets and the knobs#
| Control | Turn | Press |
|---|---|---|
| VAL knob | Picks the preset, 1 up to the highest in the preset list, wrapping round at the ends; after a press, brightness | Switches between presets and brightness |
| EXP1 knob | Picks the palette, 0 (the preset's own) up to 11, or up to your last own palette (12-19), wrapping | Palette back to 0 |
| EXP2 knob | Effect speed, a quarter to four times the preset's own | Back to the preset's own |
| HUE knob | Hue shift: every colour round the colour wheel | Hue shift back to 0 |
| SAT knob | Saturation: 100% as drawn, down to white | White on and off |
- Twenty-three presets come built in (pictures and a table below); edit or add to them on the LEDs tab or in the LEDitor.
- The palette overrides the preset's own palette: whatever palette number is chosen is the one used. Palette 0 keeps the preset's own. The palettes are listed below.
- The VAL knob starts on presets each time the unit starts. Press its button to dim or brighten, and again to go back to picking presets.
- The hue shift, saturation, palette and effect speed carry over when you pick another preset.
- None of this is remembered across a restart: the unit starts on preset 1, palette 0, hue shift 0, saturation 100%, full brightness.
- The live page's Effects box has lists for the preset and palette, an effect speed slider and the running preset's own settings, and its Light box the user colour picker and sliders for the rest, and OSC has
/preset,/palette,/fxspeed,/look,/hue,/saturationand/value(section 7). - Changing the preset or palette crossfades over half a second: the old look keeps moving as it fades out under the new one.
- Before 2026-11-15 the HUE button switched to a colour mode that showed one colour. Preset 1 does that job now: with the user colour set to red (the factory colour until 2026-11-16; it is white now), the hue shift and saturation give exactly the colours colour mode did.
The LED engine#
The unit drives the ring itself: there is no separate lighting controller. Its settings are on the LEDs tab of the settings page (/leds opens it too): what is running, the ring settings, and the preset list. As delivered it is set for this ring (178 SK9822 LEDs, data and clock wires, a 4.5 A limit), so there is nothing to set up.
What the engine does:
- Presets and palettes: the effect and its colours, picked with the VAL and EXP1 knobs, the live page or OSC. The presets and palettes each have a table below.
- Hue shift, saturation and brightness on top of every preset, the colour temperature, and each preset's punch, which hits on the beat (it took the place of the beat flash), which happens in the unit with no delay.
- Power limits: each LED is held to 36.6 mA, so single colours run at the LEDs' full output while white is held to the maker's recommended level. The engine also estimates the ring's current every frame and dims the whole ring evenly if it would draw more than 4.5 A, the most the supply and the case's cooling allow. Both are on the LEDs tab.
- Ring temperature (boards with the ring's temperature sensor): a thermistor on the LED ring turns the fan up first, and only once the fan is at full speed does the ring's current limit come down, so a hot ring dims a little rather than overheating. See The ring's temperature.
Effects. Each preset has an effect, a palette, a speed and an intensity (0-255, the effect's main shape control):
| Effect | What it does | Intensity |
|---|---|---|
| solid | One colour; with a speed, it fades through the palette | (none) |
| palette | The palette spread round the ring and turning at the speed, as every effect turns (so with Turns per platter it turns with the platter); at spread 0 the whole ring fades through the palette instead | Spread: 0, the whole ring one colour; 255, the palette once round the ring |
| wipe | A front goes round laying the next colour over the last (count colours from the palette) | Softness of the edge |
| sweep | A bright head turning round the ring with a fading tail; count heads, evenly spaced | Tail length |
| segments | count arms turning together, soft edges | Arm width |
| spiral | count arms (up to 6) bent from the centre outwards, turning the way the platter turns (see Spirals follow the platter). width sets how wide the arms are against the dark between them. The ring is only about six LEDs deep and 12 round at its inner edge, so more arms run together and more twist breaks the curve into dots: a preset asking for more shows as 6 arms and one turn | How much they twist: 0 to 128 is straight to one turn from the centre to the edge (the editors show it in turns); above 128 is one turn |
| pulse | A ring of light leaves the centre on every beat (or every 2nd to 16th beat: every); count rings at once, evenly spaced; inward brings them in from the edge | Width of the ring |
| noise | Soft, slowly changing blobs of the palette that turn with the speed and keep changing shape (over about two bars, even at speed 0; churn makes that faster or slower). count repeats the pattern round the ring, like a kaleidoscope. width sets how much is lit: low leaves scattered islands, high lights nearly everything | Detail: 0 is a few big soft areas, 255 many small ones |
| ripples | count rings across the ring, flowing out from the centre (in, with a negative speed), coloured from the centre out. width sets how wide they are against the dark between them | How much they fade towards where they go |
| sparkle | LEDs light at random and fade. The speed is how often each LED gets a chance (4 per bar: four times a bar); a negative speed fades them in instead. width is how long they glow, from a glint to a slow fade | How many sparkle: 2% to 62% of the LEDs at each chance |
| strobe | The whole ring flashes count times a platter turn, each time the platter reaches the next of count places, so marks on the platter look still or slowly crawl (see Strobe). Dark while the platter stands still. width is how long each flash lasts, 4 to 40 ms | (none) |
What the ring can show. The ring is 178 LEDs about 7 rows deep from the inside out, about 13 round at its inner edge, 25 half way out and 45 at the outer edge. A pattern that repeats needs a few LEDs per repeat to show (about 4 to look clean), so each effect's count stops where it still does, and the editors' sliders stop there too:
| Effect | Count (what it counts) | Most |
|---|---|---|
| segments | arms round the ring; with radial, bands from the centre out | 12; 3 |
| sweep | heads; with radial, heads from the centre out | 6; 3 |
| spiral | arms (and the twist: one turn) | 6 |
| noise | repeats round the ring | 6 |
| ripples, pulse | rings | 3 |
| wipe, strobe | colours, flashes a platter turn (these repeat over time, not across the ring) | 24 |
A preset line asking for more still reads, and draws at the most; the editors then show the most, and saving writes it.
Lit width. For segments, sweep and pulse, intensity is already the width of the lit part. For spiral, ripples and noise, where intensity does something else, the separate width setting (0-255, 128 as delivered) sets how much is lit and how much is dark. For sparkle it is how long each sparkle glows, and for strobe how long each flash lasts.
Drift moves the pattern's zero point round the ring, in turns per bar, beat or platter turn (the same unit as the speed). Without it some things stay put: the place where a wipe starts each new colour, the way the palette lies round the ring under a sweep, the join in a palette that doesn't loop. With a little drift (try 0.0625 to 0.25) they travel. For effects that simply turn (segments, spiral, noise) drift just adds to the speed.
Bounce (bounce=1, the Bounce box in the preset editor) runs the motion out and back instead of round and round: one turn forward at the preset's speed, then the same turn back, and again. The first leg turns the way the speed's sign says. What it does to each effect:
| Effect | With bounce |
|---|---|
| sweep | A pendulum: the head swings round and back, its tail always trailing |
| segments, spiral | The arms rock forward and back; a spiral winds up and unwinds |
| solid, palette at spread 0 | The colours run to the end of the palette and back, so a palette that doesn't loop (lava, heat) never jumps from its end to its start |
| palette (spread above 0) | The spread palette rocks forward and back |
| wipe | Wipe on, then off: the next colour is laid over the first and taken back off again, a different one each time if count is above 2 |
| pulse | Heartbeat: the ring leaves the centre on a beat, reaches the edge on the next and is back at the centre on the one after (the centre on beats 1 and 3 of a bar), slowing as it turns. effect=heartbeat in a preset line is the same as effect=pulse bounce=1 |
| noise | The turning rocks; the shapes keep changing forward |
With a speed of 0 nothing moves, so bounce does nothing, except for pulse, which follows the beat.
Spirals follow the platter. A spiral always turns the way the platter is turning, and its arms curve back from that motion, their outer ends lagging behind like a whirlpool's. For a spiral the speed's sign means with the platter (positive) or against it (negative), whether it is timed to the bar, the beat or the platter. When the platter reverses, the arms slow, straighten, and bend and turn the other way over about five seconds; while the platter is stopped they keep the curve and direction it last had (at switch-on, the way the platter is set to turn).
Trail (trail=, the Trail slider in the preset editor; spiral only) leaves a glow behind each arm that lasts that long, 0.01 to 2.55 seconds (trail=80 is 0.8 s; 0, as it comes, is no trail). The trail is as long as the arms travel in that time, so it follows how fast they really turn: longer when they are fast, shorter when they slow, and gone while they are still. It is always behind them, whichever way they go. With Turns per platter the arms are locked to the platter, so the trail follows the platter's speed, and when the platter reverses it shrinks to nothing as the platter stops and grows again on the other side. With the platter at 17 RPM, two arms and trail=80, each trail fills about half the gap to the next arm; it never reaches the next arm.
A sweep or wipe locked to the platter (Turns per platter) also keeps its tail, or the colour it lays, on the side the platter is really turning, including after the platter reverses.
Colours (paint=, the Colours list in the preset editor) changes how an effect with dark parts picks its colours. its own (auto, as it comes) is the effect's usual way. angle runs the palette round the ring and radius from the centre out, for any of them. arm gives each arm (spiral), head (sweep), ring (ripples, pulse) its own colour from the palette, carried with it as it moves. tail (sweep) runs the palette down each tail from the head, like a comet. Only the choices an effect can use are listed for it.
Punch (punch=0-255, every effect; the Punch rows in the preset editor) makes the picture hit on the beat: full on the beat and dimmer between. It took the place of the old beat flash, so each preset now has its own. 0, as it comes, is none. Three settings shape it (shown once Punch is above off):
- Style (
punchstyle=): swell (as it comes) eases back over its length, and the arms, heads, rings and sparkles widen on the beat; between beats the picture is down to a quarter at 255. flash is full for its length, then straight back, like the old beat flash; at 255 the ring is dark between flashes. - Length (
punchlen=): 1/2 (as it comes), 1/4, 1/8, 1/16 or 1/32 of a beat, so it keeps step with the tempo (at 120 BPM 1/32 is 16 ms and 1/2 is 250 ms). A hit is never shorter than 12 ms, so the ring always shows it. - Every (
punchevery=): every beat (as it comes), or every 2nd, 3rd ... 16th beat. It counts beats on from switch-on and isn't tied to the bar, so any number works (11 hits every 11th beat).
It follows the tempo the unit is running at, pulled onto the show software's beats when they arrive, so it lands on the beat; with a tapped tempo it hits on the tapped beats too.
Radial (radial=1; palette, wipe, segments and sweep) runs the pattern out from the centre instead of round the ring: the palette in rings, a wipe as a growing circle, segments as bands, a sweep as heads flowing outwards. A positive speed moves it out, a negative one in, and count is how many across the ring.
Steps (steps=1, timed to the bar or beat) makes the pattern stand still through each beat and jump on it, as far as it would have turned in that beat (the jump takes the first 15% of the beat, so it isn't a hard cut). Four arms at speed 1 per bar step one arm's place each beat. It does nothing to a pattern locked to the platter or bouncing.
Churn (churn=0-255, noise) is how fast the noise changes shape, in hundredths of the usual: 100 as it comes (about two bars), 50 half as fast, 200 twice, 0 holds the shapes while they still turn with the speed.
Strobe. The ring flashes as the platter passes each of count places. With Turns per platter and speed 0 the places are fixed on the platter, so a printed disc or marks on it seem to stand still (a zoetrope); a small speed (0.01 to 0.05 per platter turn) makes them crawl forward or back. Timed to the bar or beat, the speed turns the places at that rate. Caution: it is a strobe. Fast flashes can trigger seizures in people with photosensitive epilepsy; warn your audience, and keep it brief and not too bright. The flashes are drawn at the ring's 100 frames a second, so they land within 10 ms of their place.
White background (bg=white, the Background box in the preset editor) fills the parts of a sweep, segments, spiral, pulse or noise pattern that would be off with white instead, so the pattern shows as colour on white. The white follows the colour temperature and VAL like everything else. The soft edges blend from the colour into white rather than into dark. A palette's own black (lava and heat start with it) stays black. A mostly white ring draws far more current, so the current limits may lower its brightness. Solid, palette and wipe have no dark parts, so the setting does nothing for them.
Speed is in turns per bar (4 beats), per beat, or per platter turn: speed 1 per bar goes round once a bar at the current tempo, and follows the beat when show software sends one; platter locks the pattern to the platter itself, so speed 1 turns with it. A negative speed turns the other way, 0 stands still.
The built-in presets#
The VAL knob (while it picks presets), the live page's Preset list and OSC /preset pick these by number. The pictures are rendered by the firmware's own effect code, at full brightness, seen from above through the platter. Each is one moment; the Animation links show two bars of each at 120 BPM, with the platter turning clockwise at 33 1/3 rpm. Presets with the user colour palette show the user colour (the live page's colour picker); they are shown in the factory starting colour, white.
| # | Name | Effect | Palette | Speed | Intensity | Count | What you see | Animation |
|---|---|---|---|---|---|---|---|---|
| 1 | User colour | solid | usercolour | 0 | Your colour, still | 1 | ||
| 2 | Rainbow ring | palette | rainbow | 0.25 per bar | 255 | The rainbow once round the ring, a quarter turn a bar | 2 | |
| 3 | Party fade | palette | party | 0.125 per bar | 0 | The whole ring one colour, fading through the palette every 8 bars | 3 | |
| 4 | Sweep | sweep | usercolour | 1 per bar | 90 | A head in your colour with a tail a third of the ring long, once round a bar | 4 | |
| 5 | Two arms lava | segments | ember | 0.5 per bar | 120 | 2 | Two wide arms, dark red and orange-red, half a turn a bar | 5 |
| 6 | Four arms ocean | segments | ocean | -0.25 per bar | 90 | 4 | Four arms, a quarter turn a bar, backwards | 6 |
| 7 | Rainbow spiral | spiral | rainbow | 0.25 per bar | 128 | 3 | Three arms twisted one turn from the centre out, turning with the platter | 7 |
| 8 | Beat pulse | pulse | unit | 0 | 60 | A ring in your colour leaves the centre on every beat | 8 | |
| 9 | Wipe red blue white | wipe | red/blue/white | 1 per bar | 40 | 3 | A new colour sweeps round each bar | 9 |
| 10 | Platter 12 arms | segments | unit | 1 per platter turn | 60 | 12 | Twelve spokes that turn with the platter | 10 |
| 11 | Fire spiral | spiral | heat | -0.5 per bar | 128 | 2 | Two arms twisted one turn, dark at the centre to white at the edge, turning against the platter | 11 |
| 12 | Forest drift | palette | forest | 0.0625 per bar | 128 | Half the palette round the ring, once round every 16 bars | 12 | |
| 13 | Cloud sweep | sweep | cloud | 0.5 per beat | 200 | A long-tailed head, half a turn a beat | 13 | |
| 14 | Rainbow pulse | pulse | rainbow | 0.25 per bar | 120 | A wide ring on every beat, its colour drifting through the rainbow | 14 | |
| 15 | Stripe wipe | wipe | stripes | 0.5 per bar | 0 | 8 | A hard-edged new colour every two bars, eight in turn | 15 |
| 16 | Slow colour fade | solid | rainbow | 0.125 per bar | The whole ring through the rainbow every 8 bars | 16 | ||
| 17 | Lava noise | noise | lava | 0.0625 per bar | 90 | 1 | Soft blobs drifting slowly and changing shape | 17 |
| 18 | Ocean kaleidoscope | noise | ocean | -0.125 per bar | 140 | 5 | A five-fold pattern, slowly backwards, changing shape | 18 |
| 19 | Platter noise | noise | party | 1 per platter turn | 120 | 3 | A three-fold pattern that turns with the platter, changing shape | 19 |
| 20 | Ocean ripples | ripples | ocean | 0.5 per bar | 120 | 3 | Three rings flowing out from the centre, fading as they go | 20 |
| 21 | Party sparkle | sparkle | party | 4 per bar | 110 | Party colours glinting at random and fading, swelling on each beat (punch 120, width 170) | 21 | |
| 22 | Platter strobe | strobe | usercolour | 0 per platter turn | 12 | Twelve flashes a platter turn, locked to the platter, in your colour (width 60: 12 ms flashes). Dark while it stands still | 22 | |
| 23 | Art-Net / sACN | artnet | What lighting software sends over Art-Net or E1.31 (offered while receiving is ticked on the Art-Net tab); dark until something arrives | 23 |
An empty cell means the effect doesn't use that setting. The animations open from the project's files (or the published docs), not from the unit's own copy of this guide. The pictures are made by docs/presets/make_preset_images.py; run it again after changing a preset or an effect.
Palettes#
A palette is the set of colours an effect draws with. Every preset names one; the EXP1 knob, the live page's Palette list and OSC /palette swap it for another by number, and 0 gives the preset's own back.
| # | Name | Colours | Notes |
|---|---|---|---|
| 0 | (preset) | Whatever the preset names | The knob's resting place; not a palette you can put in a preset line |
| 1 | usercolour | One colour, the user colour: the live page's colour picker sets it, and the settings page's starting colour is what it starts as | Shown as user colour. Effects become that colour and dark; the hue shift and saturation act on it as on any colour. It was called unit, and was palette 2; an older preset line with palette=unit reads as this one |
| 2 | redbluewhite | Red, blue and white, blended in a loop | Shown as red/blue/white. It was palette 1 until 2026-11-15. It replaced colours, which took each preset's own three colours; an older preset line with palette=colours reads as this one |
| 3 | rainbow | The full colour wheel | Good on everything |
| 4 | stripes | The rainbow's colours with black between each | Gives the palette and wipe effects hard bands |
| 5 | party | Purple, pink, red, orange and yellow, to blue | No green; warm and saturated |
| 6 | ocean | Dark and mid blues, sea green, aqua and pale blue | |
| 7 | lava | Black and dark red, with a short run of red, orange and white | Mostly dark: the bright part is a small share of it. With segments or wipe, the first colour is black |
| 8 | forest | Dark to bright greens with olive and aqua | |
| 9 | cloud | Deep blue, sky blue and white | |
| 10 | heat | Black through red, orange and yellow to white | A ramp, not a loop: it jumps from white back to black where it wraps. With segments or wipe, the first colour is black |
| 11 | ember | Dark red, orange and red, blended in a loop | Warm, with no black: both arms of a two-arm preset stay lit |
| 12-19 | user1 to user8 | Your own palettes, made with Save as new in the palette editor | The knob and the phone page go up to the last one in use. A preset naming an empty one shows red/blue/white |
Which part of the palette shows where depends on the effect: palette and solid move through it over time or round the ring, wipe steps through count evenly spaced colours, segments gives each arm one of count evenly spaced colours, sweep lays it once round the ring and lights the part under the head, spiral and ripples run it from the centre outwards, pulse takes one colour that drifts through it with the speed, noise and sparkle scatter all of it, and strobe gives each of its places one of count evenly spaced colours. Colours (paint=, above) changes that for most of them. Palettes 3 to 10 are FastLED's standard palettes.
All ten built-in palettes (2 to 11) can be changed with the palette editor on the LEDitor page: their names and numbers stay, so every preset, the EXP1 knob and OSC use the new colours. The table and the picture above show them as they came, and Reset to factory puts them back. The editor's Save as new makes palettes of your own in eight more slots, 12 to 19.
Editing presets#
The LEDs tab shows the preset list as text, one preset per line, for example:
4 effect=sweep palette=usercolour speed=1 unit=bar intensity=90 name=Sweep
| Key | Values | If left out |
|---|---|---|
| (the number first on the line) | 2 to 64: the preset's place on the knob (1 is built in, the user colour: a line numbered 1 is skipped) | Required |
effect | solid palette wipe sweep segments spiral pulse noise ripples sparkle strobe artnet (and heartbeat, see Bounce) | solid |
bounce | 1 (out and back) or 0 | 0 |
trail | 0 to 255: spiral only, the glow behind each arm in hundredths of a second (see Trail) | 0 (none) |
palette | redbluewhite unit rainbow stripes party ocean lava forest cloud heat ember, your own user1 to user8, or its number 1 to 19 | redbluewhite |
speed | -16 to 16 turns per unit; negative is backwards, 0 is still | 0 |
unit | bar (4 beats), beat or platter | bar |
intensity | 0 to 255: the effect's shape control (see the effects table) | 128 |
count | 1 to 24: arms, heads, rings, wipe colours, strobe flashes a platter turn, or the noise pattern's repeats. Each effect shows at most what the ring can (see What the ring can show); more reads, and draws as that | 1 |
width | 0 to 255: how much is lit against dark (spiral, ripples, noise), how long a sparkle glows, how long a strobe flash lasts | 128 |
drift | -16 to 16 turns per unit that the pattern's zero point moves | 0 |
bg | black or white: what the dark parts of the pattern show | black |
paint | auto angle radius arm tail: how its colours are picked (see Colours) | auto |
punch | 0 to 255: how much it hits on the beat (see Punch) | 0 (none) |
punchstyle | swell or flash | swell |
punchlen | 2, 4, 8, 16 or 32: each hit lasts 1/that of a beat | 2 |
punchevery | 1 to 16: which beats hit (every that many, counted on) | 1 |
radial | 1 (out from the centre) or 0: palette, wipe, segments, sweep | 0 |
steps | 1 (move on the beat) or 0 | 0 |
every | 1 to 16: pulse, a ring every that many beats | 1 |
inward | 1 (from the edge in) or 0: pulse | 0 |
churn | 0 to 255: noise, how fast it changes shape in hundredths of the usual | 100 |
hflip, vflip | 1 or 0: artnet, the network's picture mirrored left-right, or top-bottom, as the pages' pictures show the ring (both: half a turn), before it turns | 0 |
name | Up to 23 characters, to the end of the line, so put it last | No name |
A line starting with # is a comment. The highest number in the list is the top of the VAL knob's preset list; a number you skip shows your colour-mode colour. The preset editor on the LEDitor page does the same with sliders and a live preview. Save & Reboot (at the bottom of the page, the same button for every tab) checks every line first and refuses the whole save, naming the line, if one can't be read. Tick Restore the built-in presets before saving to put back the 23 it came with. A firmware update never replaces your list, so new built-in presets appear only after a restore (or copy their lines from the table above into your list).
Lighting software can also drive the ring over the network, through its Art-Net / sACN effect: see Art-Net and sACN.
6. Controlling it from a phone or computer#
The unit has a small web server. You need a phone, tablet or computer on the same network.
Finding it#
Try these in order:
- Open
http://liquidturntable.local/. This works on Windows 10 and later, Macs, iPhones and iPads, and Linux. Some Android phones don't support it. - Look in your router's list of connected devices for
liquidturntableand open that address (for examplehttp://192.168.1.50/). - As a last resort, connect a USB cable to the controller board and read its log: it prints "ETH got IP" or "Wi-Fi got IP" followed by the address.
If one browser on a phone reaches the unit and another doesn't (Android Chrome typically shows ERR_TOO_MANY_RETRIES), that browser isn't allowed onto your home network: newer Android asks each app for it. Open the phone's Settings → Apps → Chrome → Permissions (or the app concerned) and allow Nearby devices (called Local network on some phones).
The menu#
Every page the unit serves (live control, the LEDitor, the settings, the log, firmware update, Wi-Fi setup and these documents) has the same bar at the top, on one line:
| Item | What it opens |
|---|---|
| Live | The live page |
| LEDitor | The LEDitor: the ring picture and the preset and palette editors |
| Settings ▾ | A list: the settings page's tabs (Status, Network, Show, Colour, LEDs, Motor and fan, Password), then Backup, Firmware update and Wi-Fi setup |
| Help ▾ | A list: the User guide, the Hardware overview, the FAQ, the Log and About (the firmware build, the copyright and the licence) |
| OSC address:port (at the right) | Not a link: the unit's address and OSC port, for example OSC 10.1.10.86:3335, which is where show software sends its messages. On the live page it reads offline in orange while the page can't reach the unit. |
| Others ▾ | The list of turntables on this network: this one first, then every other one it finds, each with its address, OSC port and firmware build, tagged older firmware for one that doesn't say its build and newer build for one running newer firmware than this one. Pick one to open the same page on it. Finding them takes a couple of seconds the first time (Looking for others…); Search again looks once more. Each turntable has its own password, so the browser may ask for it. |
The page you are on is underlined (Settings or Help when it is one of theirs). Opening one list closes the other; a click anywhere else closes it. On the setup network (while you are first putting the unit on Wi-Fi) only the Wi-Fi setup page exists, so it has no menu.
The live page (/live)#
Open http://liquidturntable.local/live. It is made for a phone and refreshes about once a second.
The page is four boxes, each with a purple pill for its title that folds it away and opens it again (▾ open, ▸ folded): Turntable (folded at first), Light (the colour), Effects (what the ring does) and Tempo. What arrives over Art-Net and E1.31 is on the settings page's Status tab. Tempo shows a short view, the essentials, until you press more beside its title; less goes back. To put the boxes in another order, drag one by the grip (⋮⋮) at the left of its title, with the mouse or a finger (on a touch screen the grip is a bigger target, and the page scrolls when you take a box near the top or bottom). In a wide window the boxes go into columns, as many as fit (up to four), and a box can be dragged into any of them. Each width keeps its own arrangement, so arranging the columns on a computer leaves your phone's order as it was. This browser remembers all of it; a box added in a later firmware turns up after the box it follows on the page. The unit's address and OSC port are on the menu bar.
| Item | What it does |
|---|---|
| Turntable box | Open, the LED ring as the unit is sending it, about 15 times a second, with the platter's edge turning (the LEDitor has its own picture); folded, nothing is fetched. It is what the ring gets, with the brightness and colour temperature, but before the current limits, which only the ring itself is held to: white (which the limits hold back most) can look brighter here than on the ring. The LEDitor's picture shows the presets as written instead. This browser remembers whether it is open. |
| Light: Hue shift / Saturation / Brightness sliders | On top of every preset: hue shift turns every colour round the wheel (in degrees), saturation fades them towards white, brightness dims everything. |
| Light: User colour picker | The one colour of the user colour palette (palette 1), which preset 1 shows. Lasts until a restart; it starts as the settings page's starting colour. |
| Light: Colour temperature slider | Warms or cools the whole light, 2000 to 10000 K (6500 = no change). Like the other colour controls, it holds until the unit is restarted, when it returns to the setting on the settings page. |
| Effects: Preset and Palette lists | Pick the preset and palette, each shown as number: name. Palette 0 is the preset's own. |
| Effects: Effect speed slider and 1x | The same as the EXP2 knob: runs the preset slower or faster than it is written, from a quarter (0.25x) to four times (4.00x), in the knob's steps (8 to a doubling). It carries over when you pick another preset; 1x puts it back to the preset's own speed. A preset with a speed of 0 stays still. A preset set to Turns per platter is left alone, so it stays locked to the platter. Lasts until a restart. |
| Effects: effect settings | Open at first (fold it with its pill). The running preset's own settings, the same controls as the LEDitor's preset editor: change any of them and the ring shows it at once. changed here beside it says the ring is running your changes rather than the preset as saved. They last until a preset is picked (from this page, even the same one, the VAL knob or OSC); Back to the preset does that. To keep a look, give it a Name, pick the number in Save to and press Save: it replaces the preset with that number (asking first if there is one), and the ring then runs it; the list is written to memory the next time the platter stops. Its Palette is the look's own: choosing one there also puts the Palette list above back to 0, which otherwise overrides it. Its Speed is the preset's own; the Effect speed slider above multiplies it. OSC /look does the same from show software. |
| Tempo: the top line | The current BPM (big), the platter's actual speed in RPM, and the speed setting as a percentage with the direction. A warning under it says when the speed limit holds the platter back. |
| Tempo: Speed slider and Tap | The speed setting itself, -200 to 200%: 100% is in time with the tempo, 200% twice as fast, 0 stops the platter, below 0 it turns the other way; the speed limit still caps it. Tap is the same as the TAP button. |
| more: where the tempo comes from | from OSC /bpm, from OSC tempo controller or local (tap / set). |
| more: Start | Sets the speed to 100% (the platter eases up to it). |
| more: Stop | Stops the platter. |
| more: Slower / Faster | Changes the speed by 5%. These never cross zero, so they won't reverse the platter. |
| more: Reverse | Reverses direction (slows, turns round, speeds up). |
| more: BPM box + Set BPM | Types in a tempo (20 to 500). It holds until a show-software tempo arrives. |
| more: Speed limit box + Set limit | The fastest the platter is driven, in RPM, shown above the box. Holds until the next restart; the value it starts with is the Motor & fan tab's speed limit. |
| Bottom line | The Ethernet and Wi-Fi addresses and the Wi-Fi signal strength. |
The LEDitor#
The LEDitor is the LED page: a live picture of the LED ring, drawn in your browser from what the unit is sending to the LEDs, with the preset and palette editors under it. Open http://liquidturntable.local/leditor or choose LEDitor on the menu bar. It used to be called the simulator, at /sim; that address still leads here. It works with or without a ring connected, so you can try presets and palettes from anywhere on the network.
The page is three boxes, as on the live page: Turntable (the picture), Preset editor and Palette editor. Each folds away by the purple pill in its title, and they can be put in any order by dragging one by the grip (⋮⋮) at the left of its title, with the mouse or a finger. In a wide window they sit side by side in columns, as on the live page. This browser remembers both. If the unit stops answering, the address on the menu bar reads offline.
- It updates about 12 times a second; the ring itself updates 100 times a second, so fast patterns look smoother on the ring.
- The picture shows the presets and palettes as written: the hue shift, saturation and brightness (the knobs and the live page) and the current limits are left out, so it is always at full brightness. The colour temperature shows. The live page's Turntable picture is the one with all of those (but the limits) in.
- Each LED is drawn blurred, as the platter shows it.
- The edge round the picture turns with the platter, worked out from the motor's speed and direction: a tick every 10 degrees, longer ones every 90 and a violet mark. The unit has no sensor for where the platter is, so the violet mark is where the platter was when the unit was switched on, not a mark on the platter. A pattern set to turn with the platter (turns per platter) keeps its place against the edge.
- A screen can't show the LEDs' real brightness or colour. Use it for patterns and timing, not the final look.
The preset editor is under the picture. It builds a preset without typing its line:
- Pick the preset from the list, which shows every number as number: name (or (empty) where there is none yet); press Load to start from it, or keep your settings and save them to that number. Then choose the effect, palette, speed, intensity, count, lit width, drift, colours, punch (and its style, length and every), radial, steps, background and name (and for a pulse how often and which way, for noise the churn). The settings changed less often (drift, colours, churn, trail, punch, radial, steps, bounce, background) fold under more, which says how many of them are set while folded; this browser remembers whether it is open, and folded ones still count. Only the settings the chosen effect uses are shown, named for what they do there (for a spiral, intensity is Twist and count is Arms). A palette's colours are set in the palette editor below. The finished line shows under the controls.
- Tick Preview (at the top of the editor) to see it as you change it, in the picture and on the ring itself. The ring goes back to what it was showing a few seconds after you untick it or close the page.
- Press Save to this number. It is in use at once (pick it on the live page or with the VAL knob) and replaces any preset with that number. There is no restart. Number 1 is the built-in user colour: it can be loaded and copied, but not saved over.
The list is written to the unit's memory the next time the platter is stopped, so stop the platter before switching off or before using Save & Reboot on the settings page; otherwise the new preset is lost. A save from the editor rewrites the list without any comment lines you had typed into it.
The palette editor is under the preset editor. It changes the colours of the ten built-in palettes (red/blue/white, rainbow to heat, and ember) and makes palettes of your own, in eight slots, user1 to user8 (palettes 12 to 19):
- Pick the palette: a built-in one, or one of your palettes (an empty slot starts with three colours). The strip under it shows the palette as the effects use it, from its start round to its start again, and under that is the list of its colours, 1 to 16 of them, in order. One of your own also has a Name (up to 23 characters), shown in the editors and on the phone page.
- Change a colour with its swatch or by typing its hex value (
#rrggbb). + puts a new colour after it, half way to the next one; × takes it out; Add a colour puts one at the end. Drag a colour by its ⋮⋮ handle to move it (this works with a finger on a phone as well as with a mouse). - To see the changes on the ring before saving, tick Preview in the preset editor and give the preset this palette: Use it in the preset editor does that.
- Press Save palette to replace this palette's colours, or Save as new to keep this one as it is and put the colours in the first empty one of your palettes (it asks for a name, which can be left empty). Either is used at once everywhere the palette is: every preset that names it, the EXP1 knob, the live page and OSC. Like the presets, the palettes are written to the unit's memory the next time the platter is stopped. When all eight of yours are in use, delete one to make room.
Reset to factory puts a built-in palette back to its colours as it came (the Palettes table); for one of your own the button is Delete, which empties its slot (a preset naming it then shows red/blue/white until a palette is saved there again). Reset the built-in palettes does it for all ten built-in ones and keeps yours. All ask first and take effect at once. user colour is not in the editor: it is one colour, set on the live page.
Both editors keep what is in them in your browser, including changes that are not saved yet, so you can go to the live page (or close the page) and come back to find them as you left them. Preview stays on when you come back from the live page in the same browser tab; the ring shows the live controls while you are away.
The documents on the unit#
This guide, the hardware overview and the FAQ are stored in the unit itself, so they are there when you have no internet. Choose User guide, Hardware overview or FAQ in the menu's Help list (or go to http://liquidturntable.local/docs/USER_GUIDE.html). They are the same documents, in dark colours, and ask for the same password as the other pages.
The settings page (/)#
Open http://liquidturntable.local/, or choose a tab in the menu's Settings list. The page has seven tabs: Status, Network (with the OSC port), Defaults (the starting tempo, colour and colour temperature), LEDs, Art-Net, Motor & fan and Password; the Settings list opens each one, and the one showing is marked in it (the address ends in #status, #network and so on, so a tab can be bookmarked). It opens on Status. Each tab starts with its name as a heading, so you can see which one is open. The tabs are all one form: Save & Reboot, always at the bottom, stores every tab at once and restarts the unit (give it about 10 seconds). The two boxes marked applies at once on the Motor & fan tab (the slow-speed floor and the cooling fan) are the exception: they apply and save as you change them.
The (i) tips. The notes on how each setting works are behind a small round i beside a box's title or a setting's name, on this page and the others. Tap or click it to open the note, and anywhere else to close it.
Status tab#
The first thing you see. The Now box is a table of what the unit is doing: the tempo and direction, the Light (the preset and palette numbers, see Presets and the knobs, and the hue shift, saturation and brightness), the unit's name on the network, the Ethernet and Wi-Fi addresses (with the Wi-Fi signal strength), the main processor's temperature with the highest value since switch-on, the LED ring's temperature and the ring's current limit in force, the fan speed and tach state, and the firmware: the build's name and commit, and whether a newer build has been released.
The Art-Net / sACN box under it shows, once a second while the tab is open, what arrives on the Art-Net and E1.31 ports: whether receiving is on, the first universe (and its Net, SubNet and Universe), whether the ring is showing it (the Art-Net / sACN effect running), and for each universe arriving the protocol, the sender's address, the packet count, how long ago the last one came and whether this unit uses it (not for this unit means another universe; receiving is off means the box on the Art-Net tab isn't ticked). Other packets on the ports (ArtPoll, ArtSync, ...) are counted under it. It works even with receiving off, so a wrong universe shows at once. See Art-Net and sACN. Nothing on this tab can be changed.
Network tab#
| Setting | What it is for |
|---|---|
| Hostname | The unit's name on the network (liquidturntable unless you change it). Letters, digits and hyphens only. See several turntables. |
| Static IP, Gateway, Subnet mask | Leave the address at 0.0.0.0 to get one automatically (recommended). |
| OSC listen port | Where show software sends its OSC messages. Default 3335. It listens on both Ethernet and Wi-Fi; the menu bar shows the address and port. |
| Wi-Fi network name and password | A network to join, tried before the built-in ones. See section 8. The password box says none saved when there isn't one. Tick Open network for a network with no password (it clears the saved password). Left blank, with no built-in networks, Wi-Fi is switched off. |
The settings page, the live page, the log, firmware updates and OSC all answer on both Ethernet and Wi-Fi.
Defaults tab#
What the unit starts with at switch-on; the live page and OSC change them until the next restart. (It was the Colour tab, and the starting tempo was on a Show tab; links to #colour and #show open it. The beat flash that was there is each preset's punch now.)
| Setting | What it is for |
|---|---|
| Starting BPM | Tempo used at switch-on, until one arrives over OSC or is tapped or set on the live page. |
| Starting colour | The user colour at switch-on: the one colour of the user colour palette, which preset 1 (what the unit starts on) shows. A darker shade is dimmer, black is off. The live page's colour picker changes it until the next restart. |
| Colour temperature | The switch-on setting. Warms or cools everything the light shows. 6500 is neutral (no change), lower is warmer and more orange (candle is about 2000, tungsten lamps 2700 to 3200), higher is cooler and bluer, up to 10000. |
Art-Net tab#
Everything for driving the ring from lighting software over Art-Net or E1.31 (sACN); see Art-Net and sACN for how the ring takes it. Saved with the other tabs by Save & Reboot.
| Setting | What it is for |
|---|---|
| Receive Art-Net and E1.31, and offer the artnet effect | Off as the unit comes. Ticked, the unit uses what arrives on UDP 6454 (Art-Net) and 5568 (E1.31) for the Art-Net / sACN effect, offers that effect and its presets in the lists and on the VAL knob, and answers lighting desks' ArtPoll. Unticked, it still listens (the Status tab shows what arrives) but uses nothing. |
| First universe | Where the ring starts: Art-Net's port-address, counted from 0 (Net x 256 + SubNet x 16 + Universe); some programs count from 1. |
| Layout | How the software addresses the ring: Two universes (178 LEDs in chain order), One universe (170 elements, eight pairs shared) or Grid (31 x 15 pixels over three universes, for Resolume). It must match the software's fixture. |
Fixture files for the layouts (GDTF for lighting consoles, and Resolume's) are on the documentation site.
Motor & fan tab#
| Setting | What it is for |
|---|---|
| Speed limit (applies at once) | The fastest the platter is driven, in RPM (17 is the mechanism's tested limit), after the speed setting: when the tempo and the speed ask for more, the platter stays at the limit, out of tempo. Apply uses it straight away and keeps it, with no reboot (it is written once the platter is stopped). The live page can change it until the next restart. |
| Reverse motor direction | Flips which way the platter turns. Tick it if the platter turns the wrong way (for example, one motor coil is wired the other way round). |
| Slow-speed floor (applies at once) | The slowest speed the platter will turn at once it is moving, shown in steps per second and in RPM. Drag it to feel the difference; it changes straight away and is saved when you let go, with no reboot. Lower is smoother at very slow speeds. |
| Cooling fan (applies at once) | The fan's temperature range and minimum speed; Apply fan settings uses and saves them. See Care and maintenance. |
Password#
The pages are open to anyone on the network until you set a password. Set one on the Password tab on first use: user name admin, at least 8 characters, then Save & Reboot. After that every page asks for it, and the tab says a password is set (leave the field blank to keep it). Firmware updates are disabled until a password is set.
Backup and restore (/backup)#
Backup in the menu's Settings list saves the unit's set-up to a file on your phone or computer and puts it back later, on this turntable or another one.
- Presets and palettes downloads the preset list and your palettes (your own and any built-in one you changed).
- Everything adds every setting from the settings page: network (address, name, OSC port, Wi-Fi network), show, colour, LEDs, motor and fan. Tick Include the Wi-Fi password to put that in too; the file then gives anyone who has it your Wi-Fi password, so keep it safe. The administrator password is never in a backup.
The file is plain text, named after the unit and the date (for example liquidturntable-everything-2026-11-16.txt). Its preset list reads like the LEDs tab's, so it can also be edited and restored.
To restore, choose the file under Restore. The page lists the parts the file has, each with a box: tick the ones to put back and press Restore. Each part replaces what the unit has as a whole: restoring the presets replaces the whole preset list, and a setting the file doesn't have goes back to its factory value (the Wi-Fi password stays as it is if the file has none). The whole file is checked first; if a line can't be read nothing changes and the page names the line.
- Presets and Palettes are in use at once; they are written to the unit's memory the next time the platter stops.
- Network, Settings and LED settings restart the unit, as Save & Reboot does; the page reloads when it is back. Network isn't ticked to begin with: it carries the unit's address and name, so restore it only on the same unit, or to give another unit the same set-up on purpose (two units with one fixed address clash).
The log (/log)#
/log shows the unit's recent activity (useful when something is wrong), including each boot, the network it joined and any problem it noticed. The menu and a bar under it stay in view as you scroll: Live switches the automatic refresh on and off (turn it off to read or copy a line without the page moving), Clear empties the log, and Save .txt downloads it as a text file.
Firmware updates (/update)#
/update is for firmware updates. Choose the compiled .bin file (not the .merged.bin), then press Upload. The motor stops during the upload and the board restarts into the new firmware. If it doesn't come back on the network within 30 seconds of starting, the next restart returns to the firmware that was running before.
The page names the firmware the unit runs (Current:) and, when the computer or phone showing it is on the internet, whether a newer build has been released: Update available with a Download link, or (up to date). The Status tab's Firmware row says the same. The unit itself never goes on the internet for this.
Under Download firmware, the page links to the newest build, Latest firmware, and to the Archive of every build released, named by its date and time (liquidTurntable_YYYY_MM_DD_HHMM_firmware.bin). Download one with a computer or phone that is on the internet, then choose it above. The unit never downloads firmware itself. Each link opens a page on the firmware site in a new tab, and the download starts from there (the latest build's by itself), so the browser doesn't block it as an insecure download.
7. Show-control software (OSC)#
The unit listens for OSC messages on UDP port 3335 (changeable), on Ethernet and Wi-Fi at the same time. Numbers may be sent as floats or integers.
| Address | Value | Effect |
|---|---|---|
/bpm | 20 to 500 | Sets the tempo. The preferred source. |
/beat | (whole number) | One beat. The number is the beat within the bar, 0 on the downbeat. Keeps the tempo (and so punch and the pulse) on the beat, and drives the beat position shown on the status page. Counted while the unit is following an OSC tempo source, not while it uses the tap. Send beats from one place at a time: two senders both count. |
/measure | (decimal) | The position in the bar, in beats, about 30 times a second. Keeps the beat position on time between beats. Same rule as /beat. |
/composition/tempocontroller/tempo | 0.0 to 1.0 | Resolume's tempo slider, mapped to 20 to 500 BPM. Used when /bpm is not arriving. |
/scaleEncoder | 0.0 to 1.0 (wraps) | Acts like turning the main knob. Every 0.0125 is one click. |
/scaleZero | anything | Stops the platter. |
/home | anything | Sets the platter to its home speed (see the main knob's press, above). |
/directionChange | anything | Reverses direction. Ignores repeats within a quarter of a second. |
/hue | 0.0 to 1.0 | Hue shift: turns every colour round the colour wheel (wraps round; 0 = the presets' own colours). On preset 1 with the user colour red, this is the colour (white, the factory colour, has no hue to turn). |
/saturation | 0.0 to 1.0 | Saturation: 1.0 is as the preset draws it, 0.0 white. |
/value | 0.0 to 1.0 | Brightness. |
/colourtemp (or /colortemp) | 2000 to 10000 | Colour temperature in kelvin: 6500 is neutral, lower is warmer and more orange, higher is cooler and bluer. |
/preset | 1 up to the highest preset | Picks the preset. |
/palette | 0 up to the highest palette | Picks the palette (0 = the preset's own). |
/fxspeed | -16 to 16 | The effect speed, as the EXP2 knob counts it: every 8 doubles it (or halves it, below 0), from a quarter of the preset's speed (-16) to four times it (16); 0 is the preset's own. Lasts until the next reboot. |
/look | a string | A look in the preset format, its keys alone or a whole line (its number and name are ignored), for example effect=sweep palette=rainbow speed=1 count=3 punch=120. The ring runs it at once in place of the preset's look, as the live page's effect settings do, until a preset is picked (/preset, the VAL knob, the live page). Keys left out take their usual values (the defaults in the table), not the preset's. The palette picked with /palette (if not 0) still applies. A string the unit can't read changes nothing and is noted in the log. |
/flash, /pulse, /pulsediv | Ignored: they set the beat flash, which is each preset's punch now (style flash for the old look). The log notes it once. | |
/presetmode | 0 | Picks preset 1, the user colour. It used to choose colour mode, which is gone; 1 does nothing. (/wledmode also works.) |
The unit also sends two messages, as a broadcast to port 3336 on the local network, so other equipment can react to the tap button:
| Address | Value | When |
|---|---|---|
/tap | 1 | Every time the TAP button (or the phone page's Tap) is pressed. |
/tapbpm | tempo | Whenever tapping sets a new tempo. |
Beats keep the feed alive too. Pulse sends /bpm only when the tempo changes, so while /beat or /measure keep arriving from the feed in use, it isn't treated as stale even with a steady tempo.
How "stale" is decided: a /bpm feed that stops for 60 seconds is dropped in favour of the tempo controller; a tempo-controller feed that stops for 1 second is dropped in favour of tapping. When a feed is dropped, the last tempo stays in force until something new arrives. The first /scaleEncoder message after switch-on only records where your control is; it doesn't move the platter.
8. Art-Net and sACN#
Lighting software (a lighting desk, a media server such as Resolume, a pixel mapper) can drive the ring over the network with Art-Net or E1.31 (sACN). The ring shows what it sends through an effect of its own, Art-Net / sACN (effect=artnet; built-in preset 23 is it), so the turntable's own looks and the software's take turns like any two presets, with a crossfade between them.
Turning it on#
Everything is on the settings page's Art-Net tab:
- Tick Receive Art-Net and E1.31, and offer the artnet effect and press Save & Reboot. Receiving is off as the unit comes; unticked, the unit ignores what arrives and leaves the effect, and every preset that uses it, out of the lists and off the VAL knob (OSC
/presetcan still pick one). - Set the First universe and the Layout to match the software (see Layouts and Fixture files). The first universe is Art-Net's port-address, counted from 0: Net × 256 + SubNet × 16 + Universe, so Net 0, SubNet 0, Universe 1 is 1. Some programs count universes from 1, which puts them one off.
- In the software, send to the unit's address (shown on the menu bar) or broadcast on its network, on UDP 6454 for Art-Net or 5568 for E1.31.
- Pick the Art-Net / sACN preset (23), from the live page's Preset list or effect settings, the VAL knob, OSC
/preset 23or/look, or a preset of your own that uses the effect.
Layouts#
Layout says how the software addresses the ring, from the first universe, three channels (red, green, blue) per LED or pixel. The ring itself is the same in every layout; only the addressing changes.
- Two universes (as the unit comes): the LEDs in chain order, LEDs 1-170 in the first universe and 171-178 in the next (534 channels).
- One universe: eight pairs of neighbouring LEDs on the outer edge share three channels (D1+D2, D3+D4, D5+D6 at the top, D83+D84 and D95+D96 at the sides, D173+D174, D175+D176, D177+D178 at the bottom), which makes 170 elements and 510 channels, still in the order of the LED chain.
- Grid: the ring as one rectangle of 31 x 15 pixels, left to right and top to bottom as the pages draw it, for software whose fixtures are rectangles, such as Resolume. The LEDs sit on a brick pattern, so with pixels half an LED spacing wide (6.35 mm) and one row high (12.7 mm) every LED is exactly on a pixel of its own; the pixels between them are ignored. 465 pixels make 1395 channels, sent on from one universe to the next over three universes (channel 513 is the second universe's channel 1), as Resolume does with Auto Span on.
Two units fed the same data must use the same layout, or one shows the picture scrambled (see the FAQ).
What the ring shows#
While the effect runs, the ring shows what the software sends; any other preset or effect, and the software has no effect on the ring. When nothing arrives (the software stops, or ends its stream) it holds the last frame; before anything has arrived it is dark.
- Like every effect it takes the hue shift, saturation, brightness and colour temperature (the HUE, SAT and VAL knobs, the live page's sliders and OSC): handy for dimming or tinting a lighting desk's output from the turntable. At hue 0, saturation and brightness 100% and 6500 K the colours are shown as sent.
- Like any pattern it can turn: its Speed and Turns per (bar, beat or platter turn), drift, bounce and steps turn the whole picture (the LEDs take the colours of the places that turn onto them, so it stays smooth); speed 0 shows it as sent. Punch hits it on the beat.
- If the picture comes out the wrong way round, the effect's Flip row (in the live page's effect settings and the LEDitor, keys
hflipandvflip) mirrors it left-right and top-bottom, as the live page's and the LEDitor's pictures show the ring (both together turn it half a turn). It changes at once and is saved with the preset. The ring's LEDs are laid out symmetrically, so a flipped picture is exact: each LED shows another LED's colour, nothing blended. Turning then turns the flipped picture. - Changing to it and away from it crossfades. The power limit always applies.
Lighting desks find it (ArtPoll)#
While receiving is on, the unit answers lighting desks' ArtPoll, the poll Art-Net desks send every few seconds to find what is on the network, so the desk lists it by name (its network name, with "Uncle Magic's Liquid Turntable"), with its universes as outputs (one, two or three, as the layout takes). Receiving off, it stays out of the desk's list. The Status tab's Art-Net / sACN box counts the polls and the replies.
Fixture files#
Ready-made fixtures for the layouts. Download them from the fixture files on the documentation index.
- Lighting consoles: Uncle Magic@Liquid Turntable@2026-11-18.gdtf is a GDTF fixture (the open standard, DIN SPEC 15800) that grandMA3, ETC Eos, ChamSys MagicQ, Avolites Titan, Onyx, Vectorworks, Capture and others import. It has a mode for each layout: 2 universes (178 pixels: patch it at the unit's first universe, and the console takes the next universe for LEDs 171-178), 1 universe (170 elements, the eight shared pairs as one each) and Grid (178 pixels at their cells of the 31 x 15 grid, over three universes from the first; the cells without an LED are left out, so the console patches only the ring). Pick the mode that matches Layout. Each pixel is at its place on the ring, so a console's pixel mapper or visualiser lays the ring out as it is, the right way round as the live page draws it. Each pixel takes red, green and blue (
ColorAdd_R,_G,_B). - Resolume Arena: set Layout to Grid, then use the fixture Liquid Turntable grid.xml (copy it into Documents/Resolume Arena/Fixture Library) and the Advanced Output setup Liquid Turntable grid (Advanced Output).xml (into Documents/Resolume Arena/Presets/Advanced Output; it appears as Liquid Turntable grid): one fixture, 31 x 15 RGB pixels, in one slice over the middle of a 1920 x 1080 composition, sized so each pixel's centre is an LED's place. Its Lumiverse broadcasts Art-Net on universe 1 with Auto Span on: set the universe to the unit's first universe if that isn't 1. If the picture comes out mirrored or upside down, the effect's Flip fixes it.
Checking what arrives#
The Status tab's Art-Net / sACN box shows, once a second, what arrives on the Art-Net and E1.31 ports: each universe, who sends it, how often and whether the unit uses it, even with receiving off, so a wrong universe or layout shows at once. See Status tab.
9. Network setup#
Ethernet is the most dependable link and is used for show work. Plug the unit into your network or router and it asks for an address automatically (DHCP).
Wi-Fi is optional. The unit tries these networks in this order, giving each up to 15 seconds:
- The network set on the settings page, if any.
- The networks built into the firmware (set by whoever built it).
If none can be found or joined, it waits 15 seconds and starts again from the top, so the preferred network is picked up as soon as it appears. The log (/log) shows each attempt and why it failed (for example "network not seen" or "wrong password"). Wi-Fi works well within a room; for timing-critical tempo, Ethernet is steadier.
Setting up Wi-Fi without a network cable#
A new unit doesn't know your Wi-Fi. If it has no network a minute after it is switched on, it starts its own Wi-Fi network for setting up:
- On a phone or laptop, join the network called LiquidTurntable- followed by four letters and digits (for example
LiquidTurntable-D784). Its password isturntable. - A sign in to network page should open by itself; if it doesn't, open http://192.168.4.1/wifi.
- Pick your network from the list (or type its name), enter its password and press Save & Restart.
- The unit restarts and joins your network. Put the phone back on your network and open http://liquidturntable.local/.
If the unit can't join (a mistyped password, say), its setup network comes back a minute later. Once the unit has a network the setup network switches itself off. It doesn't start when the unit already has a network, nor later on if the network drops during a show.
The setup network shows only the Wi-Fi page. Its password is the same on every unit, so the controls, the settings, the log and firmware updates are not reachable through it: anything else you open there brings you back to the Wi-Fi page. Use them once the unit is on your own network (or by cable).
To change networks later (a new venue): open the Network tab, or the Wi-Fi setup page linked there (/wifi, which lists the networks the unit can see). Without any network, hold the TAP button while switching the unit on, for five seconds: that also clears the settings-page password and returns Ethernet to automatic addressing (see below), and starts the setup network at once for 15 minutes.
From a computer over USB: in a serial terminal (115,200 baud), type wifi YourNetwork YourPassword and press Enter; put a name or password with spaces in quotes: wifi "Cafe Guest" "open sesame". wifi on its own shows the status and wifi - forgets the saved network. The unit restarts after a change.
Several turntables on one network#
Every unit is called liquidturntable until you change it, so the first one answers at http://liquidturntable.local/. When a second unit starts, it asks the network whether that name is taken. If so it quietly uses liquidturntable-1, the next one liquidturntable-2, and so on. You can see which name a unit is using on its Status tab and at the top of the live page, and in the log.
Names are first come, first served, so which unit gets which number depends on which was switched on first. To give each turntable a fixed name, open its settings page, type a different Hostname (for example stage-left and stage-right), and press Save & Reboot. Do this once per unit, connecting to them one at a time if need be (by their addresses).
A fixed address. If you want one, set it on the settings page, or (better) reserve an address for liquidturntable in your router.
If you can't reach the unit at all (a wrong fixed address, or a forgotten password): switch the unit off, hold down the TAP button, switch on, and keep holding for 5 seconds. This clears the password and puts Ethernet back on automatic addressing. Other settings are kept.
10. Power and safety#
The unit is designed around a single Mean Well RD-85A (5 V / 12 V) supply, wired to the two power connectors (a 4-pin 5 V plug and a smaller 2-pin 12 V plug that cannot be swapped); two separate supplies also work. It needs:
- 12 V (the motor, the fan and the unit's own electronics): 1 A or more; 2 A leaves comfortable room. Use a regulated 12 V supply. If it is adjustable, keep it between 12 and 13 V. (Units built before October 2026 used a 24 V supply; check the label by the power connectors.)
- 5 V (the LED ring): up to about 7 A when the ring is at full white; 8 A or more is a comfortable supply.
Switching on and off
- Use one switch for both supplies, and do not plug or unplug the power connectors with the supplies on.
- After switching off, wait about 3 seconds before switching on again. The electronics need that long to drain.
- Both supplies, started together, produce a brief inrush current. Use a slow-blow fuse (T-type) in the mains inlet.
Hazards and precautions
- Never connect or disconnect the motor cable or the LED ring cable with the power on. A motor is a coil: unplugging it live makes a voltage spike that can destroy the motor driver. The ring cable carries up to about 7 A and can arc as it is made or broken. Switch off, wait about 3 seconds, then change the cable. The same goes for the plug-in modules on the mainboard.
- The supplies run on mains voltage. Bond the earth pin to any metal case, cover all mains terminals, and keep mains wiring away from the low-voltage board. Only a competent person should wire the mains side.
- Keep fingers, hair and cables clear of the platter. It is quiet and slow, and can still pull things in.
- At full white the LED ring is very bright and draws a lot of power. Keep the brightness down in small rooms, and don't look into it.
- The motor driver and the power regulator get warm in use. Leave air gaps around the enclosure.
- Don't press the small BOOT button on the controller module while the platter is running.
- The controller's USB-C port is for setup and updates only; leave it unplugged during a show. On its own it powers the controller and the panel (knobs, buttons, the web pages) but not the motor or the LED ring, so you can set up and update the unit from a computer with the main power off. Plugging it in with the main power on is also fine.
Fuses. The motor and electronics are protected by F1, a soldered 2 A resettable fuse: if it trips, switch off, remove the fault and let it cool for a minute; it needs no replacement. The 5 V LED supply has no fuse on the board; the power supply limits its own current.
11. Care and maintenance#
- Cleaning. With the unit off and unplugged, wipe with a slightly damp cloth. Keep liquid away from the electronics.
- Platter and coupling. The platter is joined to the motor by a flexible coupling. If the platter wobbles or the motor sounds different, check the coupling's grub screws.
Updating the firmware.
- Set a password on the settings page (once).
- Open
http://liquidturntable.local/update, choose the new.binfile (not the one ending.merged.bin) and press Upload. - The platter stops during the upload and the unit restarts into the new software.
A new version has to run for 30 seconds with the network up before it is accepted. If it fails to, or crashes, the unit goes back to the previous version by itself at the next restart.
- The log.
http://liquidturntable.local/logshows what the unit has been doing since switch-on, with the time of each event. It's the first place to look when something is wrong. - Heat. At high brightness the LED ring is the main source of heat, and the enclosure needs airflow in a warm room. The Status tab (and the log, every 5 minutes) shows the main processor's temperature; it logs a warning above 80 °C. If you see that, lower the brightness or the LED current limit and check the vents or fan.
- The fan. The mainboard has a keyed 4-pin FAN header for a 4-wire 12 V fan, at most 0.5 A (pin order: ground, +12 V, tach, PWM; plug it in with the key lined up). Never fit a 5 V fan: it would be damaged. It runs whenever the 12 V supply is on, and its speed follows the processor temperature. On the Motor & fan tab, the Cooling fan box sets the two temperatures (slowest at or below low, full speed at or above high), the minimum speed, and whether the unit controls the fan at all. Changes apply at once and need no restart. If the unit crashes or is stopped, the fan runs at full speed. Defaults are 60 °C and 78 °C with a 25% minimum (a bare module idles around 59 °C); set them from a reading with a thermometer in the enclosure. The Status tab shows the fan percentage and whether its tach wire is turning; the log warns if a fan that was turning stops.
The ring's temperature#
Boards with the ring temperature sensor read a thermistor on the LED ring through the ring's signal cable. It matters most when the presets are mostly white, which keeps the ring near its current limit all the time. As the ring warms:
- The fan comes first. From 45 °C the fan speeds up, reaching full speed at 60 °C. (The fan also follows the processor temperature, as above; whichever asks for more wins.)
- Then the current. Above 60 °C the ring's current limit comes down in a straight line, to 1500 mA at 75 °C, and it stays there above that. It moves gradually (down within seconds, back up slowly as the ring cools), so you see the ring ease a little dimmer rather than jump. It doesn't wait for the fan: a stalled or unplugged fan still ends in a lower limit.
- If the sensor reads open (signal cable out, or a ring without the sensor) the fan runs at full speed and the ring is held to 3000 mA; the log says so. A sensor that reads shorted is treated as hot.
All five figures are on the LEDs tab under Ring temperature, with the reading now. The Status tab and the log (every 5 minutes, and when the limit starts and stops coming down) show the ring temperature and the limit in force. Boards without the sensor show "no sensor on this board" and keep the set limit.
12. Troubleshooting#
For the things that catch people out (a phone browser that can't reach the unit, Art-Net that doesn't arrive, a preset that wasn't kept), see the FAQ.
| Problem | Things to try |
|---|---|
| Nothing happens at switch-on | Check both supplies (F1 resets itself; if it was hot, wait a minute). Check both power connectors are fully home. |
| The platter doesn't move | It starts stopped: turn the main knob up, or press Start on the phone page. Check the speed on the phone page isn't 0%. Check the motor cable. |
| Platter turns the wrong way | Tick Reverse motor direction on the settings page. |
| Platter doesn't follow the tempo | Look at the source line on the phone page. At 100% speed, above about 204 BPM the platter is at its speed limit (17 RPM); at a lower speed setting the limit comes at a faster tempo. At speed below 100% the platter runs slower than the beat on purpose. |
| Motor buzzes but doesn't turn | Check that the motor cable is plugged in properly, and that the motor really is wired A+, A−, B+, B− in order (see the Hardware Overview). |
| Tap button does nothing to the tempo | Show software is sending a tempo, which takes priority. The tap is still sent out as a network message. |
| The ring stays dark | Check the 5 V supply and that both ring cables (power and signal) are fully home. Brightness may be at 0%. The LEDs tab should say LED engine, SK9822 with a frame rate near 100. |
| Colours are wrong (red shows as blue, say) | Change Colour order on the LEDs tab (RBG for this ring). |
| Colours don't change | Check /log for the "LED engine" line at start-up and the LEDs tab for a frame rate. |
| The VAL knob changes the preset, not the brightness | That is what it does until you press its button; press again to go back to presets. |
| The colours look wrong for the preset | The hue shift or saturation is set: press the HUE button (hue shift back to 0) and turn SAT up to 100%. |
| A preset shows nothing new | Check the preset list on the LEDs tab; a number past the last preset shows the user colour. |
| The ring is dim on a bench unit, and the log says the ring's temperature sensor reads shorted or open | A controller board on its own (no motor driver answering, nothing attached) runs as a bench unit: it ignores the ring's temperature sensor, so the ring keeps its set limit. The log, the Status and LEDs tabs and the live page's bottom line say BENCH. A unit with its motor driver always uses the sensor: check the ring's 5-pin signal cable (pin 5 is the sensor). |
| Two turntables and the wrong one answers | Each unit has its own name (liquidturntable, liquidturntable-1, ...), shown at the top of its phone page. Give each a fixed hostname on its settings page. |
| Can't open the web pages | Try the other forms of the address (section 6). Make sure your phone or computer is on the same network. Then try the TAP-button reset in section 8. |
| Wi-Fi won't connect | Open /log over Ethernet and read the Wi-Fi lines. "Network not seen" means out of range or the wrong name; "AUTH_FAIL" means a wrong password. |
| Forgot the password | Use the TAP-button reset in section 8. |
| Firmware update refused | A password must be set first. Use the .bin file, not the .merged.bin. |
13. Specifications#
| Tempo range | 20 to 500 BPM |
| Platter | 1 revolution per 12 beats; top speed 17 RPM (adjustable); slowest speed about 0.6 RPM |
| Speed setting | 0 to 100% of tempo speed in either direction, 1% per click |
| Motor | NEMA 17 bipolar stepper, driven at 800 mA per phase, 1/32 steps |
| Lighting | 178 RGB LEDs (SK9822-A, an APA102-type part with data and clock wires, flicker-free on camera) on an 8 inch (203 mm) ring board fixed near the top of the case (it does not turn with the platter); colour set by hue, saturation and brightness |
| Network | Ethernet 10/100, plus optional Wi-Fi (2.4 GHz); web pages on port 80, OSC on UDP 3335 |
| Name on the network | liquidturntable by default (liquidturntable.local); changeable; numbered automatically if taken |
| Power in | 12 V DC (1 A or more) and 5 V DC (up to about 7 A) |
| Fuses | F1 2 A resettable (soldered); none on the 5 V side |
| Controls | 4 rotary knobs with push buttons, 1 tap button |