Why Osmo Pieces Aren't Recognized: Troubleshooting Tips

Quick answer

Most Osmo recognition failures come from one of three things: a smudged or misaligned reflector, lighting that is too dim or too harsh, or the wrong base for your tablet. Clean the reflector, move to even indirect light, and confirm your base matches your iPad model before assuming a game or piece is broken.

Your child places a tangram piece in front of the iPad, and nothing happens. The screen keeps waiting. Before you order a replacement or assume the app is broken, work through the physical setup in order — reflector, light, base, then app.

Osmo games depend on a small mirror and a camera working together, so tiny physical problems look like software failures. This guide separates the symptom from the likely cause and tells you when to stop troubleshooting and choose a different fix.

Start with the reflector, not the app

The reflector is the most common culprit. A fingerprint, a smear of sunscreen, or a piece of lint on the mirror changes what the camera sees. Take the reflector off, breathe on the mirror, and wipe it with a dry microfiber cloth. Avoid paper towels, which can leave fibers behind.

Check that the reflector is seated fully in its clip. If it sits even a few millimeters high or low, the camera aims at the wrong spot on the table. Re-seat it until it clicks or sits flush, then relaunch the game so the camera recalibrates.

• Clean the reflector with a dry microfiber cloth, not a wet wipe.
• Re-seat the reflector until it sits flush in the clip.
• Relaunch the app after any physical adjustment.

Check lighting and play surface

Osmo needs even, indirect light. Direct sunlight or a bright overhead lamp can wash out the play area, while a dim corner leaves the camera with too little contrast. Move the iPad so light falls evenly across the table, and avoid strong backlight from a window behind the setup.

The surface matters too. A shiny or glass table creates reflections that confuse the camera. A matte table, a plain placemat, or the box the kit came in gives the camera a cleaner view of the pieces.

• Avoid direct sun and single bright lamps aimed at the play area.
• Use a matte, non-reflective surface under the pieces.
• Keep the play area clear of clutter that the camera might read as pieces.

Confirm your base matches your tablet

If the base does not hold your iPad at the correct angle, the camera cannot see the play area no matter how clean the reflector is. Osmo makes different bases for different tablets, and using the wrong one produces exactly the symptom you are seeing: pieces on the table, nothing on screen.

For iPad, the Osmo New Base & Reflector for iPad is the current base. If you are setting up for the first time, confirm you have the base that matches your tablet model before you troubleshoot further. The base is required to play Osmo games, so a missing or mismatched base is not a software problem.

• Check that the iPad sits at the angle shown in the setup guide.
• If you borrowed a base from another tablet, confirm it is the right one.
• A base that wobbles or lets the iPad slide will cause intermittent recognition.

Rule out the app and the pieces

Once the physical setup is clean and correct, test the app. Close the game completely, reopen it, and let the camera preview load before your child places a piece. If the preview looks blurry or dark, the problem is still physical. If the preview looks sharp but pieces still fail, try a different game in the same kit to see whether the issue follows one game or all of them.

Pieces themselves rarely fail, but they can be misread if they are stacked, upside down, or partially off the play area. Spread them out and keep them flat. If one specific piece never works while others do, set it aside and test with a different piece from the same game.

• Force-close and reopen the app before each test.
• Wait for the camera preview to load before placing pieces.
• Test a second game to see whether the problem is app-specific.

When to stop troubleshooting and replace a part

If you have cleaned the reflector, fixed the lighting, confirmed the base, and the camera preview still looks wrong, the reflector or base may be damaged. Scratches on the mirror or a cracked clip are not fixable with cleaning. At that point, replacing the reflector or base is the practical move.

If the preview looks correct but only one game fails, the issue is likely the app or that specific game's pieces. Reinstall the app, and if the problem persists, contact Osmo support with your tablet model and the game name. Do not keep buying accessories hoping one fixes it.

• Stop cleaning and replace the reflector if the mirror is scratched.
• Stop adjusting and replace the base if the clip is cracked or loose.
• Contact support if the preview is sharp but one game still fails.

Diagnosis: match the symptom to the fix

• Screen shows nothing when pieces are placed: Clean the reflector with a dry microfiber cloth and re-seat it until flush. Relaunch the app and check the camera preview. If the preview is still dark or blurry, move to lighting and base checks.
• Pieces work sometimes but not always: Check for direct light, a reflective table, or a base that lets the iPad slide. Move to even indirect light on a matte surface. Intermittent recognition is almost always a lighting or stability issue, not a broken piece.
• One game fails while others work: Force-close and reopen that game, then test a different game in the same kit. If only one game fails, the issue is likely app-specific. Reinstall the app or contact support rather than replacing hardware.
• Preview looks sharp but pieces still fail: Spread pieces flat, keep them inside the play area, and test with a different piece from the same game. If a single piece never works, set it aside and test another to confirm.
• Cleaning and lighting fixes do not help: Inspect the reflector for scratches and the base clip for cracks. Replace the damaged part. Stop troubleshooting and replace the reflector or base if either is physically damaged.

Parts that matter for recognition

• Osmo New Base & Reflector for iPad: To launch into the Osmo universe, just stand your iPad in this base, clip on the reflector and play. This is the base-and-reflector pair that positions the iPad camera correctly. If your current base does not hold the iPad at the right angle, no amount of cleaning will fix recognition.
• Genius Tangram: Arrange tangible puzzle pieces into matching on-screen shapes. Play with a friend or challenge yourself to more advanced levels as your handy-work lights up with each victory. Tangram is a good test game because it gives immediate visual feedback. If pieces light up here but not in another game, the problem is likely app-specific rather than physical.
• Osmo Large Carrying Case: Specifically designed to fit the new Osmo Base for iPad, our Large Carrying Case fits the Osmo Creative Board plus up to four Osmo games depending on storage container size. Storing the base and reflector in a case protects the mirror from scratches and dust between sessions, which is one of the most common causes of recognition problems over time.

Work through the checks in order: reflector, lighting, base, then app. Most recognition problems resolve at the first or second step, and the few that do not usually point to a damaged reflector or base rather than a broken game.