Uncle Magic's Liquid Turntable

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#

  1. 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).
  2. 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.
  3. 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.)
  4. 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.)
  5. Pick a colour. Turn the HUE knob to choose a colour, SAT for how rich it is, and VAL for how bright.
  6. 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#

ControlTurnPress
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 knobTurns 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 knobHow 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 knobPicks the preset (it starts doing this), or, after a press, changes brightness, 1% per click.Switches the knob between picking presets and brightness.
TAP buttonSets the tempo by tapping (see section 4).

The panel has connections for three more knobs (EXP1-EXP3). Two of them work on the presets:

ControlTurnPress
EXP1 knobPicks the palette: 0 (the preset's own) up to 11, or up to your last own palette (12-19), wrappingPalette back to 0
EXP2 knobEffect speed: 8 clicks double it (or halve it, turning down), from a quarter of the preset's speed to four times itBack to the preset's own speed
EXP3 knobNot 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 revolutionPlatter speed
6012 s5 RPM
908 s7.5 RPM
1206 s10 RPM
1405.1 s11.7 RPM
1704.2 s14.2 RPM
204 and above3.5 s17 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:

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:

  1. Show software over the network (OSC /bpm). The normal way to run a show.
  2. A tempo-controller feed (such as the tempo slider in Resolume). Used if the first is missing.
  3. 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.

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:

Presets and the knobs#

ControlTurnPress
VAL knobPicks the preset, 1 up to the highest in the preset list, wrapping round at the ends; after a press, brightnessSwitches between presets and brightness
EXP1 knobPicks the palette, 0 (the preset's own) up to 11, or up to your last own palette (12-19), wrappingPalette back to 0
EXP2 knobEffect speed, a quarter to four times the preset's ownBack to the preset's own
HUE knobHue shift: every colour round the colour wheelHue shift back to 0
SAT knobSaturation: 100% as drawn, down to whiteWhite on and off

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:

Effects. Each preset has an effect, a palette, a speed and an intensity (0-255, the effect's main shape control):

EffectWhat it doesIntensity
solidOne colour; with a speed, it fades through the palette(none)
paletteThe 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 insteadSpread: 0, the whole ring one colour; 255, the palette once round the ring
wipeA front goes round laying the next colour over the last (count colours from the palette)Softness of the edge
sweepA bright head turning round the ring with a fading tail; count heads, evenly spacedTail length
segmentscount arms turning together, soft edgesArm width
spiralcount 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 turnHow 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
pulseA 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 edgeWidth of the ring
noiseSoft, 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 everythingDetail: 0 is a few big soft areas, 255 many small ones
ripplescount 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 themHow much they fade towards where they go
sparkleLEDs 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 fadeHow many sparkle: 2% to 62% of the LEDs at each chance
strobeThe 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:

EffectCount (what it counts)Most
segmentsarms round the ring; with radial, bands from the centre out12; 3
sweepheads; with radial, heads from the centre out6; 3
spiralarms (and the twist: one turn)6
noiserepeats round the ring6
ripples, pulserings3
wipe, strobecolours, 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:

EffectWith bounce
sweepA pendulum: the head swings round and back, its tail always trailing
segments, spiralThe arms rock forward and back; a spiral winds up and unwinds
solid, palette at spread 0The 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
wipeWipe 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
pulseHeartbeat: 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
noiseThe 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):

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.

The 23 built-in presets, one moment of each
The 23 built-in presets, one moment of each
#NameEffectPaletteSpeedIntensityCountWhat you seeAnimation
1User coloursolidusercolour0Your colour, still1
2Rainbow ringpaletterainbow0.25 per bar255The rainbow once round the ring, a quarter turn a bar2
3Party fadepaletteparty0.125 per bar0The whole ring one colour, fading through the palette every 8 bars3
4Sweepsweepusercolour1 per bar90A head in your colour with a tail a third of the ring long, once round a bar4
5Two arms lavasegmentsember0.5 per bar1202Two wide arms, dark red and orange-red, half a turn a bar5
6Four arms oceansegmentsocean-0.25 per bar904Four arms, a quarter turn a bar, backwards6
7Rainbow spiralspiralrainbow0.25 per bar1283Three arms twisted one turn from the centre out, turning with the platter7
8Beat pulsepulseunit060A ring in your colour leaves the centre on every beat8
9Wipe red blue whitewipered/blue/white1 per bar403A new colour sweeps round each bar9
10Platter 12 armssegmentsunit1 per platter turn6012Twelve spokes that turn with the platter10
11Fire spiralspiralheat-0.5 per bar1282Two arms twisted one turn, dark at the centre to white at the edge, turning against the platter11
12Forest driftpaletteforest0.0625 per bar128Half the palette round the ring, once round every 16 bars12
13Cloud sweepsweepcloud0.5 per beat200A long-tailed head, half a turn a beat13
14Rainbow pulsepulserainbow0.25 per bar120A wide ring on every beat, its colour drifting through the rainbow14
15Stripe wipewipestripes0.5 per bar08A hard-edged new colour every two bars, eight in turn15
16Slow colour fadesolidrainbow0.125 per barThe whole ring through the rainbow every 8 bars16
17Lava noisenoiselava0.0625 per bar901Soft blobs drifting slowly and changing shape17
18Ocean kaleidoscopenoiseocean-0.125 per bar1405A five-fold pattern, slowly backwards, changing shape18
19Platter noisenoiseparty1 per platter turn1203A three-fold pattern that turns with the platter, changing shape19
20Ocean ripplesripplesocean0.5 per bar1203Three rings flowing out from the centre, fading as they go20
21Party sparklesparkleparty4 per bar110Party colours glinting at random and fading, swelling on each beat (punch 120, width 170)21
22Platter strobestrobeusercolour0 per platter turn12Twelve flashes a platter turn, locked to the platter, in your colour (width 60: 12 ms flashes). Dark while it stands still22
23Art-Net / sACNartnetWhat lighting software sends over Art-Net or E1.31 (offered while receiving is ticked on the Art-Net tab); dark until something arrives23

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.

The ten built-in palettes, each from its start (left) round to its start again
The ten built-in palettes, each from its start (left) round to its start again
#NameColoursNotes
0(preset)Whatever the preset namesThe knob's resting place; not a palette you can put in a preset line
1usercolourOne colour, the user colour: the live page's colour picker sets it, and the settings page's starting colour is what it starts asShown 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
2redbluewhiteRed, blue and white, blended in a loopShown 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
3rainbowThe full colour wheelGood on everything
4stripesThe rainbow's colours with black between eachGives the palette and wipe effects hard bands
5partyPurple, pink, red, orange and yellow, to blueNo green; warm and saturated
6oceanDark and mid blues, sea green, aqua and pale blue
7lavaBlack and dark red, with a short run of red, orange and whiteMostly dark: the bright part is a small share of it. With segments or wipe, the first colour is black
8forestDark to bright greens with olive and aqua
9cloudDeep blue, sky blue and white
10heatBlack through red, orange and yellow to whiteA ramp, not a loop: it jumps from white back to black where it wraps. With segments or wipe, the first colour is black
11emberDark red, orange and red, blended in a loopWarm, with no black: both arms of a two-arm preset stay lit
12-19user1 to user8Your own palettes, made with Save as new in the palette editorThe 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:

The LEDs tab: what the engine is doing, the ring's wiring and limits, Art-Net and the preset list
The LEDs tab: what the engine is doing, the ring's wiring and limits, Art-Net and the preset list

4 effect=sweep palette=usercolour speed=1 unit=bar intensity=90 name=Sweep

KeyValuesIf 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
effectsolid palette wipe sweep segments spiral pulse noise ripples sparkle strobe artnet (and heartbeat, see Bounce)solid
bounce1 (out and back) or 00
trail0 to 255: spiral only, the glow behind each arm in hundredths of a second (see Trail)0 (none)
paletteredbluewhite unit rainbow stripes party ocean lava forest cloud heat ember, your own user1 to user8, or its number 1 to 19redbluewhite
speed-16 to 16 turns per unit; negative is backwards, 0 is still0
unitbar (4 beats), beat or platterbar
intensity0 to 255: the effect's shape control (see the effects table)128
count1 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 that1
width0 to 255: how much is lit against dark (spiral, ripples, noise), how long a sparkle glows, how long a strobe flash lasts128
drift-16 to 16 turns per unit that the pattern's zero point moves0
bgblack or white: what the dark parts of the pattern showblack
paintauto angle radius arm tail: how its colours are picked (see Colours)auto
punch0 to 255: how much it hits on the beat (see Punch)0 (none)
punchstyleswell or flashswell
punchlen2, 4, 8, 16 or 32: each hit lasts 1/that of a beat2
punchevery1 to 16: which beats hit (every that many, counted on)1
radial1 (out from the centre) or 0: palette, wipe, segments, sweep0
steps1 (move on the beat) or 00
every1 to 16: pulse, a ring every that many beats1
inward1 (from the edge in) or 0: pulse0
churn0 to 255: noise, how fast it changes shape in hundredths of the usual100
hflip, vflip1 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 turns0
nameUp to 23 characters, to the end of the line, so put it lastNo 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:

  1. Open http://liquidturntable.local/. This works on Windows 10 and later, Macs, iPhones and iPads, and Linux. Some Android phones don't support it.
  2. Look in your router's list of connected devices for liquidturntable and open that address (for example http://192.168.1.50/).
  3. 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:

ItemWhat it opens
LiveThe live page
LEDitorThe 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 live page: the Turntable picture, the Light and Effects boxes (with the effect settings) and Tempo
The live page: the Turntable picture, the Light and Effects boxes (with the effect settings) and Tempo

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.

ItemWhat it does
Turntable boxOpen, 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 slidersOn 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 pickerThe 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 sliderWarms 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 listsPick the preset and palette, each shown as number: name. Palette 0 is the preset's own.
Effects: Effect speed slider and 1xThe 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 settingsOpen 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 lineThe 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 TapThe 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 fromfrom OSC /bpm, from OSC tempo controller or local (tap / set).
more: StartSets the speed to 100% (the platter eases up to it).
more: StopStops the platter.
more: Slower / FasterChanges the speed by 5%. These never cross zero, so they won't reverse the platter.
more: ReverseReverses direction (slows, turns round, speeds up).
more: BPM box + Set BPMTypes in a tempo (20 to 500). It holds until a show-software tempo arrives.
more: Speed limit box + Set limitThe 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 lineThe 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.

The LEDitor: the ring as the LED engine draws it, with the preset editor and the palette editor under it
The LEDitor: the ring as the LED engine draws it, with the preset editor and the palette editor under it

The preset editor is under the picture. It builds a preset without typing its line:

  1. 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.
  2. 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.
  3. 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):

  1. 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.
  2. 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).
  3. 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.
  4. 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 Status tab: what the unit is doing now
The Status tab: what the unit is doing now

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#

The Network tab: hostname, Ethernet, Wi-Fi and the OSC port
The Network tab: hostname, Ethernet, Wi-Fi and the OSC port
SettingWhat it is for
HostnameThe unit's name on the network (liquidturntable unless you change it). Letters, digits and hyphens only. See several turntables.
Static IP, Gateway, Subnet maskLeave the address at 0.0.0.0 to get one automatically (recommended).
OSC listen portWhere 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 passwordA 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.)

The Defaults tab: starting tempo, colour and colour temperature
The Defaults tab: starting tempo, colour and colour temperature
SettingWhat it is for
Starting BPMTempo used at switch-on, until one arrives over OSC or is tapped or set on the live page.
Starting colourThe 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 temperatureThe 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.

SettingWhat it is for
Receive Art-Net and E1.31, and offer the artnet effectOff 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 universeWhere the ring starts: Art-Net's port-address, counted from 0 (Net x 256 + SubNet x 16 + Universe); some programs count from 1.
LayoutHow 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#

The Motor & fan tab: speed, direction, slow-speed floor and fan
The Motor & fan tab: speed, direction, slow-speed floor and fan
SettingWhat 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 directionFlips 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 Password tab: setting the password
The Password tab: setting the 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.

The Backup page
The Backup page

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.

The log (/log)#

The log page
The log page

/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)#

The firmware update page
The firmware update page

/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.

AddressValueEffect
/bpm20 to 500Sets 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/tempo0.0 to 1.0Resolume's tempo slider, mapped to 20 to 500 BPM. Used when /bpm is not arriving.
/scaleEncoder0.0 to 1.0 (wraps)Acts like turning the main knob. Every 0.0125 is one click.
/scaleZeroanythingStops the platter.
/homeanythingSets the platter to its home speed (see the main knob's press, above).
/directionChangeanythingReverses direction. Ignores repeats within a quarter of a second.
/hue0.0 to 1.0Hue 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).
/saturation0.0 to 1.0Saturation: 1.0 is as the preset draws it, 0.0 white.
/value0.0 to 1.0Brightness.
/colourtemp (or /colortemp)2000 to 10000Colour temperature in kelvin: 6500 is neutral, lower is warmer and more orange, higher is cooler and bluer.
/preset1 up to the highest presetPicks the preset.
/palette0 up to the highest palettePicks the palette (0 = the preset's own).
/fxspeed-16 to 16The 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.
/looka stringA 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, /pulsedivIgnored: they set the beat flash, which is each preset's punch now (style flash for the old look). The log notes it once.
/presetmode0Picks 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:

AddressValueWhen
/tap1Every time the TAP button (or the phone page's Tap) is pressed.
/tapbpmtempoWhenever 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:

  1. 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 /preset can still pick one).
  2. 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.
  3. 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.
  4. Pick the Art-Net / sACN preset (23), from the live page's Preset list or effect settings, the VAL knob, OSC /preset 23 or /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.

One-universe Art-Net: shared LED pairs The 178 LEDs of the ring seen from the front. In the one-universe layout the eight highlighted pairs on the outer edge each share one element of three channels: D1+D2, D3+D4, D5+D6, D83+D84, D95+D96, D173+D174, D175+D176, D177+D178. Every other LED has an element of its own, in chain order, 170 elements in all. D1+D2 element 1, ch 1-3 D3+D4 element 2, ch 4-6 D5+D6 element 3, ch 7-9 D83+D84 element 80, ch 238-240 D95+D96 element 91, ch 271-273 D173+D174 element 168, ch 502-504 D175+D176 element 169, ch 505-507 D177+D178 element 170, ch 508-510 D1 (shares with D2): element 1, ch 1-3 Two universes: first universe, ch 1-3 D2 (shares with D1): element 1, ch 1-3 Two universes: first universe, ch 4-6 D3 (shares with D4): element 2, ch 4-6 Two universes: first universe, ch 7-9 D4 (shares with D3): element 2, ch 4-6 Two universes: first universe, ch 10-12 D5 (shares with D6): element 3, ch 7-9 Two universes: first universe, ch 13-15 D6 (shares with D5): element 3, ch 7-9 Two universes: first universe, ch 16-18 D7: element 4, ch 10-12 Two universes: first universe, ch 19-21 D8: element 5, ch 13-15 Two universes: first universe, ch 22-24 D9: element 6, ch 16-18 Two universes: first universe, ch 25-27 D10: element 7, ch 19-21 Two universes: first universe, ch 28-30 D11: element 8, ch 22-24 Two universes: first universe, ch 31-33 D12: element 9, ch 25-27 Two universes: first universe, ch 34-36 D13: element 10, ch 28-30 Two universes: first universe, ch 37-39 D14: element 11, ch 31-33 Two universes: first universe, ch 40-42 D15: element 12, ch 34-36 Two universes: first universe, ch 43-45 D16: element 13, ch 37-39 Two universes: first universe, ch 46-48 D17: element 14, ch 40-42 Two universes: first universe, ch 49-51 D18: element 15, ch 43-45 Two universes: first universe, ch 52-54 D19: element 16, ch 46-48 Two universes: first universe, ch 55-57 D20: element 17, ch 49-51 Two universes: first universe, ch 58-60 D21: element 18, ch 52-54 Two universes: first universe, ch 61-63 D22: element 19, ch 55-57 Two universes: first universe, ch 64-66 D23: element 20, ch 58-60 Two universes: first universe, ch 67-69 D24: element 21, ch 61-63 Two universes: first universe, ch 70-72 D25: element 22, ch 64-66 Two universes: first universe, ch 73-75 D26: element 23, ch 67-69 Two universes: first universe, ch 76-78 D27: element 24, ch 70-72 Two universes: first universe, ch 79-81 D28: element 25, ch 73-75 Two universes: first universe, ch 82-84 D29: element 26, ch 76-78 Two universes: first universe, ch 85-87 D30: element 27, ch 79-81 Two universes: first universe, ch 88-90 D31: element 28, ch 82-84 Two universes: first universe, ch 91-93 D32: element 29, ch 85-87 Two universes: first universe, ch 94-96 D33: element 30, ch 88-90 Two universes: first universe, ch 97-99 D34: element 31, ch 91-93 Two universes: first universe, ch 100-102 D35: element 32, ch 94-96 Two universes: first universe, ch 103-105 D36: element 33, ch 97-99 Two universes: first universe, ch 106-108 D37: element 34, ch 100-102 Two universes: first universe, ch 109-111 D38: element 35, ch 103-105 Two universes: first universe, ch 112-114 D39: element 36, ch 106-108 Two universes: first universe, ch 115-117 D40: element 37, ch 109-111 Two universes: first universe, ch 118-120 D41: element 38, ch 112-114 Two universes: first universe, ch 121-123 D42: element 39, ch 115-117 Two universes: first universe, ch 124-126 D43: element 40, ch 118-120 Two universes: first universe, ch 127-129 D44: element 41, ch 121-123 Two universes: first universe, ch 130-132 D45: element 42, ch 124-126 Two universes: first universe, ch 133-135 D46: element 43, ch 127-129 Two universes: first universe, ch 136-138 D47: element 44, ch 130-132 Two universes: first universe, ch 139-141 D48: element 45, ch 133-135 Two universes: first universe, ch 142-144 D49: element 46, ch 136-138 Two universes: first universe, ch 145-147 D50: element 47, ch 139-141 Two universes: first universe, ch 148-150 D51: element 48, ch 142-144 Two universes: first universe, ch 151-153 D52: element 49, ch 145-147 Two universes: first universe, ch 154-156 D53: element 50, ch 148-150 Two universes: first universe, ch 157-159 D54: element 51, ch 151-153 Two universes: first universe, ch 160-162 D55: element 52, ch 154-156 Two universes: first universe, ch 163-165 D56: element 53, ch 157-159 Two universes: first universe, ch 166-168 D57: element 54, ch 160-162 Two universes: first universe, ch 169-171 D58: element 55, ch 163-165 Two universes: first universe, ch 172-174 D59: element 56, ch 166-168 Two universes: first universe, ch 175-177 D60: element 57, ch 169-171 Two universes: first universe, ch 178-180 D61: element 58, ch 172-174 Two universes: first universe, ch 181-183 D62: element 59, ch 175-177 Two universes: first universe, ch 184-186 D63: element 60, ch 178-180 Two universes: first universe, ch 187-189 D64: element 61, ch 181-183 Two universes: first universe, ch 190-192 D65: element 62, ch 184-186 Two universes: first universe, ch 193-195 D66: element 63, ch 187-189 Two universes: first universe, ch 196-198 D67: element 64, ch 190-192 Two universes: first universe, ch 199-201 D68: element 65, ch 193-195 Two universes: first universe, ch 202-204 D69: element 66, ch 196-198 Two universes: first universe, ch 205-207 D70: element 67, ch 199-201 Two universes: first universe, ch 208-210 D71: element 68, ch 202-204 Two universes: first universe, ch 211-213 D72: element 69, ch 205-207 Two universes: first universe, ch 214-216 D73: element 70, ch 208-210 Two universes: first universe, ch 217-219 D74: element 71, ch 211-213 Two universes: first universe, ch 220-222 D75: element 72, ch 214-216 Two universes: first universe, ch 223-225 D76: element 73, ch 217-219 Two universes: first universe, ch 226-228 D77: element 74, ch 220-222 Two universes: first universe, ch 229-231 D78: element 75, ch 223-225 Two universes: first universe, ch 232-234 D79: element 76, ch 226-228 Two universes: first universe, ch 235-237 D80: element 77, ch 229-231 Two universes: first universe, ch 238-240 D81: element 78, ch 232-234 Two universes: first universe, ch 241-243 D82: element 79, ch 235-237 Two universes: first universe, ch 244-246 D83 (shares with D84): element 80, ch 238-240 Two universes: first universe, ch 247-249 D84 (shares with D83): element 80, ch 238-240 Two universes: first universe, ch 250-252 D85: element 81, ch 241-243 Two universes: first universe, ch 253-255 D86: element 82, ch 244-246 Two universes: first universe, ch 256-258 D87: element 83, ch 247-249 Two universes: first universe, ch 259-261 D88: element 84, ch 250-252 Two universes: first universe, ch 262-264 D89: element 85, ch 253-255 Two universes: first universe, ch 265-267 D90: element 86, ch 256-258 Two universes: first universe, ch 268-270 D91: element 87, ch 259-261 Two universes: first universe, ch 271-273 D92: element 88, ch 262-264 Two universes: first universe, ch 274-276 D93: element 89, ch 265-267 Two universes: first universe, ch 277-279 D94: element 90, ch 268-270 Two universes: first universe, ch 280-282 D95 (shares with D96): element 91, ch 271-273 Two universes: first universe, ch 283-285 D96 (shares with D95): element 91, ch 271-273 Two universes: first universe, ch 286-288 D97: element 92, ch 274-276 Two universes: first universe, ch 289-291 D98: element 93, ch 277-279 Two universes: first universe, ch 292-294 D99: element 94, ch 280-282 Two universes: first universe, ch 295-297 D100: element 95, ch 283-285 Two universes: first universe, ch 298-300 D101: element 96, ch 286-288 Two universes: first universe, ch 301-303 D102: element 97, ch 289-291 Two universes: first universe, ch 304-306 D103: element 98, ch 292-294 Two universes: first universe, ch 307-309 D104: element 99, ch 295-297 Two universes: first universe, ch 310-312 D105: element 100, ch 298-300 Two universes: first universe, ch 313-315 D106: element 101, ch 301-303 Two universes: first universe, ch 316-318 D107: element 102, ch 304-306 Two universes: first universe, ch 319-321 D108: element 103, ch 307-309 Two universes: first universe, ch 322-324 D109: element 104, ch 310-312 Two universes: first universe, ch 325-327 D110: element 105, ch 313-315 Two universes: first universe, ch 328-330 D111: element 106, ch 316-318 Two universes: first universe, ch 331-333 D112: element 107, ch 319-321 Two universes: first universe, ch 334-336 D113: element 108, ch 322-324 Two universes: first universe, ch 337-339 D114: element 109, ch 325-327 Two universes: first universe, ch 340-342 D115: element 110, ch 328-330 Two universes: first universe, ch 343-345 D116: element 111, ch 331-333 Two universes: first universe, ch 346-348 D117: element 112, ch 334-336 Two universes: first universe, ch 349-351 D118: element 113, ch 337-339 Two universes: first universe, ch 352-354 D119: element 114, ch 340-342 Two universes: first universe, ch 355-357 D120: element 115, ch 343-345 Two universes: first universe, ch 358-360 D121: element 116, ch 346-348 Two universes: first universe, ch 361-363 D122: element 117, ch 349-351 Two universes: first universe, ch 364-366 D123: element 118, ch 352-354 Two universes: first universe, ch 367-369 D124: element 119, ch 355-357 Two universes: first universe, ch 370-372 D125: element 120, ch 358-360 Two universes: first universe, ch 373-375 D126: element 121, ch 361-363 Two universes: first universe, ch 376-378 D127: element 122, ch 364-366 Two universes: first universe, ch 379-381 D128: element 123, ch 367-369 Two universes: first universe, ch 382-384 D129: element 124, ch 370-372 Two universes: first universe, ch 385-387 D130: element 125, ch 373-375 Two universes: first universe, ch 388-390 D131: element 126, ch 376-378 Two universes: first universe, ch 391-393 D132: element 127, ch 379-381 Two universes: first universe, ch 394-396 D133: element 128, ch 382-384 Two universes: first universe, ch 397-399 D134: element 129, ch 385-387 Two universes: first universe, ch 400-402 D135: element 130, ch 388-390 Two universes: first universe, ch 403-405 D136: element 131, ch 391-393 Two universes: first universe, ch 406-408 D137: element 132, ch 394-396 Two universes: first universe, ch 409-411 D138: element 133, ch 397-399 Two universes: first universe, ch 412-414 D139: element 134, ch 400-402 Two universes: first universe, ch 415-417 D140: element 135, ch 403-405 Two universes: first universe, ch 418-420 D141: element 136, ch 406-408 Two universes: first universe, ch 421-423 D142: element 137, ch 409-411 Two universes: first universe, ch 424-426 D143: element 138, ch 412-414 Two universes: first universe, ch 427-429 D144: element 139, ch 415-417 Two universes: first universe, ch 430-432 D145: element 140, ch 418-420 Two universes: first universe, ch 433-435 D146: element 141, ch 421-423 Two universes: first universe, ch 436-438 D147: element 142, ch 424-426 Two universes: first universe, ch 439-441 D148: element 143, ch 427-429 Two universes: first universe, ch 442-444 D149: element 144, ch 430-432 Two universes: first universe, ch 445-447 D150: element 145, ch 433-435 Two universes: first universe, ch 448-450 D151: element 146, ch 436-438 Two universes: first universe, ch 451-453 D152: element 147, ch 439-441 Two universes: first universe, ch 454-456 D153: element 148, ch 442-444 Two universes: first universe, ch 457-459 D154: element 149, ch 445-447 Two universes: first universe, ch 460-462 D155: element 150, ch 448-450 Two universes: first universe, ch 463-465 D156: element 151, ch 451-453 Two universes: first universe, ch 466-468 D157: element 152, ch 454-456 Two universes: first universe, ch 469-471 D158: element 153, ch 457-459 Two universes: first universe, ch 472-474 D159: element 154, ch 460-462 Two universes: first universe, ch 475-477 D160: element 155, ch 463-465 Two universes: first universe, ch 478-480 D161: element 156, ch 466-468 Two universes: first universe, ch 481-483 D162: element 157, ch 469-471 Two universes: first universe, ch 484-486 D163: element 158, ch 472-474 Two universes: first universe, ch 487-489 D164: element 159, ch 475-477 Two universes: first universe, ch 490-492 D165: element 160, ch 478-480 Two universes: first universe, ch 493-495 D166: element 161, ch 481-483 Two universes: first universe, ch 496-498 D167: element 162, ch 484-486 Two universes: first universe, ch 499-501 D168: element 163, ch 487-489 Two universes: first universe, ch 502-504 D169: element 164, ch 490-492 Two universes: first universe, ch 505-507 D170: element 165, ch 493-495 Two universes: first universe, ch 508-510 D171: element 166, ch 496-498 Two universes: second universe, ch 1-3 D172: element 167, ch 499-501 Two universes: second universe, ch 4-6 D173 (shares with D174): element 168, ch 502-504 Two universes: second universe, ch 7-9 D174 (shares with D173): element 168, ch 502-504 Two universes: second universe, ch 10-12 D175 (shares with D176): element 169, ch 505-507 Two universes: second universe, ch 13-15 D176 (shares with D175): element 169, ch 505-507 Two universes: second universe, ch 16-18 D177 (shares with D178): element 170, ch 508-510 Two universes: second universe, ch 19-21 D178 (shares with D177): element 170, ch 508-510 Two universes: second universe, ch 22-24 One universe: 178 LEDs in 170 elements (510 channels) Seen from the front of the ring board. Hover over an LED to see its element and channels. its own element (3 channels) a pair sharing one element (both show the same colour) Elements follow the LED chain, D1 first; the default two-universe layout gives every LED its own.
One universe: the eight pairs of LEDs (orange) that share an element, with the element and channels each one takes

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.

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.

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:

  1. The network set on the settings page, if any.
  2. 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:

  1. On a phone or laptop, join the network called LiquidTurntable- followed by four letters and digits (for example LiquidTurntable-D784). Its password is turntable.
  2. A sign in to network page should open by itself; if it doesn't, open http://192.168.4.1/wifi.
  3. Pick your network from the list (or type its name), enter its password and press Save & Restart.
  4. 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:

Switching on and off

Hazards and precautions

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#

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:

  1. 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.)
  2. 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.
  3. 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.

ProblemThings to try
Nothing happens at switch-onCheck both supplies (F1 resets itself; if it was hot, wait a minute). Check both power connectors are fully home.
The platter doesn't moveIt 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 wayTick Reverse motor direction on the settings page.
Platter doesn't follow the tempoLook 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 turnCheck 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 tempoShow software is sending a tempo, which takes priority. The tap is still sent out as a network message.
The ring stays darkCheck 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 changeCheck /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 brightnessThat is what it does until you press its button; press again to go back to presets.
The colours look wrong for the presetThe 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 newCheck 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 openA 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 answersEach 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 pagesTry 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 connectOpen /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 passwordUse the TAP-button reset in section 8.
Firmware update refusedA password must be set first. Use the .bin file, not the .merged.bin.

13. Specifications#

Tempo range20 to 500 BPM
Platter1 revolution per 12 beats; top speed 17 RPM (adjustable); slowest speed about 0.6 RPM
Speed setting0 to 100% of tempo speed in either direction, 1% per click
MotorNEMA 17 bipolar stepper, driven at 800 mA per phase, 1/32 steps
Lighting178 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
NetworkEthernet 10/100, plus optional Wi-Fi (2.4 GHz); web pages on port 80, OSC on UDP 3335
Name on the networkliquidturntable by default (liquidturntable.local); changeable; numbered automatically if taken
Power in12 V DC (1 A or more) and 5 V DC (up to about 7 A)
FusesF1 2 A resettable (soldered); none on the 5 V side
Controls4 rotary knobs with push buttons, 1 tap button