Help

Keyboard Shortcuts

Mouse & Pointer Interactions

These interactions work on the main picture area (not on the UI controls):

Screen Capture

Open Screen Capture from the start screen to pick another application's window or your full desktop and watch it in 3D in real time. Useful for games, browser videos, and any 2D source that isn't a file Oku3D can open directly.

Click-Through Overlay

Press Ctrl + Shift + F11 to toggle click-through overlay mode. Oku3D's window stays visible on top but becomes transparent to mouse and keyboard input - your clicks and typing pass through to the captured application underneath. This lets you play a game while watching it in 3D on a single monitor. Press the hotkey again to disable. The overlay keeps Oku3D's taskbar icon visible - clicking it (or Alt+Tab back) also switches the overlay off.

Both this shortcut and the copy-diagnostics shortcut can be reassigned to any key combination under Settings > Hotkeys.

Choosing the Capture Source

Starting Screen Capture opens Oku3D's own in-app source picker with a live preview of every available screen and window - so you can see what you're about to capture before committing, and it stays usable on a glasses-free 3D display or inside a VR headset. Pick either an entire display or a single application window. The picker can also follow the active window - turn that mode on and Oku3D switches to capture whichever window you bring to the foreground, handy for hopping between apps without reopening the picker each time. The right choice depends on the application you want to capture:

• For normal Windows applications (browsers, video players, productivity apps - anything that uses the system mouse cursor): capture the entire desktop, or maximize the application's window to fullscreen. Otherwise the cursor you see on screen will not line up with the captured content inside Oku3D, because Oku3D centers and stretches the captured window to fill its viewport while the real cursor stays at its true screen position.
• For games or applications that draw their own cursor (or hide the system cursor entirely): capturing a single application window works fine. The application renders its own cursor at the correct on-screen position within its own viewport, so it scales together with the captured content.

Crop to Trim Borders

Press C and drag a box around the part of the picture to keep. This is handy when a captured window - or a downloaded 3D video - carries black borders that push the two eye views out of alignment; cropping down to the actual picture lets the stereo line up instead of showing a doubled image. Crop works on any video or image too, not just captures.

Control Your PC From VR

While watching a captured screen or window inside a VR headset, aim a controller at the picture to move the desktop mouse, and pull the trigger to click - enough to skip an ad or pick the next video without taking the headset off. Hold the trigger to drag, hold the grip while pulling the trigger for a right-click, and push either thumbstick to scroll. A controller button hides Oku3D's own controls when they cover the part of the window you're trying to reach.

Live Streams

Use the Open Stream entry on the start screen to play network streams in 3D. Paste a URL into the dialog, drop a .m3u / .m3u8 playlist file onto the window, or pass a URL on the command line - the ten most recent streams are remembered for one-click reopen.

Supported protocols:

• HLS (.m3u8 over HTTP/HTTPS) - the standard live format on the web.
• RTMP / RTMPS - the classic ingest format still used by many encoders.
• RTSP / RTSPS - common on IP cameras and NVRs.
• DASH (.mpd over HTTP/HTTPS).
• MPEG-TS over UDP / TCP / SRT - typical for broadcast and pro contribution feeds.

A red LIVE badge appears on the player bar while a live stream is playing - click it to jump back to the current live edge after pausing or scrubbing. While paused the badge dims to an outline.

Live streams default to Motion-Sync 3D (Settings > Depth > AI) so depth edges stay aligned with the picture even when network delivery jitters.

Open from browser

For sites that embed an HLS, DASH, or progressive-MP4 stream in a regular <video> tag, the Open in Oku3D bookmarklet lets you send the current page's stream to Oku3D with one click - grab it from the Bookmarklets page and drag it to your bookmarks bar. The browser sends the request via the oku3d:// protocol handler, including the page Referer and User-Agent so hotlink-protected streams still load. DRM-protected services (Netflix, Disney+, ...) do not work this way; use screen capture for those.

Blu-ray Discs

Open a Blu-ray ISO image or an unpacked BDMV folder like any other file - Oku3D selects the main feature automatically and plays it with its original audio and subtitle tracks. A disc with several titles - a boxset's episodes or a film's bonus features - lists them in the top bar to pick from, and plays them in sequence. Short discs, sample discs and 3D-only discs that other players reject open fine.

3D Blu-rays

3D Blu-rays play in real stereoscopic 3D: Oku3D decodes both MVC eye views natively (the frame-packed H.264 MVC format 3D Blu-rays use), so no conversion, remuxing or extra codec is needed. The format is detected as Full SBS automatically and the depth AI stays off - the disc's own stereo is shown as mastered. Decoding runs across all your CPU cores, so playback stays smooth even on slower PCs.

MKV files that keep a 3D Blu-ray's MVC video track also play in real 3D, as do raw M2TS / MTS / TS streams that carry the MVC track. Other players show only one eye's picture for these files; Oku3D detects the embedded second view and plays the pair.

A disc's alternate audio tracks - other languages or commentary - and its subtitle tracks are listed in the top bar to switch between during playback.

Limitations

• No AACS decryption. Commercial discs are AACS-encrypted, and Oku3D ships no decryption keys or AACS library. Discs and ISOs must already be unencrypted; a copy-protected disc shows a notice and does not play.
• No disc menus. Oku3D plays titles directly - picking from the top-bar title list on multi-title discs - instead of showing the disc's interactive menu system.

3D Parameters

Depth / 3D Intensity (D slider)

How strong the 3D effect is. The right value depends on your display - a VR headset needs much less than a monitor because the image fills your whole field of view.

The 1% default is tuned for glasses-free 3D displays. In a VR headset, drop it to around 0.5% - the wide field of view makes the 3D effect feel much stronger than the same value would on a monitor.

Depth Mute. The button next to the depth slider instantly flattens the 3D effect and pauses the depth AI to save GPU - useful for a quick 2D glance or to quiet the fans. Click it again to restore the previous depth strength.

Convergence (C slider)

Shifts where the "screen plane" sits in the 3D scene (±20% of viewport width):

• 0 (default) - Neutral. Content at screen depth.
• Positive - Content pops out of the screen.
• Negative - Content sits behind the screen.

Also adjustable via right-click drag. Double-right-click to reset.

Depth Gamma (Gamma Remap filter)

Applies a power curve to redistribute depth:

• < 1.0 - More foreground pop, flatter background. Good for portraits.
• 1.0 (default) - Linear, no adjustment.
• > 1.0 - More background depth. Good for landscapes.

Quick presets:

Convergence

The Convergence slider on the bottom bar shifts the 3D scene forward or back. Click the slider's value to open its popup; drag the bar inside the popup to adjust. Most users find a value that feels right for their display and want every new file to open there - that's what the Pin button is for.

Pin button

The pin icon in the convergence slider popup stores the current value as the default applied to every new file. Workflow:

1. Open a 3D image or video.
2. Adjust the convergence slider until the 3D feels comfortable on your display.
3. Click the pin icon in the slider popup.

From now on, every file you open starts at that value. If you later find a better value, adjust the slider and pin it again - the new value replaces the old one. The pinned value is stored across sessions, so you only set it up once per display.

To clear the pin, drag the slider back to 0% and pin again. Reset shortcuts (middle-click on the picture for a full reset, or right-click double-click for convergence only) only affect the current file - they do not change the pinned value.

Some 3D photo formats (LIF and MPO from compatible cameras) ship a convergence value as metadata. That value wins against the pinned default on the first open of such a file, so a camera's intended framing shows up correctly.

Save per image (optional)

If you have a photo collection with widely varying shooting distances and want each image to remember its own convergence value across sessions, turn this on under Settings > General > Per-File Settings > Save per image. Off by default - the pinned default covers most workflows without writing anything to your image files.

NTFS stream caveats. The "Hidden NTFS stream" mode uses an NTFS feature called Alternate Data Streams. They're invisible and don't clutter your folders, but they have a few quirks worth knowing about. If any of these matter to you, switch to the portable XMP sidecar mode instead:

• Last-modified timestamp updates. Each time Oku3D saves a per-image value, Windows updates the file's "Last Modified" time even though the visible image is byte-identical. Software that sorts by date (Adobe Lightroom date import, file-find by date, git diff on a checked-in folder) sees the file as recently changed.
• Lost when copying off NTFS. Any copy to FAT / exFAT (USB sticks, SD cards), SMB shares without ADS support, email attachments, or ZIP archives strips the saved values silently. The visible image is fine - just the slider value is gone.
• Cloud sync silently drops the stream. OneDrive, Dropbox and Google Drive report the file as "synced" but don't upload the stream. The trap is that nothing looks wrong - the cloud copy is missing the values without warning. If you back up via cloud, use XMP sidecar.
• Most backup tools skip ADS by default. Robocopy without /COPYALL, plain xcopy, and many cloud-backup clients (Backblaze, Arq with default settings) leave the stream behind. Your restored files may not carry the per-image values.
• Antivirus heuristics can flag ADS writes. The : in the stream path is also a classic malware-hiding pattern, so third-party AVs (Avast, Bitdefender, Kaspersky, F-Secure) occasionally treat the writes as suspicious. Windows Defender doesn't.
• Archive-master workflows. If your photo archive treats master files as never-modified originals (RAW + verifiable hashes, immutable storage), any invisible side-channel write violates that policy. Pick Off for those volumes.

The portable XMP sidecar mode avoids all of these at the cost of one visible extra file per modified image. Switching between these modes never loses existing data: both locations are checked on every file open regardless of which mode is currently selected.

Suffix style applies only to the "Filename suffix" mode and picks which naming convention is written: Kodi / Plex (_SBS, _HSBS, _TAB, _HTAB) for the widest compatibility with media-server players, or Leia LumePad 2 (_2x1, _half_2x1, _1x2, _half_1x2) to match the LeiaPlayer workflow. Because this mode rewrites file names rather than storing a slider value, it does not take part in the convergence read-back described above.

Stereo Formats

The Format dropdown in the bottom bar selects the input format:

Keep 2D videos flat. By default Oku3D converts plain 2D videos to 3D. To leave them untouched, turn off Settings > General > Open 2D videos in 3D - detected 3D and native-stereo sources still play in 3D; only plain 2D content stays flat. You can still switch an individual video to 2D → 3D from the Format dropdown.

Output Formats

The Output Format dropdown in Settings selects how the stereo image is rendered to your display. Separate settings for fullscreen and windowed mode.

Head Tracking (Settings > Display > Advanced) is on by default for Leia SR Weaving: the display follows the viewer's eyes so the 3D looks right wherever they sit. Turn it off to lock the 3D to the center of the screen instead - useful when filming or screen-recording the display head-on, where live tracking would otherwise warp the picture for the camera, and when two people watch together, since tracking can only lock onto one of them at a time.

Swap Eyes (Settings > Display) defaults to Auto, detecting per file which eye comes first - footage that stores the right eye first now displays correctly on its own. Set it to On or Off to force a fixed assignment for content it can't guess, or for cross-eyed free-viewing.

Duplicate UI for 3D duplicates the player controls into both eye views (SBS and Top-Bottom modes). Toggle with the V key.

Setting the fullscreen output to None removes the fullscreen button and keys entirely - for people who only ever watch in a VR headset and never need a fullscreen display output.

VR Headset controls: The primary controller carries the laser pointer, trigger-tap play/pause, and seek-forward - you can pick which hand is primary in Settings, so left-handed users can drive playback from the left controller. The other controller handles seek-back, recenter, and volume (push its thumbstick up or down); menu and exit sit on fixed controller buttons. To adjust an on-screen control, point at it with the primary controller and push that thumbstick up or down - depth, convergence, a settings slider, or the playback bar to seek. On VR180/360 sources the primary thumbstick pans the view instead - hold the grip button to rotate, push up or down without grip to zoom. When no controller is handy, a VR Headset setting lets the desktop mouse drive the in-headset menus instead. The headset and your desktop 3D display run at the same time, each with its own independent view, so someone can watch in VR while others watch a glasses-free display, a 3D TV, or a projector. To reach a captured PC from inside the headset, see Control Your PC From VR.

Filename Patterns

Oku3D auto-detects the stereo format from the filename. Separators (_, ., -) are interchangeable.

If no filename pattern matches, Oku3D falls back to shape-based detection:

• VR180 stereo - any 2:1 aspect at 4K width or above (videos and photos).
• Full-SBS video - standard side-by-side resolutions (3840×1080, 2560×720, 1600×600) plus anything wider than 3.5:1.
• 2D video - common broadcast and cinema resolutions (1920×1080, 4K UHD, DCI Scope / Flat, anamorphic 1472×1080, legacy SD).
• 3D photos - non-standard photo aspect ratios (anything outside 1:1, 4:3, 3:2, 16:9 and their portrait variants) are treated as side-by-side stereo. Useful for 3D camera output without metadata.

Files that don't match any of these signals fall back to 2D → 3D AI conversion, or to the format you saved with Ctrl+D (see Format Memory below).

Two-file stereo pairs

Classic stereo photography stores the two eyes as separate files. When two images sit in the same folder and differ only by a left/right marker at the end of the name - photo_L.jpg / photo_R.jpg, or shot-left.png / shot-right.png - opening or dropping either one loads them together as a single 3D image. The marker (L / R or left / right, any case) has to be set off by a _, -, . or space, and the file for the other eye must exist next to it. Works for JPG, PNG, WebP, TIFF, BMP and TGA pairs.

Format Memory

When the player can't identify a file's stereo format from its container metadata, filename, or shape, it normally falls back to 2D → 3D AI conversion. For workflows where the same format repeats - browsing a folder of 3D camera photos that all need the same format, or a collection of untagged 3D MKVs - the fallback can be replaced with a format of your choice.

Saving a default format

1. Open a file the player misidentifies (or open any file and switch the format manually).
2. Pick the right format and FOV from the controls in the bottom bar.
3. Press Ctrl + D. A toast confirms "Default format saved: Full SBS / 180°" (or whatever you picked).
4. Every subsequent file the player can't identify automatically inherits that format + FOV.

What the saved default does not override

The saved default only kicks in for files where the player is uncertain. Files the player can identify confidently keep their detected format regardless of what you saved:

• Container metadata says SBS / Top-Bottom (Matroska StereoMode, MP4 spatial-media tags).
• Filename carries a format tag (_sbs, _tab, .VR180., etc.).
• Frame shape matches a VR180 stereo signature (2:1 aspect at 4K width+).
• Frame shape matches a known Full-SBS layout (3840×1080, 2560×720, ...).
• A standard cinema or broadcast resolution (so e.g. Barry Lyndon at 1920×808 stays 2D even if your default is SBS).

Changing the default

Just press Ctrl + D again with a different format selected. To turn the memory off, switch the controls to 2D → 3D and press Ctrl + D - that's the same as a fresh install.

Depth Settings

Depth settings are organized into two tabs:

• Depth Map - visualization mode, gamma remap, edge dilation, and diagnostic overlays; these apply to every depth source.
• AI - everything specific to the neural depth estimator: depth model and inference resolution (separately for video and for stills), Max depth FPS, the Scene Cut Detector, Motion-Sync 3D timing, and the Temporal Filter that reduces depth flicker.

Per-image convergence storage (Save per image) now lives under Settings > General > Per-File Settings.

Visualization Mode

Found in Settings > Depth > Depth Map > Visualization Mode. The default is the regular 3D output. Depth Preview 3D shows the AI-detected depth as a 3D surface that slowly turns on its own - drag it to orbit to any angle and it holds there, handy for spotting depth-detection mistakes before switching to stereo output.

Diagnostic Overlays

Overlays visualize what the depth AI sees - useful for spotting where conversion goes wrong. Press D to cycle opacity (0% / 50% / 100%), Shift+D to switch overlay.

• Processed Depthmap / Raw Depthmap - depth as grayscale, for A/B comparison of post-processed vs. model-native depth
• Depth Heatmap - depth as color
• Depth Edges - detected object boundaries
• Flicker Visualizer - frame-to-frame depth jitter
• Optical Flow - per-pixel motion between frames
• Scene Cut Detection - flashes when a scene change is detected
• Stereo Stretch - red areas where 2D-to-3D stretches pixels around object edges

Model & Inference Resolution

Oku3D ships with 13 AI depth models, grouped in the dropdown by family - Depth Anything V1, V2 and V3, Lotus, and MiDaS. The default Depth Anything V2 Small (47 MB) is a solid speed/quality balance for most GPUs. Pick Depth Anything V3 Mono Large for the finest detail, Lotus-D for photos with thin structures like wires and branches, or a smaller Q4F16 / MiDaS variant for older hardware.

The model comparison page shows every model on the same scenes, with measured speed and memory use for each inference resolution - the quickest way to decide what to switch to.

Inference Resolution controls how much detail the model sees - higher = sharper depth, lower FPS. Each model offers its own list of resolutions in pixels; models with a single baked-in size (the MiDaS builds) show it read-only.

Video and photos are configured separately. Settings > Depth > AI has one Depth Estimation (Video) block and one Depth Estimation (Stills) block, each with its own model and resolution. The stills model starts at Same as video and its resolution at Maximum, so a photo already gets the sharpest depth the selected model can produce. Point stills at a slow, highly detailed model and video keeps running on a fast one - if your graphics card has the memory, both stay loaded so switching between a video and a photo doesn't pause.

If playback stutters, lower the video Inference Resolution first - that usually buys back enough FPS without giving up much detail. Only switch to a smaller model if that's not enough.

Each model downloads once on first selection and is then cached locally. The transfer runs in the background with a progress bar while playback continues - you can pause it, tuck it away to a button in the top bar, or close Oku3D and have it pick up where it left off. Models come from Oku3D's own servers, with Hugging Face as an automatic fallback.

Image Filters

Found in Settings > Image. The Sharpen filter has its own on/off toggle; the Image Filter adjustments apply as soon as you move them off their neutral defaults.

Depth Filters

Edge Dilation and the Scene Cut Detector have their own on/off toggles; Gamma Remap is always active and shaped by its preset.

Note: When a photo supplies its own depth - an iPhone photo shot with depth, a LIF or MPO file with an embedded depth map, or a separate depth-map image saved next to it (name it photo.depth.png beside photo.jpg) - that stored depth is used as-is and no AI inference runs. It stays a choice, not a lock: the Format dropdown offers 3D (the stored map, the default) and 2D → 3D (Oku3D's own estimate) side by side, so you can compare the two, and the pick carries over to the next photo in the session. A sidecar depth map lets you feed a higher-quality precomputed map from an offline depth tool into Oku3D's live output; brighter means nearer, and PNG, TIFF, JPEG or AVIF all work. Any convergence and depth-intensity values in the file metadata are applied too. Creative filters like Gamma Remap still apply.

Temporal Filter

Smooths out depth flicker between frames. Without it, flat surfaces (skies, walls) shimmer because the AI re-estimates depth on every frame from scratch. Found in Settings > Depth > AI > Temporal Filter.

Temporal Mode picks how the smoothing works:

Temporal Smoothing sets how strongly previous frames blend in. Raise it if depth still flickers; lower it if motion feels sluggish.

Wavelet Coring is an extra noise filter on top. Leave it on at the default strength; raise the slider only if you still see depth grain on flat surfaces.

The remaining controls (Flow Weight, Flow Median Filter, Flow Search Radius) fine-tune the motion tracking and only matter in Block-Matching mode. Defaults work for almost everything - touch them only if you're chasing a specific artifact.

Max depth FPS

Found in Settings > Depth > AI > Max depth FPS. Caps how many times per second the depth AI runs. The default Unlimited lets Oku3D run depth as often as your hardware allows - automatically backing off on a slower GPU. Pick a fixed rate (60 / 30 / 20 / 15 / 10 FPS) to hold the AI's GPU load down when your fan is loud or another GPU-heavy app is running.

Because the cap is a target frame rate rather than "every Nth frame", the depth-update rate stays consistent across videos shot at different frame rates - 24, 30, and 60 fps content all get the same depth cadence. The optical-flow stabilizer fills in the frames between depth updates, so a moderate cap such as 30 FPS is usually visually indistinguishable from Unlimited on typical content; lower caps trade more visible softness on fast motion for steadily lower GPU draw.

Motion-Sync 3D

Found in Settings > Depth > AI > Motion-Sync 3D. Slightly delays audio and picture together so the depth AI has lead time to compute depth for the upcoming frame before it's displayed. On fast pans this aligns depth edges with object edges instead of letting depth lag a frame or two behind color. A/V sync is preserved because audio and video shift by the same amount.

Four toggles pick which sources the delay applies to:

• Apply to video files - on by default. Local video and image playback gains the alignment benefit without any downside.
• Apply to streams - on by default. Network jitter would otherwise let depth lag behind color on the first frames after a stall.
• Apply to capture device - off by default. Turning this on adds the delay to your live camera or capture-card feed, which reads as mirror lag and may feel uncomfortable.
• Apply to screen capture - off by default. Adds the delay to captured windows or desktops, which makes the captured app feel sluggish if you're interacting with it.

Languages

Oku3D's interface is available in nine languages: English, German, French, Spanish, Portuguese, Simplified Chinese, Traditional Chinese, Korean, and Japanese. On first launch the app auto-detects your system language; you can change it any time under Settings > General.

The same screen also lets you set a preferred audio track language and a preferred subtitle language, so the matching tracks are selected automatically whenever you open a video that carries them.

Diagnostics & Bug Reports

Performance Snapshot

Press Ctrl + P to copy a diagnostic snapshot to the clipboard. It captures:

• App version, codec name and decoder type (FFmpeg primary / Media Foundation backup, software / hardware path)
• GPU name and backend, plus which adapter the depth AI is pinned to
• Your Windows version, processor, installed memory, and graphics driver
• Every connected screen, so display-specific problems are traceable
• Active depth model and its inference resolution
• Live playback FPS and worst-case per-stage timings
• The full recent log - so the snapshot is complete without launching from a terminal

Paste it into an email to jens@oku3d.com when reporting a bug. The snapshot includes filenames from your recent activity - review it before sending if your library has sensitive names.

Diagnostic Log

If the app crashes or freezes before you can use Ctrl+P, launch it from a terminal to capture the most detailed diagnostic log:

powershell -NoExit -Command "$env:RUST_LOG='warn,oku3d=trace'; & $env:LOCALAPPDATA\Programs\Oku3D\oku3d.exe"

Close any running Oku3D instance first (end oku3d.exe in Task Manager if the window is unresponsive), then press Windows + R and paste the command above. A PowerShell window opens alongside Oku3D and prints the most verbose diagnostic output.