TableBots Help & Troubleshooting

TableBots brings small animated robots onto your real tables in Apple Vision Pro. The app uses world sensing to find flat surfaces and hand tracking so the robots can react to your fingertip.

Getting Started

  1. Open TableBots.
  2. If the robots do not appear automatically, select Release the Robots.
  3. Look around your space and give TableBots a moment to find a table or other flat horizontal surface.
  4. Tap a detected table to add a robot.
  5. Tap a robot to make it celebrate.
  6. Drag a robot to pick it up and move it.
  7. Use Add Robot to add another robot.
  8. Use Clear to remove all robots.
  9. Use the speed slider to slow down or speed up the robots.

TableBots remembers your robot crew between launches. Choosing Clear removes the saved crew.

Permissions

World Sensing

Required to find tables and flat surfaces.

Hand Tracking

Used so robots can notice and react to your fingertip.

If you denied a permission, open the Vision Pro Settings app, find TableBots, and enable the missing permission. Then quit and reopen TableBots.

Robots Do Not Appear

  1. Make sure the immersive space is open. The main button should say Put Robots Away when robots are active.
  2. Close any other app that is currently using an immersive space. visionOS only allows one immersive space at a time.
  3. Look slowly around the room so Vision Pro can understand the space.
  4. Use a real table, desk, countertop, or another clear horizontal surface.
  5. Improve lighting if the room is dark.
  6. Move shiny, transparent, or highly reflective objects out of the way.
  7. Restart TableBots.

If TableBots cannot use plane detection, it may show a virtual table instead.

Add Robot Is Disabled

The Add Robot button is only available when the immersive space is open and TableBots has found at least one usable surface.

If the button is disabled, use Release the Robots, then look at a table until the status message says a surface was found.

Tapping the Table Does Nothing

TableBots can only place robots on surfaces it has detected.

  1. Look directly at the tabletop for a few seconds.
  2. Move closer to the table.
  3. Make sure the table is mostly clear.
  4. Move the TableBots control window so it is not blocking the table.
  5. Quit and reopen the app if tracking seems stuck.

Robots Are Floating, Misplaced, or Walking Strangely

This usually means spatial tracking changed after TableBots detected the table.

  1. Keep the table still while using the app.
  2. Avoid using the app in very dim light.
  3. Select Put Robots Away, then Release the Robots again.
  4. Quit and reopen TableBots.
  5. If needed, clear the robots and add them again.

Robots Are Too Fast or Too Slow

Use the Speed slider in the control panel.

  • Move left to slow robots down.
  • Move right to speed robots up.

I Cannot Hear Robot Sounds

  1. Check the Vision Pro volume.
  2. Make sure system audio is not muted or very low.
  3. Check whether another app is playing audio.
  4. Quit and reopen TableBots.

My Robots Changed or Disappeared

TableBots saves your robot crew locally on your device. Robots may reset if you choose Clear, delete and reinstall the app, or remove app data from the device.

Simulator Behavior

When running TableBots in the visionOS Simulator, real table detection is not available. The app uses a virtual table so you can still try the experience.

Still Need Help?

Please include the following when contacting support:

  • Your device model
  • Your visionOS version
  • The TableBots app version
  • What the status message says in the app
  • Whether World Sensing and Hand Tracking are enabled
  • A short description of what happened and what you expected