Connecting & Troubleshooting
Violoop connects to your computer through the USB cable — that single physical link is the whole connection. This page explains what the connection statuses mean, how reconnection works, and what to do if the device isn't detected.
It's all over USB. The link between your device and this computer is the USB cable, not Wi-Fi or your network. (Wi-Fi only gives the device itself internet access for cloud AI — it's not how the device talks to your computer.) So when something's wrong with the connection, the cable is almost always the place to look.
Getting Connected
- Plug your Violoop device into a USB port with its data cable.
- The device powers on and the app detects it within a few seconds.
- On first setup you'll be guided through signing in and, if needed, getting the device onto Wi-Fi so it can reach the cloud.
Once connected, the app shows a Connected status and you're ready to go.
Reading the Connection Status
The app shows the current state in a status pill and, when action is needed, a banner:
| Status | What it means |
|---|---|
| Connected | The device is linked and ready. |
| Reconnecting | The link dropped momentarily and Violoop is restoring it. Your session is kept — this usually clears on its own in a moment. |
| Disconnected | The device isn't reachable. Check the cable; you can also click Reconnect. |
| Needs permission (Linux only) | Your user account lacks permission to use the USB serial port. Click Fix permissions to authorize it. |
Seamless Reconnection
Brief interruptions are normal — a nudged cable, a USB hub re-shuffling, or the device restarting after an update. Violoop handles these gracefully:
- The moment the link drops, the status turns to Reconnecting but your work is not thrown away.
- If the connection returns within about 10 seconds, everything resumes exactly where it was — you just see the banner flicker and disappear.
- Violoop keeps re-checking for the device on its own, so simply plugging the cable back in reconnects it — usually within a couple of seconds, with no button to press.
If the device stays gone longer than the grace period, the app returns you to your session list and waits; it reconnects automatically as soon as the device is detected again.
When No Device Is Found
If there's no connected device, the app shows a full-screen setup gate that guides you. If it says "Device not detected," check, in order:
- The USB data cable is firmly connected at both ends — the device and the computer.
- The device's power indicator is on.
- You're using a data cable, not a charge-only cable. This is the most common culprit: some USB cables carry power but no data, and the device won't be detected over one. Swap in a known data cable if in doubt.
Then click Search Again. Replugging the cable is enough to reconnect — the manual retry button just skips the short wait.
Setting Up Device Wi-Fi
The device needs its own internet connection for cloud AI. If it's not online yet, the app prompts you to set up device Wi-Fi: it scans for networks, you pick yours and enter the password, and the app continues automatically once the device is online. (This configuration travels over the same USB link.)
Keeping the Firmware Up to Date
Violoop needs a recent enough version of the device firmware to run. If your device is behind, the app stops at a "Firmware update required" screen:
- On recent firmware, tap Update Now and the device updates itself over the internet. Keep it powered and online — it restarts during the update and the screen continues automatically when it's done (this can take a few minutes; a brief disconnect is expected and normal).
- On much older firmware, the app asks you to start the update from the device's own screen instead; it then continues on its own once the update finishes.
For devices already up to date, newer versions appear as an optional, dismissible prompt in Settings → Version & Update.
Quick Troubleshooting
The device isn't detected at all. Work through the three checks above — cable seated at both ends, power indicator on, and a real data cable. Try a different USB port. Then click Search Again.
It keeps flipping to "Reconnecting." Usually a loose or marginal cable or a flaky USB hub. Reseat the cable, plug directly into the computer instead of through a hub, and try a different port.
"Needs permission" on Linux. Your account isn't in the group that's allowed to use the serial port. Click Fix permissions in the app — replugging alone won't fix this. The fix applies on the next reconnect.
It says my firmware is too old. Follow the update screen — Update Now if offered, otherwise start the update on the device itself. Keep the device powered and connected to the internet.
Next Steps
- New here? Start with Get Started.
- Configure the device and app in Settings & Preferences.