# Uncle Magic's Liquid Turntable: FAQ

Short answers to the questions that catch people out. Each one says what is happening and what to do; the
[User Guide](USER_GUIDE.md) has the details. If something is plainly broken, start with the guide's
[Troubleshooting](USER_GUIDE.md#12-troubleshooting) table.

## Contents

1. [Phones and browsers](#phones-and-browsers)
2. [Lighting](#lighting)
3. [Saving your changes](#saving-your-changes)
4. [Tempo and the platter](#tempo-and-the-platter)
5. [Network, updates and power](#network-updates-and-power)

---

## Phones and browsers

### Firefox on my Android phone opens the unit, but Chrome says *ERR_TOO_MANY_RETRIES*

Chrome hasn't been given permission to use your home network. Newer versions of Android ask for this separately for
each app, and until it is allowed, Chrome can't reach any device on the network, including the turntable.

To fix it, open the phone's **Settings → Apps → Chrome → Permissions**, allow **Nearby devices** (some phones call it
**Local network**), then reload the page. Do the same for any other app that can't reach the unit.

### `http://liquidturntable.local/` doesn't open on my Android phone

Some Android phones don't understand `.local` names. Use the unit's number address instead, for example
`http://10.1.10.86/`. To find it, open any of the unit's pages on another device and look at the right of the menu bar
(it shows the address and, after a colon, the OSC port: leave the port out), or look in your router's list of
connected devices.

The address can change when the router restarts. To keep it fixed, reserve it for `liquidturntable` in your router,
then bookmark it on the phone.

### What do I type when the page asks for a user name and password?

The user name is always **`admin`**. The password is the one set on the settings page's **Password** tab. If no
password has been set, the pages don't ask, and anyone on your network can open them.

### The address on the menu bar has changed to *offline* in orange

The page can't reach the unit. Either the unit is off or restarting (after **Save & Reboot** it takes about 10
seconds), or your phone or computer has left the network. You don't need to reload: the page reconnects by itself
when the unit answers again.

### My phone and my laptop show the boxes in a different order

The order of the boxes, and which ones are folded, are remembered by each browser, not by the unit. Arrange them once
on each device you use.

### How do I move a box on a phone?

Press and hold the grip (⋮⋮) at the left of the box's title, then drag. To move a box past the edge of the screen,
drag it near the top or bottom and the page scrolls by itself.

### The live page makes my phone warm, or slow

The **Turntable** picture updates about 10 times a second, which keeps the phone busy. Fold the Turntable box (tap its
title) when you don't need it: while it is folded, the picture isn't fetched at all.

### The picture on the live page looks brighter than the ring

The unit limits how much current the LED ring can draw, to protect the LEDs and the power supply. Bright white is cut
back the most. The picture shows the colours before that limit, so white can look brighter on screen than on the
ring. No screen shows the LEDs' real brightness or colour exactly, so use the picture for patterns and timing.

### The LEDitor's picture doesn't match the ring

The LEDitor shows each preset exactly as it is written, without your hue shift, saturation and brightness, so you see
what you are editing. The ring, and the live page's Turntable picture, do include those settings.

## Lighting

### Lighting software (Art-Net or E1.31) doesn't change the ring

Work through these:

1. **Turn receiving on.** It is off on a new unit: tick the receive box on the settings page's **Art-Net** tab and press
   **Save & Reboot**.
2. **Pick the Art-Net / sACN preset** (built-in preset 23) on the live page or with the VAL knob. The ring shows what
   the software sends only while that effect runs; on any other preset the software has no effect.
3. **Check the universe number.** The unit counts universes from 0, and some programs count from 1. If the unit is set
   to universe 1 and nothing arrives, try sending to universe 2 in your software (or set the unit to 0).
4. **Send to the right place.** Use the unit's address (or broadcast on your network), on UDP port 6454 for Art-Net or
   5568 for E1.31.

To see what is actually arriving, open the settings page's **Status** tab: its **Art-Net / sACN** box. It lists every universe that reaches the
unit, which computer sent it, and whether the unit is using it. It works even while receiving is off, so it shows a
wrong universe number at once.

### The Art-Net preset isn't in the list, or the VAL knob skips it

It is offered only while receiving is on: tick the receive box on the settings page's **Art-Net** tab and press
**Save & Reboot**.

### Two turntables get the same Art-Net, but one shows a scrambled picture

Check **Layout** on both units' **Art-Net** tab: it must match the way the lighting software lays out the ring. With
**One universe**, the ring takes one universe of 170 elements, and eight pairs of neighbouring LEDs share an element;
with **Two universes**, one LED per element (LEDs 1-170, then 171-178 in the next universe); **Grid** is one rectangle
of 31 x 15 pixels over three universes, for Resolume. A unit set the other way
from the software still shows the picture, but every LED after the first shared pair takes a neighbour's colour, more
of them further round the chain, so the bars come out shifted sideways and broken up. Set both units the same as the
software, and the **First universe** too, then **Save & Reboot**. To compare two units quickly, open each one's live
page side by side (**Others** on the menu bar lists them); the Status tab's **Art-Net / sACN** box shows which
universes each one receives and uses.

### The software stopped sending, but the ring still shows its last picture

That is on purpose: with nothing arriving, the Art-Net / sACN effect holds the last frame it was sent. Pick another
preset to show something else.

### Turning the VAL knob changes the preset, not the brightness

The VAL knob has two jobs. When the unit starts, turning it picks the preset. Press the knob's button to switch it to
brightness, and press again to go back to picking presets.

### The colours look wrong for the preset I picked

The hue shift (HUE knob) and saturation (SAT knob) change the colours of every preset, and they stay set when you pick
another preset. To see a preset's own colours, press the HUE button (hue shift back to 0) and turn SAT all the way up.

A palette chosen with the EXP1 knob also replaces the preset's colours. Press the EXP1 button to go back to the
preset's own palette.

### After a restart the ring is back on plain white

The unit doesn't remember the light settings across a restart. It always starts on preset 1, which shows a single
colour (the *user colour*), with no hue shift and full saturation and brightness. That colour is white unless you
change **Starting colour** on the settings page's **Colour** tab (units set up before 2026-11-16 may start red: that
was the old factory colour, kept once the settings page has been saved).

### Turning the HUE or SAT knob does nothing

You are on preset 1 with the user colour white, and white has no hue to turn or saturation to fade. Pick a colour with
the live page's colour picker (or set **Starting colour** on the **Defaults** tab), or pick another preset; the knobs
then work as usual.

### Where did the beat flash go? / The ring doesn't flash on the beat

The beat flash is now part of each preset: its **Punch**. To get the old flash, open the preset in the LEDitor (or the
live page's effect settings), set **Punch** (how much: at 255 the ring is dark between flashes), **Punch style**
**flash**, a **Punch length** (1/8 of a beat is the old default) and **Punch every** (1 for every beat, 4 for every fourth), and
save it.

It hits on the tempo the unit is running at, pulled onto the show software's beats when they arrive (so a tapped tempo
flashes too). *Every* counts beats on from switch-on, not by the bar. OSC `/flash`, `/pulse` and `/pulsediv` are
ignored now.

### The ring changed back while I was adjusting the effect settings on the live page

The live page's **effect settings** (and OSC `/look`) change the running preset only until a preset is picked again.
Picking one, from the live page's list (even the same preset), the VAL knob or OSC `/preset`, puts the preset back as
it was saved. That is also what **Back to the preset** does. Nothing you change there is saved.

To keep a look, build it in the LEDitor's preset editor and press **Save to this number**.

### The new presets (Ripples, Sparkle, Strobe) aren't in my preset list

A firmware update never replaces your preset list, so presets added to the firmware don't appear on their own.

Either tick **Restore the built-in presets** on the **LEDs** tab and press **Save & Reboot** (this replaces your list
with the built-in one, so copy any presets of your own first), or add their lines to your list. The lines are in the user
guide's table of built-in presets.

### The ring is dimmer than it should be

First check the brightness: the VAL knob (after a press of its button) or the live page's Brightness slider.

If the brightness is high: a ring showing mostly white for a long time warms up, and above 60 °C the unit lowers the
ring's current to protect it, so the light dims a little. The settings page's **Status** tab shows the ring's
temperature and the current limit in force. See [The ring's temperature](USER_GUIDE.md#the-rings-temperature).

If the log or the live page says *BENCH*, the controller board is running with no motor driver attached (on the bench),
and it ignores the ring's temperature, so heat isn't the cause.

## Saving your changes

### I saved a preset or palette, switched off, and it was gone

Saving in the LEDitor takes effect at once, but the unit only writes it to its permanent memory the next time the
platter is **stopped**, because writing while the motor runs would make the platter stutter. If you switch off, or
press **Save & Reboot**, while the platter is still turning, the change is lost.

So stop the platter before you switch off. The same goes for the speed limit, *Every N beats* and the flash length.

### My colour temperature, user colour or speed limit went back after a restart

Changes made on the live page or over OSC last only until the next restart. The values the unit starts with are set
on the settings page: the **Colour** tab for the colour temperature and starting colour, and the **Motor and fan** tab
for the speed limit.

### How do I copy my presets to another turntable, or keep a copy?

Open **Backup** in the menu's Settings list and press **Presets and palettes** (or **Everything** for every setting as
well). Your browser saves a text file.

On the other turntable, open **Backup**, choose the file under **Restore**, tick what to bring across and press
**Restore**. Leave **Network** unticked unless you mean the two units to share an address and name.

### Which settings need Save & Reboot?

Everything on the settings page, on every tab, is saved together by **Save & Reboot**, which restarts the unit (it is
back in about 10 seconds).

The exceptions are three boxes on the **Motor and fan** tab marked *applies at once*: the speed limit (press its
**Apply**), the slow-speed floor and the cooling fan. These take effect straight away and are kept without a restart
(like presets, they are written to memory once the platter is stopped).

## Tempo and the platter

### The platter doesn't move when the unit is switched on

That is on purpose: the platter always starts stopped. Turn the main knob up, or open the live page's Tempo box,
press **more** and then **Start**.

### Tapping the TAP button doesn't change the tempo

When show software is sending a tempo, that tempo takes priority over tapping. Your taps are still sent out over the
network as OSC messages, so other equipment can use them.

### At fast tempos the platter falls out of time with the music

The platter turns once every 12 beats, and its top speed is 17 RPM. At 100% speed it reaches that top speed at about
204 BPM; above that it can't go any faster, so it falls behind the beat. With the speed setting above 100% it reaches
the top speed at a slower tempo. The live page shows a warning while this is happening.

The top speed is the **Speed limit** on the settings page's **Motor and fan** tab. 17 RPM is the fastest the mechanism
has been tested at.

### The show software stopped, but the platter keeps going at the same tempo

That is on purpose. When a tempo stops arriving, the unit keeps the last tempo it had until a new one comes in: from a
tap, from the live page, or from the software starting again.

## Network, updates and power

### I have two turntables and the wrong one answers

Every unit calls itself `liquidturntable`. If that name is already taken when a unit starts, it uses
`liquidturntable-1` instead, then `-2`, and so on, depending on which unit was switched on first. So the names can
swap between one show and the next.

To stop that, give each unit its own name: type a different **Hostname** (for example `stage-left`) on the settings
page's **Network** tab and press **Save & Reboot**.

### I've forgotten the password, or set a wrong fixed address, and can't get in

Switch the unit off. Hold down the **TAP** button, switch on, and keep holding for 5 seconds. This removes the
password, sets Ethernet back to finding its address automatically, and starts the setup Wi-Fi network (below) for 15
minutes. Your other settings, presets and palettes are kept.

### What is the setup Wi-Fi network, and why does it only show the Wi-Fi page?

When the unit has no network a minute after it is switched on (a new unit, or one at a new venue), it starts its own
Wi-Fi network, called **LiquidTurntable-** followed by four letters and digits. Its password is **`turntable`**. Join
it from a phone or laptop and a page opens where you pick your own Wi-Fi network and enter its password. If that page
doesn't open by itself, go to `http://192.168.4.1/wifi`.

That setup page is the only page available on the setup network. The password `turntable` is the same on every unit,
so anyone nearby could join; keeping everything else off that network means a stranger can't change your settings or
control the turntable. Once the unit has joined your own network, use it from there.

### Wi-Fi or Ethernet for a show?

Ethernet. It is steadier, which keeps the platter closer in time with the tempo. Wi-Fi works well within a room for
setting up and for the live page.

### The firmware update page refuses my file

Check two things:

1. **A password must be set.** Firmware updates are switched off until there is one (settings page, **Password**
   tab).
2. **Use the right file.** Choose the file ending `.bin`, not the one ending `.merged.bin`.

After an update, the new firmware has to run for 30 seconds with the network up before the unit accepts it. If it
crashes or never connects, the unit goes back to the previous version the next time it restarts.

### Can I unplug the motor or ring cable to move the unit?

Only with the power off. Unplugging the motor cable with the power on can destroy the motor driver, and the ring
cable can spark. Switch off, wait about 3 seconds, then unplug.
