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.
| Ring | Meaning | Sound |
|---|---|---|
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
| Ring | Meaning | Sound |
|---|---|---|
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
| Ring | Meaning | Sound |
|---|---|---|
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
| Ring | Meaning | Sound |
|---|---|---|
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.
| Ring | Meaning | Sound |
|---|---|---|
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.
| Sound | When |
|---|---|
| Rising two-tone chime | Every power-on, a little before the ring lights up. The hub's setup system is starting. |
| Two short equal beeps | Setup mode has begun; the ring breathes amber. |
| Bright rising two-tone | The hub joined your WiFi: during setup (it restarts itself right after) and again at every later power-on. |
| Falling two-tone | The hub could not join your WiFi. Hold the button 5 s (one long beep), let go, and set it up again. |
| Three rising notes | The hub software is starting (purple heartbeat). |
| Two short high tones | Ready. The ring shows the logo. |
| Three falling notes | Shutting 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 holding | Button held 10 s: factory reset, everything erased, like a fresh flash. The hub comes back in setup mode. |
| One short beep | A short press of the HAT button: "I'm alive." |
| Two-note chime | Activated: the hub signed in with your account and the license attached. |
| Rising three-note | An IR code was learned from your remote. |
| Two low beeps | Something 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 warble | Bluetooth pairing started. |
| Four rising notes | Another Iris joined the mesh. |
| Two taps and a high note | A software update is available (once per version). |
| Two quick high chirps | The 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 light | Meaning |
|---|---|
| Flickering | Reading or writing the card. Normal while booting. |
| Slow blink (1 s on, 1 s off) | Setup mode, together with the amber ring. |
| Fast blink | Joining your WiFi, right after you tapped Connect. |
| Solid on | On your WiFi; the hub software has taken over and the ring tells the story from here. |
| Triple flash, pause | Could not join your WiFi, or a reset is in progress. |
| Off | No 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.
omniremote.us · Patent Pending · OmniRemote™ is a trademark of One Eye Enterprises LLC