Support

Stuck? Come and ask πŸ†˜

The fastest help is the chat β€” someone there has usually hit the same thing with the same headset. Below that, the problems that come up most and what actually fixes them.

Discord

The main place. Bug reports, setup help, which depth mode works in which game, and the builds people are testing before they ship. Developers read it.

Join the Discord

Telegram

News, release notes and the occasional build worth trying early. Lighter traffic than Discord β€” good if you only want to know when something ships.

Open Telegram
Troubleshooting

What usually goes wrong

FlatVR names which part is missing rather than leaving you to guess. The same messages appear in the app and on the in-VR overlay, so you can read them without taking the headset off.

DEPTH MAP NOT FOUND

The picture arrives, the depth does not

ReShade is sending the frame but no depth buffer. Two candidates, in order: the Copy depth buffer before clear operations box under Generic Depth is off β€” it is off by default and a great many games need it β€” or no buffer is selected in that list.

Pick the one with a vertex count in the millions, not a square one. Full walkthrough β†’

No picture from the ReShade addon

Nothing arrives at all

Either you installed the plain ReShade build instead of the one with add-on support β€” the plain build cannot load add-ons at all, and fails silently β€” or FlatVR_DepthProvider.addon64 is not sitting next to the game's .exe.

Press Install into Game… on the ReShade page again: it installs the add-on build of ReShade and puts the add-on in the right folder. This is the single most common reason the feature does not work.

No ReShade banner on launch

ReShade is not in the game at all

If the loading bar never appears when the game starts, ReShade did not install into it. Run Install into Game… again and, in ReShade's installer, pick the API the game actually uses β€” usually DirectX 11 or 12. Online games with anti-cheat may refuse ReShade altogether.

Capture stuck at 60 fps

The monitor is the ceiling, not FlatVR

Windows hands over frames at the display's rate, so a 60 Hz monitor caps the capture at 60 regardless of what the game renders. Create a virtual monitor at your headset's refresh rate and launch the game there.

How to set one up β†’

Depth is inverted

Near things recede, far things come at you

Modern engines usually use reversed-Z, where the nearest surface is 1 and the far plane 0. Read the other way round it puts the background in front of the objects, and no amount of separation or convergence fixes it because the sign is wrong. Turn on Invert Depth Map on the ReShade tab.

The picture stutters with AI depth

Let the card fit the frame in

First, the Status tab: hardware-accelerated GPU scheduling (HAGS) decides whether the card can put a frame in between the depth model's work. Off, depth stutters β€” the page switches it on for you. Then set Performance Mode to Game, or to Cinema Lite / Game Lite on a weaker card, and try Run the depth model in pieces.

Watch Inference (DML) in the stats panel while you tune.

Black picture from a browser

Netflix, Prime Video and other protected video

Protected video is blacked out for every capture program, FlatVR included, and FlatVR says so when it happens. Turn off hardware acceleration in the browser's settings and restart it. Your own files and YouTube play in FlatVR's video player without this problem.

FlatVR just closes

A crash that leaves no window

Some crashes end the app on the spot. A small helper process, the crash watchdog, catches exactly those and offers to send the report β€” keep Run the crash watchdog on under Status β†’ Crash reports. Nothing is sent unless you press Send, and that one click is what most fixes are made of.

Reporting a bug

What to bring with you

A report with a log attached gets fixed; a report without one gets a request for a log.

1

Turn on DEBUG MODE

The checkbox at the bottom of the window. It adds a Debug tab with the raw log β€” switch it on before reproducing the problem, not after.

2

Reproduce, then Save Log

Do the thing that breaks, then press Save Log on the Debug tab. That file is what to attach. If the app crashed, the crash report window's Send carries the log and the dump for you.

3

Say what you were running

FlatVR's version (top of the Status tab), headset and runtime, the game, the depth mode, and whether it was a virtual monitor or a direct capture. Those pin down most reports on their own.

Report it on Discord