A VR file carries no reliable internal description of how it should be displayed. Players read tags from the file name and guess from the aspect ratio, and when the guess is wrong the picture is wrong in one of three recognisable ways.
What you see, and what it means
- Two images side by side: stereo setting, not projection. Set side by side.
- Squeezed into the middle with space around it: a 180 file playing as 360.
- Flat centre, stretched edges: a fisheye file playing as equirectangular.
- Eyes fighting, depth inverted: left and right swapped.
Fix the stereo first
Stereo errors are obvious and projection errors are subtle, so settle the easy one before judging the hard one. If you see two of everything, the player is treating a side-by-side frame as a single flat image: set the stereo mode to side by side, tagged _LR in most file names. If depth feels inverted and your eyes will not settle, swap left and right.
All eight players in this guide expose these settings.
Then the projection
A 180 file played as 360 appears squeezed into the centre of your view with empty or repeated content around it. A 360 file played as 180 fills your view with half the scene stretched across it. Either way, change the projection to match what the file actually is.
Fisheye is the subtle one. A scene shot on a wide fisheye lens and played as plain equirectangular looks flat in the middle and stretched towards the edges, and most people describe it as soft rather than as wrong. The fix is to select fisheye at the right angle, or better, the right lens.
Players that let you name the lens
HereSphere publishes named profiles in its FAQ: fisheye 180 linear, MKX200, MKX220, VRCA220 and RF52. DeoVR documents fisheye at 180, 190 and 200 degrees with MKX correction plus 220. Pigasus auto-detects the same tags. SKYBOX lists VR180, 360, 200 and 220 degree content.
4XVR and Prism VR do not mention fisheye at all, so on those two a wide-lens scene may have no correct setting available.
Why renaming breaks it
The tags live in the file name, so a tidy rename removes the only description the player has. Organise with folders and leave the names as the studio wrote them. This is also why a DLNA server that cleans up titles can make every file in a library play wrongly, and why SMB is the better protocol for a VR collection.
When there are no tags at all
Try 180 side by side first, since it covers most of this market. If the edges look stretched, try fisheye at 200 degrees. If the image is squeezed into the middle, it is a 360 file. Three attempts cover almost everything.
Other fixes are in the fixes section, and the formats behind all of this are explained in the formats section.
Why do I see two pictures in my headset?
The player is showing a side-by-side stereo frame as one flat image. Set the stereo mode to side by side.
Why is the scene stretched at the edges?
It was shot on a fisheye lens and is being played as plain equirectangular video. Choose fisheye, or the named lens if your player supports it.
Which player handles this best?
HereSphere, because you can name the lens rather than relying on detection. DeoVR and Pigasus document their own detection and handle most files.
Can I fix it by renaming the file?
Yes, if you add the right tags, and that is also how people break working files. Add rather than replace.