Skip to content

Connection ​

The hub decides which robot the app talks to. It is the first screen you see after startup. The robot name and connection state sit at the top left, and the Control button at the bottom right opens the control home once the robot is connected — before that it reads Opens once connected. Nothing on these screens is sent to the robot itself.

The Store button next to Profile at the top right opens the store: choose a model and options, look at the build in 3D, and send it with Get a quote, or send any question with Contact us — photos or PDFs can be attached. Sending needs an internet connection, and Contact us shows only while the app can reach the internet. On a narrow screen the button shows only its box icon.

On the very first start — no saved robot and no account — the app opens the Access code screen instead. Press Skip to go straight to the hub, and the app starts looking for a robot on the robot's network on its own.

Status line ​

The hub status line

The robot name has a colored dot in front and the state after it:

TextMeaning
Connect to the robot's WiFiNo robot is saved yet
Not connectedA robot is selected but not connected
Connecting…A connection attempt is in progress
Connected · routeThe app is talking to the robot — the route is local network, WAN, or remote. The robot battery is at the right of the header
Connection failed · reasonThe attempt failed — press Reconnect
Not on the robot's WiFiThe robot is on its own network, but this device is on another one
Remote — access code neededA remote robot is selected but the access code is not stored — press Enter code

When the device is on the wrong network the line names the robot's WiFi if the app knows it (Robot WiFi(SSID) — please switch to it). On Linux desktop and Steam Deck, the Switch WiFi button next to it joins that network directly, or opens the network list. On Android, WiFi settings opens the system Wi-Fi screen.

Selecting a robot ​

Select robot

Tap the robot name (▾) to open Select robot. It lists the robots saved on this device, plus the robots assigned to your account while you are logged in. A robot that is both appears once, matched by serial number. Each row shows the serial, the route (local network with the WiFi name, WAN, or remote), and when you last used it. Tap a row to connect.

The dot on each row shows the robot's state: green = connected, blue = on (its WiFi is in range), gray = off or unknown.

  • Linux desktop / Steam Deck: the list scans nearby WiFi every time it opens, and Refresh scans again; while the scan runs the dots stay gray rather than showing the previous result (a scan can take up to 15 seconds). Tapping a robot whose WiFi is not in range does not connect — the row reads No signal from the robot's WiFi. If the robot's WiFi is saved on the device and in range, the app switches to it before connecting, and the status line names the network it is switching to. If it cannot switch, a dialog says why (Can't find the robot's WiFi, WiFi password needed, Couldn't switch to the robot's WiFi) and the previous robot stays selected. A network whose password was never entered cannot be joined this way — join it once with Select WiFi. A robot that is also assigned to your account (so it can connect remotely) does not stop here: if its WiFi is out of range or the switch fails, the app connects remotely instead.
  • Android / iOS: the app cannot read or change Wi-Fi, so the dot is only green or gray. Switch in the system settings; the status line tells you which network to pick.
  • A robot that is also assigned to your account connects directly if it answers on its local network, and remotely if it does not.

The slider icon on a row opens that robot's profile, where you can change its Name or delete it with the trash icon. Deleting removes the robot from this device only — server assignments are handled in the dashboard. Remote-only robots have no profile to edit.

At the bottom, Simulator (Runs in the app) opens the control home with the in-app simulator instead of a robot, and Add robot opens the screen below.

The simulator has ten courses set on construction sites and mountains. Tap Level in the tool row at the bottom to open the Sim levels list; cleared levels show ✓ and your best time. Courses float in the air — if the robot falls, it restarts at the last gate it passed. Pass every gate in order — the next one is shown brighter and the top of the screen counts them — then stand on the finish pad to clear the level. A teal gate only counts if the robot passes it sideways while facing the arrow. The robot is always walking, so just push the joystick; set how fast with the maximum speed in Drive. Pick the view from the drop-down at the top center: Third person, First person · front, First person · rear or Stairs view. The first-person views look from the robot's front or rear, and Stairs view combines the front, rear and belly cameras with the joint pose, as on the robot. Reset restarts the level from the beginning.

Adding a robot ​

Add robot

Add robot offers the ways to reach a robot. Once a robot answers, it is saved by its serial number and the app returns to the hub.

Robot WiFi ​

Join the robot's WiFi (AP) and the app finds it — on its own network the robot always sits at 192.168.0.10. The check runs when the screen opens (unless a robot is already connected) and again with Check again. A new robot is named after the WiFi it was found on; rename it from its profile.

  • Select WiFi (Linux desktop / Steam Deck) opens the in-app network list. The app checks for the robot again when you close it. A saved network shows a spinner and Connecting… on its row while it joins.
  • WiFi settings (Android) opens the system Wi-Fi screen.
  • If nothing answers: No robot answered — check the robot's power and that this device is on the robot's AP.
  • If the robot found is the one already connected, the app says so instead of adding it again — switch to the other robot's WiFi and check again.

In the browser (web) build, this card just says The app (APK/desktop) searches automatically.

Connect by address ​

The browser (web) build, the desktop app and Steam Deck also offer Connect by address, for a robot behind a router, the simulator on this PC, or a robot with a public IP.

  • local network — enter the Robot IP (preset to 192.168.0.10). Connect first checks that a robot answers at that address. If none does, nothing is saved (No robot responded at this address — check the IP and robot power).
  • Local — connects to the simulator running on this PC (127.0.0.1). It is checked and saved the same way as local network, so start the simulator first. Steam Deck, which cannot run the simulator, does not show it.
  • WAN — enter the Public IP or domain. If the robot has a WebRTC token set, enter the same value in WebRTC token (only if set on the robot). Ports 8080 and 8081 must be reachable from your network.

The address takes effect only if you opened the page at localhost on the PC that runs the proxy. From another device the app shows The proxy could not switch the target — check that you opened this page via localhost on this PC. — restart the proxy with --robot <new IP> instead.

Access code ​

Enter access code opens the keypad. Enter the 4-digit code from the dashboard one time, and the robots assigned to your account show up in Select robot and connect remotely over LTE from then on. The robot does not need a public IP.

Checking the code needs the internet. While it checks (Checking…), Cancel lets you enter it again right away, and Skip still works. If the server cannot be reached within 5 seconds, Cannot reach the server — check the internet connection appears.

A remote connection offers the same features as a direct one — logs, black box, media, settings, the SLAM map, and software update all work. SLAM is view-only remotely; SLAM commands that move the robot work only on the robot's network. Photos and videos download completely before they play, so they take longer over LTE. A robot running older software shows This robot's software does not support this feature remotely for these screens until it is updated.

The Profile button at the top right shows the account and the number of assigned robots. Log out drops the account's remote robots from the list. Robots saved on this device stay.

WARNING

The access code is a credential. Do not share it, and use Log out on a shared device.

Automatic connection ​

The app connects on its own in these cases:

  • Start-up — the app checks the robot's network first. If a robot answers, it is added (or updated) and connected, and the app skips the hub and opens the control home. If none answers, the desktop app — not Steam Deck — connects to a MuJoCo simulator running on the same PC, and if there is no simulator either, it selects the robot you used most recently. On Linux desktop and Steam Deck, if that robot's WiFi is known and this device is on another network, the app asks before joining it (Switch to the robot's WiFi?): Switch WiFi joins the robot's network, No keeps the network you are on — choose No while you are downloading a software update. After No, start-up leaves the network alone until you restart the app; picking the robot from Select robot still switches.
  • Network change — when the device joins a robot's WiFi, the app checks the robot's serial number and connects to it, adding it to the list if it is new. This also moves a remote connection to the direct one when you come within range.

A robot without a serial number is still saved and listed. The app tells those robots apart by their WiFi name.

My device WiFi ​

The WiFi chip in the control home's top bar shows the signal strength. Tap it to see My device WiFi — the network your device is on and whether it is the robot's network.

  • The badge reads Robot network in green when your device address is in the same subnet as the robot IP. Otherwise it reads Not robot network in amber, with a warning that you cannot reach the robot until you join the robot AP. Both are hidden while you are connected remotely, since a remote connection does not use the robot's network.
  • Linux desktop / Steam Deck: Select WiFi opens an in-app list of networks to join. System settings opens the OS network settings instead.
  • Android: Android does not allow in-app scanning, so System WiFi settings opens the device's Wi-Fi settings screen. Pick the robot AP from the list, then press back to return to the app. The app needs location permission to show the SSID — tap the hint line to grant it. If you have already granted it and the name still does not appear, device location is off; tap the hint line to turn it on.
  • iOS and web builds show a note to connect from the system settings instead.

Connection status in the top bar ​

In the control home's top bar, the status light next to the logo summarizes the connection:

LightMeaning
GreenEverything is normal
AmberConnected, but something needs attention — the robot reports a warning, the vision stream is down, or another device holds control
Red, blinking fastThe robot reports a fault
RedNo connection to the robot

Tap the light to open Overall system status. It lists IMU, CAN, FindPose, Control, Vision, and Ownership, each with a green or amber dot. Tap a row marked Run ▸ to retry that step. Ownership · Take ▸ takes control back when another device is holding it.

Below those rows, Overall system status lists the problems the robot itself reports, one line per area: Battery low, Battery problem, Leg problem, Communication problem, Camera problem or Emergency stop. A red dot is a fault and an amber dot is a warning. An item appears once the problem has lasted a few seconds and goes away a few seconds after it clears. Tap an item marked ▸ to open the screen where you can check it: battery items open Maintenance › Power / System, leg and communication items open Maintenance › Robot Check.

When the robot reports a fault, a red Needs check: banner also appears under the top bar, on the control home and on the other screens. It names the area of the first fault, and tapping it opens the same screen as the item. The banner has no close button — it goes away when the fault clears. Warnings only change the light.

The control home has no disconnected banner: if the robot drops and does not come back within 8 seconds, the app returns to the Hub, which is where the status line, Reconnect, and Switch WiFi live. It also returns to the Hub the moment the connected robot changes — turning a robot off frees its WiFi, and the app may find a different robot on the robot network and connect to that one.

Overall system status

What developer mode adds here is collected on Developer mode.

This user manual is intended for RBQ users.