Troubleshooting

Use this guide when something feels confusing, slow, or stuck on mobile.

Upload Problems

If a game will not upload:

  1. Make sure the file type is supported.
  2. Try Auto system detection.
  3. Make sure you have enough storage.
  4. Use Wi-Fi for large files.
  5. Keep the upload page open until it finishes.
  6. If the upload stops, tap cancel and try again.
  7. If a ZIP fails, upload the game file directly.

Troubleshooting: Upload progress on mobile

Emulator Loading Problems

If a game opens but does not start:

  1. Refresh the page and try Play Now again.
  2. Check that the game file matches a supported system.
  3. Try a different core in In-Game Settings.
  4. Clear the local ROM cache in Settings.
  5. Upload a clean copy of the game if the file may be damaged.

Slow or Choppy Gameplay

Try these steps:

  1. Close other browser tabs.
  2. Turn off battery saver mode on your phone.
  3. Rotate to landscape if the layout feels cramped.
  4. Open Shaders and choose Original.
  5. Lower Master Volume if your phone is struggling.
  6. If using netplay, turn on Performance Mode.

Touch Controls Feel Wrong

  1. Open the in-game menu.
  2. Tap Controls.
  3. Switch between Static and Dynamic D-pad style.
  4. Tap Hide Controls if you are using an external controller or remote phone.
  5. Rotate your phone and try again.

Troubleshooting: D-pad style choices

Save Problems

If a save is missing:

  1. Open the game.
  2. Tap the in-game menu.
  3. Tap Open Saves.
  4. Check Manual.
  5. Check Auto.
  6. Check In-game.

If you used the game's own save menu, tap Export In-Game Save after saving inside the game.

Screenshot Problems

If screenshots do not appear:

  1. Take the screenshot again from the in-game menu.
  2. Open the game details page.
  3. Scroll to Screenshots.
  4. Check storage usage if screenshots still do not save.

Cheat Problems

If a cheat does not work:

  1. Check that the code matches the game and region.
  2. Turn the cheat off and on again.
  3. Restart the game after enabling the cheat.
  4. Remove cheats that make the game unstable.

RetroAchievements Problems

If achievements do not show:

  1. Open Settings > Integrations.
  2. Make sure Enable RetroAchievements is on.
  3. Check your username and password or API key.
  4. Tap Verify Credentials.
  5. Start a supported game.
  6. Try a clean ROM if the game is not recognized.

Netplay Problems

If netplay cannot connect:

  1. Tap Refresh in the room list.
  2. Confirm the Room ID is correct.
  3. Make sure both players are online.
  4. Use Internet mode if you are not on the same Wi-Fi.
  5. Use LAN only when both devices are on the same local network.
  6. Ask the host to start a fresh room.

Remote Controller Problems

If the controller phone will not join:

  1. Make sure the main device is still running the game.
  2. Scan the QR code again.
  3. Enter the room code manually if scanning fails.
  4. Refresh the controller phone.
  5. Keep both devices on a stable network.
  6. Turn off VPN or private relay features if connection fails.

Storage Problems

If storage is full:

  1. Tap Profile.
  2. Tap Settings.
  3. Tap Storage.
  4. Check whether ROMs, saves, or screenshots use the most space.
  5. Delete games, saves, or screenshots you no longer need.
  6. Upgrade if you need more room and the option is available.

Install or PWA Problems

If install does not appear:

  1. Use Safari on iPhone or Chrome on Android.
  2. Refresh Rebit.
  3. Sign in again.
  4. Tap Profile and check the App section.
  5. On iPhone, use Safari's Share button and choose Add to Home Screen.

Pro Tips

  • Save before changing cores.
  • Use Save State before difficult game sections.
  • Use the game's own save menu, then tap Export In-Game Save for games with battery saves.
  • Keep a few auto saves, but delete old ones if storage gets tight.
  • Use Original shader when performance matters.
  • Share your public profile link with friends so they can follow you.
  • Use Discover to find active players and popular games.
  • For netplay, use Wi-Fi and keep both phones charged.

Pro Tip: Profile and activity overview