# 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](HARDWARE_OVERVIEW.md).

## Contents

1. [Quick start](#1-quick-start)
2. [The panel](#2-the-panel)
3. [Running the platter](#3-running-the-platter)
4. [Tempo: how the platter knows the beat](#4-tempo-how-the-platter-knows-the-beat)
5. [Lighting](#5-lighting)
6. [Controlling it from a phone or computer](#6-controlling-it-from-a-phone-or-computer)
7. [Show-control software (OSC)](#7-show-control-software-osc)
8. [Art-Net and sACN](#8-art-net-and-sacn)
9. [Network setup](#9-network-setup)
10. [Power and safety](#10-power-and-safety)
11. [Care and maintenance](#11-care-and-maintenance)
12. [Troubleshooting](#12-troubleshooting)
13. [Specifications](#13-specifications)

---

## 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](#9-network-setup)).
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](#6-controlling-it-from-a-phone-or-computer).

## 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](#4-tempo-how-the-platter-knows-the-beat)). |

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

| 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](#6-controlling-it-from-a-phone-or-computer)). 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.

- 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](#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](#the-built-in-presets)); edit or add to them on the **LEDs** tab or in the [LEDitor](#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](#palettes).
- **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`, `/saturation` and `/value` ([section 7](#7-show-control-software-osc)).
- 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](#the-rings-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.

![The 23 built-in presets, one moment of each](presets/presets_sheet.png)

| # | Name | Effect | Palette | Speed | Intensity | Count | What you see | Animation |
|---|---|---|---|---|---|---|---|---|
| 1 | User colour | solid | usercolour | 0 | | | Your colour, still | [1](presets/preset_01.webp) |
| 2 | Rainbow ring | palette | rainbow | 0.25 per bar | 255 | | The rainbow once round the ring, a quarter turn a bar | [2](presets/preset_02.webp) |
| 3 | Party fade | palette | party | 0.125 per bar | 0 | | The whole ring one colour, fading through the palette every 8 bars | [3](presets/preset_03.webp) |
| 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](presets/preset_04.webp) |
| 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](presets/preset_05.webp) |
| 6 | Four arms ocean | segments | ocean | -0.25 per bar | 90 | 4 | Four arms, a quarter turn a bar, backwards | [6](presets/preset_06.webp) |
| 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](presets/preset_07.webp) |
| 8 | Beat pulse | pulse | unit | 0 | 60 | | A ring in your colour leaves the centre on every beat | [8](presets/preset_08.webp) |
| 9 | Wipe red blue white | wipe | red/blue/white | 1 per bar | 40 | 3 | A new colour sweeps round each bar | [9](presets/preset_09.webp) |
| 10 | Platter 12 arms | segments | unit | 1 per platter turn | 60 | 12 | Twelve spokes that turn with the platter | [10](presets/preset_10.webp) |
| 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](presets/preset_11.webp) |
| 12 | Forest drift | palette | forest | 0.0625 per bar | 128 | | Half the palette round the ring, once round every 16 bars | [12](presets/preset_12.webp) |
| 13 | Cloud sweep | sweep | cloud | 0.5 per beat | 200 | | A long-tailed head, half a turn a beat | [13](presets/preset_13.webp) |
| 14 | Rainbow pulse | pulse | rainbow | 0.25 per bar | 120 | | A wide ring on every beat, its colour drifting through the rainbow | [14](presets/preset_14.webp) |
| 15 | Stripe wipe | wipe | stripes | 0.5 per bar | 0 | 8 | A hard-edged new colour every two bars, eight in turn | [15](presets/preset_15.webp) |
| 16 | Slow colour fade | solid | rainbow | 0.125 per bar | | | The whole ring through the rainbow every 8 bars | [16](presets/preset_16.webp) |
| 17 | Lava noise | noise | lava | 0.0625 per bar | 90 | 1 | Soft blobs drifting slowly and changing shape | [17](presets/preset_17.webp) |
| 18 | Ocean kaleidoscope | noise | ocean | -0.125 per bar | 140 | 5 | A five-fold pattern, slowly backwards, changing shape | [18](presets/preset_18.webp) |
| 19 | Platter noise | noise | party | 1 per platter turn | 120 | 3 | A three-fold pattern that turns with the platter, changing shape | [19](presets/preset_19.webp) |
| 20 | Ocean ripples | ripples | ocean | 0.5 per bar | 120 | 3 | Three rings flowing out from the centre, fading as they go | [20](presets/preset_20.webp) |
| 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](presets/preset_21.webp) |
| 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](presets/preset_22.webp) |
| 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](presets/preset_23.webp) |

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](presets/palettes_sheet.png)

| # | 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-leditor) | 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](#the-leditor) 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](screenshots/webui_leds.png)


`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](#the-leditor) 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](#8-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:

| Item | What it opens |
|---|---|
| **Live** | The [live page](#the-live-page-live) |
| **LEDitor** | The [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 live page: the Turntable picture, the Light and Effects boxes (with the effect settings) and Tempo](screenshots/webui_live.png)

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](#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](#the-menu).

| 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](#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](#presets-and-the-knobs), 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](#the-leditor): 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](#motor--fan-tab) 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*.

![The LEDitor: the ring as the LED engine draws it, with the preset editor and the palette editor under it](screenshots/webui_sim.png)

- 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:

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; **&times;** takes it out; **Add a colour** puts one at the end. Drag a colour by its **&#8942;&#8942;**
   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](#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](FAQ.md) 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](screenshots/webui_status.png)

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](#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](#8-art-net-and-sacn). Nothing on this tab can be changed.

#### Network tab

![The Network tab: hostname, Ethernet, Wi-Fi and the OSC port](screenshots/webui_network.png)

| 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](#several-turntables-on-one-network). |
| **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](#9-network-setup). 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](screenshots/webui_defaults.png)

| 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](#8-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](https://kennedy-williams.net/unclemagic/docs/#fixtures).

#### Motor & fan tab

![The Motor & fan tab: speed, direction, slow-speed floor and fan](screenshots/webui_motor.png)

| 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](#11-care-and-maintenance). |

### Password

![The Password tab: setting the password](screenshots/webui_security.png)

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](screenshots/webui_backup.png)

- **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`)

![The log page](screenshots/webui_log.png)

**`/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](screenshots/webui_firmware.png)

**`/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](#presets-and-the-knobs). |
| `/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](#editing-presets), 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](#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](#layouts) and
   [Fixture files](#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.

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

![One universe: the eight pairs of LEDs (orange) that share an element, with the element and channels each one takes](diagrams/artnet-single-pairs.svg)

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 `hflip` and `vflip`) 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](index.html#fixtures) 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](#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:

- **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.**
  1. Set a password on the settings page (once).
  2. Open `http://liquidturntable.local/update`, choose the new `.bin` file (not the one ending
     `.merged.bin`) and press Upload.
  3. 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/log` shows 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:

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](FAQ.md).

| 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](#6-controlling-it-from-a-phone-or-computer)). Make sure your phone or computer is on the same network. Then try the TAP-button reset in [section 8](#9-network-setup). |
| **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](#9-network-setup). |
| **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 |

---
