Connection troubleshooting

Most connection problems come down to a sleeping cube, the wrong browser, or a stale pairing. Work down this list.

1. Wake the cube

Smart cubes sleep to save battery and don’t advertise over Bluetooth while asleep. Give the cube a few turns right before you click Connect so it’s awake and broadcasting.

2. Check your browser

You need Chrome, Edge, or Opera on desktop. If you’re on Safari, Firefox, or any iPhone/iPad browser, the cube can’t connect at all — see supported browsers. On Linux especially, the two Chrome flags in that article often fix a cube that never appears in the list.

3. Forget and re-pair

If the cube used to connect and suddenly won’t, clear the stale pairing. Remove the cube from cubrs’s device list, then also remove it from your operating system’s Bluetooth settings if it’s listed there. Reload the app and connect fresh.

4. Only one app at a time

A cube can only talk to one app at once. Close the official cube app, other browser tabs running cubrs, and any other timer that might be holding the connection.

5. Battery and interference

A low battery makes connections flaky before it dies entirely — charge or replace it. USB 3 ports, hubs, and crowded 2.4 GHz Wi-Fi can also interfere; move closer to your machine and try again.

6. GAN cubes: re-read the MAC

If a GAN cube connects but turns don’t register or look wrong, the stored MAC address may be incorrect. Remove the cube and reconnect so cubrs can re-read or re-request it — details in GAN cubes and the MAC.