Help

Keyboard Shortcuts

Opening a folder: the folder button beside Open Files on the start screen, or Open Folder in the source menu. On Windows the folder dialog can take the subfolders along.

On a Mac Cmd takes the place of Ctrl - see the Mac page.

In a splat scene W A S D, E, Q, the arrow keys and R steer the camera instead - see Gaussian Splats.

The focus frame appears once you press Tab, F6 or an arrow key on a panel, and a mouse click hides it again. With nothing selected, every key keeps the shortcut listed above. In the photo editor and the shot controls of a splat scene, Tab keeps hiding the panel and F6 moves into it.

Delete has to be held until the ring on the card closes; letting go early keeps the file. On Windows, a file on a drive without a Recycle Bin, such as a network share, is then deleted outright. On Linux, a file that cannot go to the Trash stays where it is.

Mouse & Pointer Interactions

Middle-click leaves a turned or leveled recording as it is - Ctrl+R or the reset in the rotation popup undoes that.

In the Depth Preview 3D visualization, left drag orbits the depth surface instead of panning the picture.

A splat scene uses the mouse differently - see Gaussian Splats.

Lost the pointer? Hold L and turn the mouse wheel to make it bigger; it stays that size until you tap L.

Gamepad

Xbox, PlayStation, Switch Pro and the usual third-party pads work without setup. The pad only steers Oku3D while its window is in front, so a game played with the same pad keeps it - even with Oku3D on top as a click-through overlay.

Buttons are named by where they sit, not by what is printed on them: the lower button is A on an Xbox pad, Cross on a PlayStation pad and B on a Nintendo pad. They all do the same thing here.

A splat scene has its own layout - see Gaussian Splats.

While a panel, a dialog or the start screen is open, the D-pad moves through it, the lower button presses what is selected, and the right button goes back. A panel in its own window comes back into the player window when you use the pad there.

Depth & Convergence

The two 3D sliders on the bottom bar. A middle-click on the picture resets both for the open file, along with zoom and pan.

Depth / 3D Intensity (D slider)

How strong the 3D effect is, from 0 to 2% of the picture width. The right value depends on your display:

The 1% default suits glasses-free 3D displays. In a VR headset start at about 0.5% - the wide field of view makes the same value feel much stronger.

• Depth Mute - the button next to the slider flattens the picture and pauses the depth AI, for a quick 2D look or quieter fans. Click it again to get the 3D back.
• Eye Distance - in a splat scene, a CT / MRI volume and the music visualizer the slider sets the distance between the two virtual eyes instead, from 0 to 4 times a real pair of eyes.
• Comfort warning - the depth, convergence and subtitle depth sliders turn amber, then red, as the 3D nears the uncomfortable range. In a VR headset the limit follows the size and distance of the virtual screen.

Convergence (C slider)

Moves the whole scene forward or back, up to 20% of the picture width. Right-drag on the picture does the same; a right double-click resets it.

• 0 (default) - content sits at screen depth.
• Positive - content comes out of the screen.
• Negative - content sits behind the screen.

One value for every file: click the slider's value to open its popup, set the convergence, and click the pin. Every file opens at that value from then on, across restarts. To clear it, set 0% and pin again. Resetting on the picture changes only the open file, never the pin.

LIF and MPO photos from compatible cameras carry their own convergence, which wins over the pin the first time the file is opened. For a separate value per file, turn on Save per file.

Video Export

Keep the 3D: Ctrl+S, or the disk button in the control bar, writes the video you are watching to an MP4 or MKV file in 3D - for a 3D TV, a VR headset, a phone, or any player without Oku3D. Every frame gets its own depth; none is skipped.

• See it first: the dialog shows the picture as the file will look, and Watch in the player plays it that way before you start.
• While it runs: the export plays alongside as it is written - or Hide preview to keep a film you have not seen unspoiled. Its progress shows in the control bar, and on Windows on the taskbar button. Other files open once it is done.
• Stopping early keeps what was written so far as a file that plays.
• Edit Frame as Photo opens the frame on screen in the photo editor instead.

The export uses the video encoder of your graphics hardware: on Windows H.264 always works, on Linux it needs an NVIDIA card or a working VA-API driver, and the Mac has one built in. Where none is found, the dialog says so. An anaglyph file is never HDR. VLC on Linux and macOS plays side-by-side and top-bottom files as 2D; on Linux, setting its video output to X11 shows both views.

Screen Capture

Watch another application's window or the whole desktop in 3D, live - games, browser videos, anything Oku3D cannot open as a file. Start it with Capture Screen on the start screen.

Click-Through Overlay

Ctrl + Shift + F11 keeps Oku3D on top but lets clicks and typing pass through to the application underneath - to play a game while watching it in 3D on one monitor. The same keys, Oku3D's taskbar icon or Alt + Tab switch it off.

The key combination can be changed under Settings > General. Not on Linux.

Choosing the Capture Source

A picker shows a live preview of every screen and window. Follow the active window switches the capture to whichever window you bring to the front. On Linux your desktop's own picker appears instead - see where the two builds differ.

• Normal applications (browsers, video players): capture the whole desktop or maximize the window - otherwise the mouse pointer does not line up with the picture in Oku3D.
• Games that draw their own pointer: capturing a single window works fine.

Crop to Trim Borders

C and a dragged box crop the picture to the part you keep - for black borders that push the two eye views out of line, on captures and on any video or photo. Shift + C finds and crops the black bars by itself; press it again for the full frame.

A black band between the two eye views is taken out with Image Gap in the view menu instead, without cropping the picture.

Control Your PC From VR

In a VR headset, aim a controller at a captured screen to move the desktop mouse: the trigger clicks, holding it drags, grip plus trigger right-clicks, and either thumbstick scrolls. A controller button hides Oku3D's own controls when they cover what you want to reach.

Not on Linux - watching works there, clicking back does not.

Live Streams

Open Stream on the start screen plays network streams in 3D: paste a URL, drop an .m3u / .m3u8 file on the window, or pass a URL on the command line. The ten most recent streams are remembered, and an IPTV channel list opens as a playlist (Ctrl + L).

Protocols: HLS, DASH, RTMP / RTMPS, RTSP / RTSPS (IP cameras), and MPEG-TS over UDP, TCP or SRT.

The red LIVE badge on the player bar jumps back to the live edge after pausing or scrubbing.

Open from browser

The Open in Oku3D bookmarklet sends the video on the current web page to Oku3D with one click - drag it to your bookmarks bar from the Bookmarklets page. It works for HLS, DASH and MP4 videos in a regular video element, hotlink-protected ones included. DRM-protected services such as Netflix or Disney+ do not work.

Archives & Playlists

Open a ZIP, CBZ, TAR, TGZ or GZ file like any other - with Ctrl+O or by dropping it on the window - and the photos, videos, music and 3D scenes inside play as a playlist, without unpacking anything to disk. Ctrl+L shows that playlist in a side panel.

• Order: by name, the way a folder sorts - page2 before page10, subfolders included. Order of New Playlists under Settings > General picks another order.
• Companions: a subtitle file or a second eye beside a video inside the archive is found just as it would be in a folder.
• Seeking: works in compressed videos too, with a moment's pause on a jump. A large TGZ takes longer to open, since it has to be read once from start to end to list it.

What does not open: 7z and RAR archives, archives split into several parts, password-protected ZIPs, ZIPs packed with anything other than the standard method, and archives inside archives. A Blu-ray ISO or disc folder has to be extracted first. Settings saved per file, such as convergence, are not remembered for files inside an archive, and Delete does not remove them.

The playlist

The list button beside the source button at the top left, or Ctrl+L, opens the playlist beside the picture.

• Edit it like a folder: click, Ctrl-click or Shift-click entries to select them, drag them into place (or move them with Alt+↑ ↓), drop files where they should go, and remove the selection with the toolbar.
• Sort or shuffle from its toolbar - by name, folder path, size, date modified or the date a photo or film was taken.
• Save it as a playlist file to open again later or in another player.
• Its own window: the playlist can move into a window of its own, for example onto a second screen.
• At the end: At the End under Settings > General starts the list over, stops, or stops after videos while music and pictures keep repeating.

Playlist files

M3U and M3U8, PLS, XSPF, WPL, ASX, MPC-HC and PotPlayer lists open and play their entries in their own order, under the titles they give them - files (relative to the list's folder) and stream addresses alike. A missing file is skipped. A CUE sheet lists an album's tracks.

Blu-ray Discs

Open a Blu-ray ISO image or an unpacked BDMV folder like any other file - an ISO needs no mounting, and an unencrypted disc in the drive opens with Open Folder on the drive. Oku3D picks the main feature; a disc with several titles - a boxset's episodes or bonus features - lists them in the top bar, together with its audio and subtitle tracks.

3D Blu-rays

3D Blu-rays play in real 3D: both eye views are decoded, with no conversion or extra codec. The format menu shows MVC, and the depth AI stays off.

The same goes for MKV and .mk3d files that keep a 3D Blu-ray's MVC video track, M2TS / MTS / TS streams that carry it, and the MP4 of a 3D camcorder.

A single .ssif file - where a 3D Blu-ray keeps its second eye - plays in 3D as well. If its depth looks inside-out, flip Eye Order in the view menu.

The 3D Blu-ray guide covers which 3D screen gets what, and the sound.

Subtitles keep the depth the disc gives them, in a VR headset too. If a disc puts them on the wrong plane, pick another with Depth plane under Settings > Subtitles. A copy that lost that depth takes it from an OFS 3D-Plane file beside the video or attached to the MKV.

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.

Gaussian Splats

A Gaussian splat scene is a place - a room, a statue, a street corner - stored as millions of tiny colored specks. Instead of watching it, you move through it, and the depth holds up from wherever you stand. Most are scans made from photos or video; Oku3D can also build one from a single photo. Open it like any other file.

Formats

A scene too large for your graphics card still opens - at a coarser level of detail where the file offers one, otherwise with its least visible specks left out.

Moving through a scene

A button in the bottom bar switches between flying through the scene and circling whatever is in front of you.

Game controller

A gamepad steers the scene too - buttons are named by where they sit, as in the Gamepad section.

• Left stick moves, right stick looks.
• Shoulder buttons rise and sink.
• Triggers turn the horizon, as slowly or as quickly as you pull them.
• The left button switches between flying and circling, the lower button goes back to the opening framing.
• Press the left stick in to hurry, the right stick in to put the horizon back level.

In a headset and on a 3D display

In VR a scene is walked the way a gamepad walks it: one stick moves, the other looks, and the grips rise and sink.

On a glasses-free 3D display, leaning shifts your viewpoint inside the scene, so you can look around something in the foreground. A button in the bottom bar holds the view still; the 3D keeps tracking your eyes either way.

Pop-out, the slider next to it in the bottom bar, sets how far the nearest parts come towards you. As with the depth slider, the comfortable value depends on your display.

A scene from a photo

Any photo can become a scene you step into: the box button at the bottom left - Turn photo into Gaussian splatting scene - rebuilds it in 3D, so what stood behind the foreground comes into view as you move. The same button takes you back to the photo.

• Which photos: any flat photo, and side-by-side or top-bottom stereo photos, which are built from their left eye. Not videos, and not 360° or fisheye pictures. The depth takes its scale from the focal length the camera recorded.
• The model: Apple SHARP, about 1.2 GB, downloaded once. Apple publishes it for non-commercial research use only - Oku3D shows the license before the download, and downloading accepts it.
• On your machine: the scene is built on your own graphics card, like the depth AI. The photo is not uploaded anywhere.
• Graphics memory: a scene needs about 7 GB. On a card with less free, a notice says how much it needs before it starts, and Build anyway goes ahead - it can then be very slow or stop with an error.
• Time: a few seconds on a current graphics card, longer on the very first run.
• Keeping it: Export..., in the scene's shot controls below, saves the scene itself too: its file format list offers PLY, which keeps the photo's framing, and the smaller SPLAT for other splat viewers, under Gaussian Splatting Scene.

Taking a photo of a scene

The sliders button at the bottom left, or Tab, opens the scene's shot controls beside the picture. They photograph any splat scene the way a real camera would.

Export... in the shot controls saves the view as a picture; Edit This View as a Photo opens it in the photo editor instead.

• Flat or all around: a flat photo, or a stereo VR180 or 360° panorama with the depth correct in every direction you turn.
• Layout: side-by-side or top-bottom, anaglyph, freeview (parallel or cross-eyed, for a flat photo), a single eye, separate left and right files, or, for a flat photo, RGB-D - color plus a depth map measured from the scene itself rather than estimated.
• File type: PNG (8 or 16 bit), JPEG, JPS, PNS or MPO.
• Size: up to eight times the on-screen size, rendered anew at that size for real detail.

Focus, depth of field, exposure and color temperature stay with the scene they were set on, and survive a restart when Save per file is switched on.

Photos

Very large photos

Panoramas and scans up to gigapixel size open quickly. Zoom in as far as you like and you see the photo's real detail - in 2D, in 3D, in a VR headset and in the photo editor.

That temporary file needs free disk space about the size of the uncompressed photo, and it is deleted when Oku3D closes. A photo can be at most 200,000 pixels on a side.

Motion photos

Google and Samsung motion photos - a JPEG with a short clip inside - play their moment once when opened, with sound, then rest on the photo. Space plays it again.

Photo Editor

Press E or the pencil button at the bottom left to edit the photo on screen - a flat photo, a flat photo shown in 3D, or a stereo pair (side-by-side, top-bottom, MPO, JPS, or two files named _L / _R). Camera RAW photos open in it like any other photo, and a 180° or 360° photo opens flat while you edit it. Animated pictures cannot be edited; for a frame of a video, press Ctrl+S during the video and pick Edit Frame as Photo. E again, the X in the tools, or Esc closes it; Esc first leaves the tool you are in. Working on stereo pairs? The stereo photo guide takes you through aligning, checking and saving one.

Keys in the editor

Editing one photo after another: PgUp / PgDn or a click in the playlist moves on while the editor stays open. Videos and other files the editor cannot open are passed over and dimmed in the playlist, and unsaved changes are asked about first. The control bar stays for the playlist, fullscreen and the 3D format; other player keys rest while the editor is open.

Where your edits go

Edits show only inside the editor - outside it the player shows the photo as the file is. Closing the editor or moving to another photo with unsaved changes asks what to do:

• Save Now… - export a finished copy (see below).
• Discard Changes - take back what changed since the editor opened or the photo was last saved.
• Keep for Later - store the edits beside the photo, so they are there the next time you edit it. They go into a small .xmp file next to the photo, or into the file's hidden metadata when Save per file is set to a hidden mode. The photo itself never changes.

Revert to Original, beside Undo, removes every edit of the photo at once. Undo history lasts for the session.

Exporting

Export... at the bottom of the panel, or Ctrl+S, saves a finished copy at full size, even of a gigapixel photo.

• Arrangement: side-by-side or top-bottom (full or half), anaglyph, parallel or cross-eyed freeview, a single eye, or separate left and right files. A flat photo shown in 3D can also be saved as color plus depth (RGB-D), as its depth map, or as a plain 2D photo - and any 3D arrangement turns it into a real stereo pair.
• File type: PNG (8 or 16 bit), JPEG, JPEG HDR (Ultra HDR) or PNG HDR for photos with highlights brighter than normal white, or the 3D photo formats JPS, PNS, MPO and LIF. The editor's HDR switch can take an ordinary photo beyond white too.
• Size: full, half, a quarter, or a width of your choice.

The suggested file name marks the arrangement, such as _2x1 or _anaglyph. A 2D export in the photo's own format suggests the original name - change it, or the save dialog asks before replacing the original.

CT & MRI Scans

CT and MRI scans open as a 3D volume you can turn, cut open and step into. Open the disc or folder a clinic handed you (Ctrl+F, or drop it on the window) - each series becomes one entry - or open a NIfTI (.nii, .nii.gz), NRRD (.nrrd, .nhdr) or MetaImage (.mha, .mhd) file.

A DICOM series becomes a volume when it has at least 10 slices that form one block. Shorter, color or irregular series play as a sequence of flat slices instead. A scan series over time plays with Space.

Seeing it

The cube button in the bottom bar switches between the 3D volume and the flat slices. The sliders button, or Tab, opens the display controls:

In the slices view, pick Axial, Coronal, Sagittal or the current viewing angle, and a single slice or a thick slab. The mouse wheel or . / , step through the slices, and a click sets a crosshair the 3D view shows too.

Moving around

Drag to circle the volume, scroll to move closer, and right-drag to move the view sideways or up and down; a right double-click goes back to the opening view. To step inside, switch the orbit button to flying and move with W A S D, E / Q and the arrow keys. In a VR headset, In the Room (VR) stands the volume in front of you: a grip carries and turns it, both grips scale it, and the other trigger slices through it.

Scans up to 1 GB of image data open as a volume. Oku3D is a viewer for looking at your own scans, not a tool for medical diagnosis.

Stereo Formats

The Format dropdown at the bottom left says what the file is - not how it is shown, which is the output format in Settings:

Files that already carry two camera views play in full-resolution 3D on their own: MV-HEVC spatial videos from iPhones and recent Galaxy phones, MVC from 3D Blu-rays and 3D camcorders, and files that keep each eye as its own video track. The dropdown then names them MVC, MV-HEVC or Two Tracks. Spatial photos and Galaxy 3D photos (HEIC) open in 3D as well. Which phones and cameras shoot 3D lists what writes these files.

View menu

The View button at the bottom left holds corrections for the file you are watching. They apply to that file only - the next one starts clean.

360°, VR180, and fisheye

Drag the picture to look around. Under a sphere projection the Format dropdown offers only SBS and TB - half and full width mean the same thing there.

Turning the recording. The rotate control in the bottom bar behaves differently depending on what is playing:

R and Shift+R do the same from the keyboard; on a sphere they turn whatever you are looking at. Ctrl+R resets, on a sphere the horizon correction below included.

Straighten the horizon: hold Shift and sweep the mouse in a circle around the middle of the picture, like turning a wheel - start away from the center. Correct it once, look about 90° further round and correct it again; it then stays level in every direction. Ctrl+R or the reset in the rotation popup clears it, middle-click does not.

360° photos and videos from Insta360 cameras open level already, however the camera was held. A recording the camera split into two files plays as one, and a clip whose second lens file is missing plays as the half sphere the remaining one covers.

Filename Patterns

Oku3D auto-detects the stereo format from the filename. Separators (_, ., -) are interchangeable. A tag in a folder name counts for every file inside it, so a folder called Holiday_SBS needs no tag on each photo - a file that carries its own tag still wins.

Fisheye tags follow the spellings this material is commonly labeled with, and Oku3D measures the actual lens circles in the picture, so the projection lands right even when the tag is only approximate. Anything the name does not settle can be picked by hand from Projection in the view menu.

Tags in the file itself come before the name. Besides a container's own 3D marking, that includes the frame-packing flag that AVCHD 3D camcorders and side-by-side broadcasts write into their H.264 / HEVC video stream - such a recording opens in 3D whatever it is called.

If no filename pattern matches, Oku3D looks at the picture:

• Two views in one frame - Oku3D compares the two halves of a photo, or of a video's first seconds. When they show the same scene from two slightly different positions, the file opens in 3D, side-by-side or top-bottom - also for ordinary shapes like a 16:9 photo or a plain 1080p video.
• 360° stereo photos - a top-bottom photo whose two eyes are each a 2:1 panorama at least 3840 pixels wide is wrapped around you instead of shown flat.
• Telltale frame shapes - a 2:1 frame at 4K width or above is taken as VR180 stereo, and a frame far wider than any film (3840×1080, 2560×720, anything past 3.5:1) as side-by-side.

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).

A video that starts on black, a fade or a title card is checked again over its first seconds of playback, and switches to 3D once clear frames agree. One that stays dark or featureless that long keeps the verdict from its name and frame shape - pick the format by hand for that one.

Two-file stereo pairs

Two images in the same folder that 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 - open together as one 3D image. The marker (L / R or left / right, any case) has to be set off by _, -, . or a space. Works for JPG, PNG, WebP, TIFF, BMP and TGA.

Format Memory

For the files open right now: pick the format, then Apply to All Files at the end of the format menu. Every file in the playlist takes that format until you open a new playlist or close Oku3D; a format you pick for one file afterwards stays that file's exception.

A file whose format Oku3D cannot detect gets 2D → 3D. If you have many such files in the same format - untagged 3D MKVs, a folder of 3D camera photos - make that format the default instead:

1. Open such a file and pick the right format from the bottom bar - and the projection from the view menu, if needed.
2. Press Ctrl + D. A message confirms the saved format, and every file Oku3D cannot identify opens that way from now on.

Files Oku3D does recognize keep their detected format - by a 3D tag in the file or its name, a detected stereo pair, a telltale frame shape, or a standard film resolution.

To change the default, press Ctrl + D again with another format; to turn it off, press it with 2D → 3D selected.

General Settings

F12 opens Settings. Each of its tabs has its own section here.

Searching: the field at the top of Settings, or Ctrl+F, finds any setting - typos and English terms included, whatever the interface language. The button beside it lists every setting you changed, ready to edit or reset. Settings can also move into a window of its own.

Save per file

Remembers what you adjusted on one file - convergence, the view menu corrections such as eye order, image gap or subtitle offset, and a splat scene's shot settings - so it opens that way next time. Off by default. Blu-ray discs, streams and files inside archives are left out.

Caveats of the hidden mode: each save updates the file's "Last Modified" time although the picture is unchanged; most backup tools skip the hidden part unless told otherwise (Robocopy without /COPYALL, plain xcopy, many cloud backups); and some third-party antivirus tools flag the writes as suspicious. Avoid it for an archive of originals that must stay untouched. Switching modes loses nothing - both places are read on every open.

Display Settings

Four sub-tabs: General for the output format, Background for what surrounds the picture, VR Headset, and Advanced for the graphics card and glasses-free 3D displays.

Output Format

How the 3D picture reaches your screen - set separately under Fullscreen and Windowed, since the two often go to different screens.

• Fullscreen Monitor - the screen fullscreen opens on, so a projector or second display needs no window dragged over first. Does not apply to Leia SR Weaving, which finds its own panel.
• Display UI in 3D - puts the player controls into both eye views in SBS and Top-Bottom. On by default in fullscreen, off in the window; V toggles it.
• Display Swaps the Eyes - for glasses or panels that deliver left and right the wrong way round, for everything you play. A single mislabeled recording is fixed with Eye Order in the view menu or F7 instead.
• Picture beside side panels - off by default. Shrinks the picture so the playlist, the performance readout and the editor tools sit beside it instead of over it. A panel widens by dragging its edge, and the panels and the control bar can move into windows of their own - the control bar then works as a remote.
• None as the fullscreen output removes the fullscreen button and keys - for people who only ever watch in a VR headset.

Frame Packing setup

The video's frame rate picks the signal: a 24 fps film goes out as 1080p at 24 Hz, 50 or 60 fps content as 720p at 50 or 60 Hz.

Which displays follow. A display that recognizes 3D from that resolution alone switches by itself. A TV that also waits for a separate HDMI 3D marking shows the stacked picture as it is, unless the driver's own 3D modes below reach it. If a display stays flat with HDR switched on in Windows, try it with HDR off.

• Windows, driver with 3D modes: where the graphics driver offers 3D modes of its own - NVIDIA's 3DTV Play does - Oku3D uses those first and the driver builds the 3D signal, which can also reach a TV that waits for the HDMI 3D marking.
• Windows with an NVIDIA card: nothing to set up. Oku3D creates the 3D resolution through the driver when you go fullscreen and removes it when you leave.
• Windows with AMD or Intel graphics: add the 3D resolution to that display once, with Custom Resolution Utility (CRU) or your driver's custom-resolution panel: 1920x2205 at 24 Hz for films, 1280x1470 at 60 or 50 Hz for everything else. Without it Oku3D shows a notice that the display takes no 3D signal.
• Linux: depends on the desktop session, see where the two builds differ.

HDR

Nothing to set up in Oku3D. With HDR switched on in Windows, an HDR10 or HLG film, or an HDR photo, reaches the brightness it was made for, measured against what the screen the window sits on can produce. Changing Windows HDR or its SDR content brightness slider reaches the picture while it plays. Leia SR Weaving keeps the bright highlights when Windows HDR is on for the 3D display itself; the VR headset stays at ordinary brightness, since it accepts no HDR signal. Linux has no HDR output.

Background

VR Headset

Where subtitles go in the headset is set under Subtitles.

Controllers in VR:

• Primary controller - laser pointer; a trigger tap plays or pauses, and seeks forward. Point at a slider and push the thumbstick up or down to change it - depth, convergence, a setting, or the timeline to seek.
• Other controller - seeks back, recenters, and sets the volume with its thumbstick.
• 360°, VR180 and fisheye - the primary thumbstick turns the view while you hold the grip, and zooms without it. Or point at the picture, hold the trigger and swing your hand: the view turns with it.
• Panels - the control bar and the side panels stand beside the cinema screen, so the picture stays free for clicks. Point at a panel and hold the grip to move it.
• Lying down - recenter while lying on your side or back, and the screen turns to your eyes so the 3D still lines up.
• A captured PC screen can be clicked from the headset - see Control Your PC From VR.

Advanced

Depth Settings

Two sub-tabs: AI controls the depth AI that turns 2D into 3D, Advanced shapes the depth whatever it comes from and shows what the AI sees.

AI: model and resolution

Oku3D ships with 14 AI depth models, grouped by family - Depth Anything V1, V2 and V3, Lotus, ZipDepth and MiDaS. The default Depth Anything V2 Small (47 MB) balances speed and quality on most graphics cards. Pick Depth Anything V3 Mono Large for the finest detail, Lotus-D for photos with thin structures like wires and branches, or ZipDepth or a smaller Q4F16 variant for older hardware. The model comparison page shows every model on the same scenes, with measured speed and memory use.

• Inference Resolution - how much detail the model sees: higher is sharper but slower. Entries your graphics card lacks the memory for are grayed out.
• Video and Stills - Depth Estimation (Video) and Depth Estimation (Stills) each have their own model and resolution. Stills start at Same as video and Maximum, so photos already get the sharpest depth. A slow, detailed model for photos and a fast one for video both stay loaded if the memory allows.
• Tiled Depth (Stills, off by default) - reads a photo's depth in overlapping tiles for crisper 3D edges. The detail fills in as it comes; it can take several times as long.
• Playback stutters? Lower the video Inference Resolution first; switch to a smaller model only if that is not enough. P shows the performance overlay.

Each model downloads once when first picked, in the background while playback continues; an interrupted download resumes later. Open model folder shows where models are kept, for example to delete one and free the disk space. The Mac offers its own list - see the Mac page.

AI: other settings

Cuts need no setting: a new shot gets its own depth at once, and flashes or lightning do not reset it.

Advanced

• Processed / Raw Depthmap - the depth in grayscale, after and before Oku3D's processing
• Depth Heatmap - the depth in color
• Depth Edges - detected object boundaries
• Flicker Visualizer - depth jitter from frame to frame
• Scene Cut Detection - flashes on a detected scene change
• Stereo Stretch - red where 2D-to-3D stretches pixels around object edges
• Black Bar Detection - the black bars the 3D conversion leaves out, so a wrong crop shows at a glance

A file that brings its own depth - an iPhone photo shot with depth, a LIF or MPO with a depth map, an RGB-D file, or a photo.depth.png beside photo.jpg (brighter is nearer) - uses it instead of the AI, with the same cleanup the AI's depth gets; the Format dropdown switches between 3D (the stored depth) and 2D → 3D to compare. Depth Gamma still applies.

Image Settings

Audio Settings

Audio Lag and Bitstream passthrough belong to the device named in the heading above them. Your speaker, receiver and headphones each keep their own value, applied as soon as the sound moves there. Other Output Devices at the bottom lists the ones you changed; the trash icon removes one.

Bitstream passthrough

• Not needed for surround sound. A 5.1 or 7.1 track plays in surround without it, as long as your system is set up for more than two speakers.
• Needed for Dolby Atmos and DTS:X. Both are lost once the track is decoded - only the untouched bitstream carries them to the receiver.
• While it is active, every other application on that audio device goes silent, the receiver sets the volume (M still mutes), and only normal speed plays sound. Windows must allow applications to take exclusive control of the device, in its sound settings.
• Nothing breaks without it: a track or device that cannot take the bitstream plays normally, and a short message names the reason.

Not on Linux yet - one tester with a receiver would settle it.

Subtitle Settings

S cycles the subtitle tracks. Embedded tracks and separate files both work - .srt, .ass, .ssa, .vtt, .sub / .idx, .sup, .smi, .ttml / .dfxp / .xml and .mks - and a subtitle file dropped onto a playing video is added as a track. The preferred language is set under General.

Subtitles that run ahead of or behind the picture are corrected for that file with Subtitle Offset in the view menu.

Styled subtitles

ASS subtitles keep their colors, outlines or boxes, shadows, positions, rotation, moves and fades, and the fonts an MKV brings along. SRT keeps italic, underlined and colored words. TTML, IMSC and DFXP files keep their positions, colors and fonts, each language in the file is a track of its own, and in 3D each line sits at the depth the file gives it. Long lines wrap into lines of even length.

Subtitle lines

Ctrl+T, or Subtitle Lines in the subtitle menu, lists every line of the current subtitle track beside the picture - a picture subtitle as a small picture of itself. Subtitles on a disc cannot be listed yet. The line on screen stays in view; type words or a time to find a line, and click one to jump there.

Diagnostics & Bug Reports

Something went wrong? Press Ctrl + P right after it happens. Oku3D copies a report on your system, the open file and its recent log to the clipboard - paste it into an email to jens@oku3d.com, with a sentence on what you did.

The report names recently opened files - look it over before sending if any of them are private.

If Oku3D crashes or freezes

When Ctrl + P is out of reach, start Oku3D from a terminal and send the log it prints there. Close Oku3D first - end oku3d.exe in Task Manager if it hangs.

Windows: press Windows + R and paste the line that matches how you installed it - for all users, or only for you:

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

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

Linux: in a terminal, the line that matches how you installed it:

RUST_LOG='warn,oku3d=trace' ./oku3d

RUST_LOG='warn,oku3d=trace' ./oku3d-*.AppImage

flatpak run --env=RUST_LOG='warn,oku3d=trace' com.oku3d.Oku3D