OmniRemote

Iris lights and sounds

What every ring pattern and every beep means. The rings on this page are live replicas running the same frame logic as the hub, so what you see here is what the HAT shows.

The ring

Seven lights: one in the center (the hub) and six around it. At rest the ring shows the OmniRemote logo: purple center, dim white spokes, and one cyan blade at lower right, breathing slowly. What the blade does tells you the state. Cyan and rising tones are good news; red and falling tones mean something needs you; amber means "waiting for setup"; orange means "update".

Setup mode

Shown by the hub's setup system before the main software runs, the first time and after any reset.

RingMeaningSound
Amber breathing
OK Setup mode. Join OmniRemote-Iris-Setup and open the setup page. Waits as long as it takes.Two short equal beeps when it begins
Teal three times
OK WiFi settings accepted; the setup network shuts down. About 30 s later the hub joins your WiFi and restarts itself. The ring stays solid teal through the restart until the purple boot beat takes over (1–2 min).Silent on accept; bright rising two-tone once it has joined
Whole ring red blinking
Problem WiFi name or password rejected. Back to amber; the page says what to fix.Silent
Dark after a falling tone
Problem The hub could not join your WiFi (wrong password or out of range). Hold the button 5 s to return to setup mode.Falling two-tone

Starting up

RingMeaningSound
Dark, board light on
OK Booting. Up to 4 minutes on the very first boot, about a minute after that.Rising two-tone chime shortly after power-on
Purple heartbeat
OK Hub software starting; center light only. "Alive, not ready yet."Three rising notes
Blade sweeping
OK Online, waiting for the first app or browser to connect. Shown only after a fresh setup.Two short high tones (the ready tones)
Iris opening
OK First app or browser connected: the ring blooms cyan from the center, holds, then settles into the logo.Silent
Blade at rest
OK Normal operation. The logo with the cyan blade lower right, breathing slowly. Every later power-on ends here.Two short high tones when ready

Everyday

RingMeaningSound
White flash
OK Sending an IR command. One flash per command, then back to the logo.Silent
Cyan radar sweep
OK Learning an IR code: point the remote at the hub and press the button. Back to the logo when done.Rising three-note when the code is captured; two low beeps and a red blade if it timed out
Green flash, three times
OK Good news: another Iris joined the mesh, or this hub was just activated with your account.Four rising notes (mesh); two-note chime (activated)
Purple and cyan alternating
OK Pairing a Bluetooth remote from Settings. Back to the logo when it finishes either way.Quick high-low warble when it starts

Needs attention

RingMeaningSound
Red blade blinking
Problem Only the blade turns red and blinks, then the logo returns: a command could not be sent, learning timed out, activation or an update failed. The app or hub page says which. Not to be confused with the whole ring red in setup mode.Two low beeps for learn, activation and update failures; silent for a failed command
Orange pulsing
Info A software update is ready. Install it from Settings or the app, or turn on automatic updates there. Shown once per new version.Two taps and a high note
Ring filling cyan
Info Update downloading, verifying and installing. The fill repeats until it's done; don't unplug.Silent
Green blink, then logo
OK Update installed. The hub restarts its software right after (three rising notes, then the ready tones).Silent

Resets and shutdown

Resets always show and sound, even if you've dimmed the ring or silenced the buzzer. Erasing a hub is never silent.

RingMeaningSound
Orange lap, green wink
Reset Start over (Settings → Danger Zone): devices, rooms and scenes erased; WiFi, license and users kept. Back to the logo when done.Silent
Red death ring
Reset Factory reset: the ring fills red and throbs until the hub reboots. Everything is erased and the license released. It comes back in setup mode (amber).One long beep as it comes back up
Amber after a long beep
Reset Button held 5 s: WiFi settings erased, back to setup mode. Devices, license and users kept.One long beep, then the boot chime
Fade to dark
OK Shutting down or restarting (an update, a reset, or Restart in Settings).Three falling notes

Every sound

The buzzer plays short tone patterns. Rising means good, falling means trouble. While you hold the HAT button, one long beep at 5 seconds means "let go now for a WiFi reset" and three beeps at 10 seconds mean a factory reset has started. A short press is always answered with one short beep, so you know the hub is alive.

SoundWhen
Rising two-tone chimeEvery power-on, a little before the ring lights up. The hub's setup system is starting.
Two short equal beepsSetup mode has begun; the ring breathes amber.
Bright rising two-toneThe hub joined your WiFi: during setup (it restarts itself right after) and again at every later power-on.
Falling two-toneThe hub could not join your WiFi. Hold the button 5 s (one long beep), let go, and set it up again.
Three rising notesThe hub software is starting (purple heartbeat).
Two short high tonesReady. The ring shows the logo.
Three falling notesShutting down or restarting.
One long beep (1 s)Button held 5 s: let go now to reset WiFi only (license, users and devices kept). The hub comes back in setup mode.
Three beeps while holdingButton held 10 s: factory reset, everything erased, like a fresh flash. The hub comes back in setup mode.
One short beepA short press of the HAT button: "I'm alive."
Two-note chimeActivated: the hub signed in with your account and the license attached.
Rising three-noteAn IR code was learned from your remote.
Two low beepsSomething failed that you were waiting on: learning timed out, activation was refused, or an update could not be installed. The blade blinks red at the same time.
Quick high-low warbleBluetooth pairing started.
Four rising notesAnother Iris joined the mesh.
Two taps and a high noteA software update is available (once per version).
Two quick high chirpsThe buzzer test under Settings on the hub page.

The green light on the Pi board

Separate from the ring, the Raspberry Pi's own green activity light shows power and, during setup, a little more:

Board lightMeaning
FlickeringReading or writing the card. Normal while booting.
Slow blink (1 s on, 1 s off)Setup mode, together with the amber ring.
Fast blinkJoining your WiFi, right after you tapped Connect.
Solid onOn your WiFi; the hub software has taken over and the ring tells the story from here.
Triple flash, pauseCould not join your WiFi, or a reset is in progress.
OffNo power. Check the supply and cable.

Dimming and silencing

Under Settings on the hub page and in the app you can set the ring's brightness, turn individual indicators off (status, IR activity, learning, errors, notifications) and turn the buzzer off or down. Resets ignore these settings on purpose.