FINALLY

01 · basics

Start here

Point the laser. Pull the trigger. That's most of Finally.

What 1.0.8 changes

1.0.8 tightens the paths people touch every day while preserving the advanced tools in PRO:

• Modern SMB setup — test server sign-in, choose a shared-folder card, drill through folder rows, test the exact selection, and save only when you press Add & browse. Empty or mixed folders are valid; there is no media-percentage rule.
• Calmer controls — SIMPLE is now PLAY · VIEW · PICTURE · HELP · PRO, with larger transport and placement targets, CLOSER/FARTHER/ZOOM controls, and individual reset help. Advanced placement, subtitle, loop, keying, and setup tools remain in PRO.
• Stable pointing — live progress, marquee, slider, and scrub repaints preserve settled hit geometry; controller targets use more forgiving acquisition areas without changing visible slider calibration.
• Safer controller input — title change requires the same hand to hold grip plus a mostly vertical stick for 600 ms, then return fully neutral before it can fire again. Galaxy controller bodies use grip pose while lasers use aim pose.
• Handy disclosure — the first HandyFeeling connection requires an explicit controller-native disclosure and CONNECT action; Forget revokes the acknowledgement and clears recoverable saved-key state.

Two reading lanes: Start here through Bug reports is Daily Use. Engineering Receipts, Theory of Operation, and Deeper are optional appendices; you do not need them to set up a source or watch a title.

The vault is your library. Open a folder to dig in. Open a title to play. Daily browsing and playback stay in VR; source management, document pickers, delete confirmation, and Watch Together can intentionally open Android's flat or system UI.

02 · first run

Guided tutorial

Six skippable cards get you from first launch to a correctly placed picture.

1. Practice pointing and pulling the trigger on the real target.
2. Learn where local folders and SMB shares enter the vault.
3. Move flat content with the physical scene dolly.
4. Repair projection, stereo packing, and eye order.
5. Find Dark room, subtitles, and automatic frame-rate matching.
6. Choose SIMPLE or PRO and start using Finally.

SKIP TUTORIAL and START USING FINALLY both record completion. System Back leaves it incomplete, so it can return after a cold start. Replay it whenever you want from SRC → Quick-start tutorial.

daily use · quick answers

Daily-use FAQ

03 · muscle memory

Controls

The full map. B is Menu / Back by default; the optional B/Y swap moves that role to Y.

What the stick means right now

Context wins: panel-holding takes precedence, photos repurpose horizontal seek for album navigation, and the ordinary closed-video map applies otherwise. The title-change hold cancels on wobble, grip release, direction reversal, or a conflicting mode; held startup input cannot skip a title.

Haptics: a hover tick and click pulse on the pointing hand. The GLOBAL SETTINGS master toggle remains, and a saved HAPTIC STRENGTH slider scales later pulses from OFF to 100%. Quest defaults to 100%; Galaxy XR defaults to 55%. Hard rule: grip away from the panel does nothing — no accidental grabs.

04 · the lobby

The Lobby

♡ Finally Lobby — your vault, floating in a neon room (or your real one).

The Lobby is where you land. Titles list in the center; favorites wear a ★; folders glow gold. Aim and trigger to open anything.

The chip row

The wide band under the list carries the four destinations: SRC (sources), CFG (GLOBAL SETTINGS), HELP, and EXIT. GROUP WATCH — private-LAN Host / Join pairing (see Watch Together) — lives under CFG, and Room dim is a CFG preference too.

Search a large vault

Choose FIND, type with the controller-first keyboard, and apply the query. Search is case-insensitive, every word must appear somewhere in the displayed title, and the resulting rows keep the active sort order. Untitled Stash scenes are searchable by their filename fallback. Press Menu / Back—B by default or Y after the optional swap—to close the editor or clear an applied search before the normal folder-back action continues.

Grab the list

The vault scrolls like a phone list. Grab it with Trigger and drag — past a small threshold of travel the press becomes a scroll instead of a click, so aiming at a row and squeezing still just opens it. Release while moving and the list coasts, bleeding off speed like a flick on glass, with a hard stop at each end — no bounce. A press while it's coasting catches the list: it stops under your laser, and releasing never fires the row it happened to land on.

When the vault overflows, a slim scroll bar rides the right edge — a dim neon thumb sized by how much of the list you're seeing. Point at it and drag for an absolute jump, or tap anywhere on the track and the thumb lands under your laser. Stick ↕ still works; it's just no longer the only way.

One honest line while we're here: every list now reaches its final entries — earlier builds carried a capacity bug that hid the last two rows of any overflowing list. 0.3.14 fixed the math.

Check many at once

Press SELECT and every row grows a checkbox on its leading edge. Tap boxes to check rows — checking never opens a title, and the row's open target starts after the box, so the two can't collide. The chip becomes a live count. Rows are remembered by which title they are, not where they sit, so a list that re-sorts under you never re-targets your checks.

One verdict per press. A mixed set gets made uniform, favoring on: if anything checked isn't a favorite yet, ★ FAV favorites the lot; only a fully-favorited set flips off. Same law for HIDE and COLOR — after any press, everything checked agrees, and "select all, press twice" is always a clean clear. It's the same rule your photo app uses, on purpose.

Leaving SELECT clears the checks — an invisible checked row is never allowed to survive and surprise a later press.

The chips explain themselves

Rest the laser on any chip in the bottom rows and the footer describes what it does before you commit — "HIDE · remove checked rows from the list — deletes nothing." No more pressing to find out.

Posters on the rows

Every local title wears a poster — one real frame pulled from ~10% into the video, past the black leaders and intro cards, cached so the vault paints instantly next time. Stereo-packed files are cropped to a single eye first, so a poster is never a double image. Rows still loading show a quiet glyph — and NAS and Blu-ray ISO rows keep the glyph on purpose: pulling megabytes over the network (or spinning up the whole disc stack) just to decorate a list is how library screens start stuttering. The 2D library rows wear the same posters.

Who gets hidden

Files that auto-detect as plain mono — a whole-word mono tag in the filename — are tucked out of the vault and the 2D library, with an honest count in the vault footer: N MONO hidden. Two rules keep this safe: the detector matches whole tags only (Kimono and Monolith never vanish), and a title with your saved settings is never auto-hidden — your choices always beat the detector's. The tag is the switch: rename the file and it's back.

Deleted files clean up after themselves now. A library entry whose local file is gone used to be unkillable — it wouldn't play, and DELETE refused it because there was no file left to delete. As of 1.0.0 it clears on contact: open it and Finally removes the entry (telling you so), press DELETE on it and "already gone" counts as done, or press ↻ SCAN to sweep every such ghost in one pass. One safety stands guard: if the whole storage volume is unmounted, nothing is removed — every file merely looking absent must never erase a library.

Sort a folder

The flat Library has a Sort picker; each Lobby press of SORT advances the same saved choice. Favorites remain pinned and folders remain above videos. Missing size, duration, or date values sort last in either direction, and stable tie-breakers prevent rows from jumping during refresh.

Large-library repair in code 32 and later: A-Z and Z-A now obey the full comparator contract even across thousands of Plex rows. Finally rebuilds the view before saving a new sort choice, so a failed rebuild cannot poison the next launch. The repair keeps the existing library index, Plex source, and credentials.

“Date added” means when the item entered the Finally vault, not necessarily its filesystem modification date.

Delete one local video

1. Focus one local video and choose DEL.
2. Read the exact-file confirmation.
3. Choose Delete file; Android may show its own final consent surface.

Finally reloads the vault row and root before deletion so a stale selection cannot redirect the action. It fails closed for SMB, FTP, WebDAV, Plex, Stash, folders, DVD, ISO, cloud/server rows, traversal paths, missing roots, or a target that no longer matches the selection. A successful delete is permanent. Clear vault only removes Finally's records and never deletes the media.

Setup from the Lobby

SRC opens the in-room source status and rescan panel. Choose EDIT WITH KEYBOARD when you need the flat Library setup screen, Android pickers, or server forms; Quick-start tutorial replays the guided tour. Lobby CFG (GLOBAL SETTINGS) holds menu level, resume, skip intro, tilt follow, stick direction, seek step, Seek landing (FAST ⇄ EXACT, see Seeking), NAS buffer (LEAN · DEFAULT · BIG · MAX, see Sources & NAS), Room dim, cockpit Menu style (SIMPLE ⇄ PRO), GROUP WATCH, and the dedicated CHLOEVIBES control entry. During playback, switch to PRO for the GLOBAL SETTINGS page and HAPTIC CONTROL PANEL. HELP opens help in-headset with no title required.

Android's flat or system UI appears only for tasks that need it: source management and folder/document pickers, the external-subtitle picker, local-file delete confirmation, and Watch Together setup. Return to the Lobby when that task finishes.

EXIT leaves to your headset home — labeled EXIT → QUEST on Quest and EXIT → HOME on Galaxy XR. The exit path is single-flight with a harder OpenXR teardown so Meta home / Loft can reclaim the headset. Lobby worlds reload after stop; a failed 8K environment load falls back to VOID instead of leaving a broken room. On the empty first run, open SRC, or drop files in Movies/Finally and use ↻ SCAN.

05 · while playing

The Cockpit

Press Menu / Back—B by default or Y after the optional swap—during playback: quick strip first, full cockpit second, gone third.

The Menu / Back cycle

While a video plays, the Menu / Back button—B by default, Y after the optional swap—walks a three-step cycle: nothing open → quick strip → full cockpit → hidden. The strip spawns low, below your eyeline — a glance down, not a wall of controls in your face. A second press grows it into the full cockpit in place; a third puts everything away. A bare Trigger pull summons the strip too, so the common moves are always one squeeze away.

Photos skip the strip — Menu / Back opens the full cockpit directly, because transport means nothing to a still. In the lobby, the same button backs out through panels and folders before hiding the root vault.

The quick strip

The strip carries the moves you actually make mid-video: the timeline scrubber (full drag-seek; local/SAF titles can show storyboard tiles while scrubbing), -30s / -5s / PLAY / +5s / +30s (the small step is adjustable in GLOBAL SETTINGS), ■ STOP, speed, volume, mute, PREV / ◆ LOBBY / NEXT, SHUF, ◀ CLOSER / FARTHER ▶, and the DARK / ROOM toggle. In SIMPLE mode, point and trigger the always-visible PRO CONTROLS target to promote the strip into the full cockpit. In PRO mode the strip adds A·B·C·D loop chips and STATS. If a network stream stalls, it raises itself with a REBUFFERING banner that shows buffer seconds · fill % · MB/s · network class, then stands back down when the flow recovers — details in Sources & NAS.

SIMPLE and PRO

The full cockpit ships in SIMPLE mode with five stable tabs: PLAY · VIEW · PICTURE · HELP · PRO. PLAY keeps the common transport plus large PREV, NEXT, RESET, SUBS, and AUDIO targets. VIEW puts large CLOSER, FARTHER, ZOOM−, ZOOM+, RESET PLACE + EYES, and RESET VIEW controls ahead of fine placement. PICTURE keeps the everyday picture grade, reset, room dim, and a path into chroma key.

Tap PRO for detailed PLAY, PLACE/EYES, COLOR/KEY, GLOBAL SETTINGS, and HELP pages; BASIC returns to SIMPLE. Your choice is saved and can also be changed from Lobby GLOBAL SETTINGS → Menu style. SIMPLE intentionally buries chapter/shuffle extras, external/movable/delayed subtitle tools, loops, specialist lens profiles, fine placement, and detailed setup while keeping them available in PRO.

The PRO pages:

PLAY

The transport. Timeline scrubber (drag-seek; storyboard tiles on local/SAF when available), -30s / -5s / PLAY / +5s / +30s, ■ STOP, ◆ LOBBY to return to the lobby, speed, volume, mute, AUDIO (track list + studio), SUBS / LOAD SUBTITLE / MOVE SUBS, Eyes (L·R ⇄ R·L), the preset AUTO/MANUAL toggle, passthrough, CHAPTER chips when marks exist, A·B·C·D loop marks (PRO), PREV/NEXT/SHUF, and the quick lens row (VR180 · VR360 · Flat · SBS · OU · AUTO). On a photo, the transport cluster becomes the slideshow controls — START SLIDESHOW on the PLAY chip, PHOTO TIME where Speed sits, and TRANSITION beside it (see Photos).

SBS and OU are toggles: press the lit one and the title drops back to 2D — the lit cell even says so: again = 2D. Stereo always has a one-press exit, in SIMPLE and PRO alike.

AUDIO studio

Tap AUDIO during ordinary playback. SIMPLE keeps Night soft, volume, mute, and the multi-track list (preferred language is remembered). Tap PRO inside the studio for Bass / Mid / Treble EQ, Dynamics (Off / Soft / Night / Punch), stereo width, and Reset FX. Effects fail closed if the Android audio chain cannot attach. ISO/SSIF prepared routes keep the shared AUDIO path disabled.

PLACE / EYES

Where the scene sits and how your eyes meet it. Sliders for scene height, move scene (left/right), distance (about 0.22–8.0 for cinema seats), zoom (up to 6× where exposed), depth position (stereo convergence), eye height align, scene tilt, scene roll, and screen curve (flat titles only — 0 to ~100° of cylindrical wrap, saved per title). Plus flip left/right, flip up/down, Reset place + eyes, and the full manual lens row — see Lenses.

These sliders are live twice over: every cockpit slider repaints while your trigger drags it, and tilt, roll, and Distance also follow grip and stick gestures in real time — push the stick and the Distance readout moves with you. Stick-click homes Distance + Zoom. Roll the dome with your wrist and SCENE ROLL moves with you, instead of showing a stale value that later snaps the scene back. During continuous playback, zoom and distance also carry forward onto untuned titles — see view carry.

COLOR / KEY

A full color grade: brightness, contrast, gamma, saturation, hue, and warmth — six proper sliders with a one-tap RESET PICTURE. The grade touches the video only (the menu panel stays neutral) and is saved with a title when it has a stable library identity; RESET PICTURE clears that title's grade. Below it sits the passthrough keying suite: master passthrough toggle, packed-alpha matte, and four-color chroma key with per-color edge controls. Detailed in Your room.

GLOBAL SETTINGS

Seek step size, menu distance and size, theme, menu spawn (at gaze or fixed origin), default-SBS-for-180 toggle, skip intro, resume on/off, stick distance direction (pull = smaller by default, flippable), wrist-roll dome tilt, the haptics master plus saved OFF–100% strength, subtitle delay and size, and the Stats HUD toggle — plus the lying-down suite: tilt follow rolls the picture with your head so it stays upright to your face instead of the room (lie on your side; the movie comes with you — menus and laser stay world-anchored), and menu level makes the cockpit spawn gravity-level instead of matching your head tilt.

More GLOBAL SETTINGS highlights

Reachable from the Lobby (CFG) and during playback. Beyond the older resume / skip-intro / NAS buffer / menu-style controls:

• Default projection for untagged files — cycle Flat / VR180 / FE190 / Fisheye / MKX200 / MKX220 / VRCA220 / 360°. Filename tags and strong frame geometry still win when present.
• Display refresh — cadence-aware AFR, plus optional MAX = highest advertised headset rate (about 120 Hz on Quest 3 when available; Galaxy still floors below 72 Hz).
• Controller map — face B/Y swap, seek-stick invert, stick-distance direction; a short summary of the live binding.
• Button glow — LOW / MED / HIGH for cockpit chrome intensity.
• Clear HTTP cache — empties the progressive HTTPS disk cache (512 MB LRU) used by browser/direct progressive paths.
• CHLOEVIBES / HAPTIC CONTROL PANEL — Bluetooth toys and The Handy connection-key path.

Subtitles

SUBS cycles OFF and the tracks exposed by the current container. Embedded tracks say EMBEDDED; sidecars and manually selected files say FILE. Ordinary local and SMB videos can automatically discover sibling .srt, .vtt, .ass, and .ssa files that share the complete video stem, optionally followed by a language label. WebDAV same-folder sidecars can auto-pick too. Subtitle auto-pick prefers language when several candidates exist; an explicit user OFF choice still wins.

LOAD SUBTITLE on the quick strip and PLAY page opens Android's document picker during ordinary video playback. Choose an SRT, VTT, ASS, or SSA file up to 4 MiB for a local, SMB, Plex, WebDAV, FTP, Stash, or DLNA title. Finally copies the selection into private cache, rebinds the same movie, selects the new FILE track, and resumes only if it was playing before the picker opened. The original URI is not persisted or logged, and the attachment lasts only for that playback session. Stills and the special ISO/MVC route do not offer this control.

MOVE SUBS free-drags the caption on the picture with the laser; press B to save the placement. In PRO → GLOBAL SETTINGS, Subtitle look cycles saved CINEMA, CLEAN, and HIGH CONTRAST styles; Sub delay spans −10 to +10 seconds and Sub size spans about 75% to 300% (larger default than older builds). Resizing no longer freezes controllers. There is no independent subtitle-depth control. The ISO route reports SUBS · ISO N/A because text and PGS rendering are deliberately disabled there.

Dark room, ROOM DIM and AFR

DARK ROOM gives flat movies a plain black surround; ROOM VISIBLE restores passthrough. ROOM DIM is a saved 0–100% background-luminance slider in 5% steps. It dims bundled/procedural rooms, the flat-video background, and passthrough—including what shows through chroma/packed-alpha holes—without dimming the movie, still, subtitles, or cockpit UI.

Automatic frame-rate matching sends Android a seamless display-rate hint based on normalized source cadence and playback speed. Common mappings include 24→72, 30→90, 40→80, 60→120 when advertised, and 25 / 50 / 100 → 100 Hz when the headset advertises 100. Optional MAX forces the highest advertised rate instead of cadence matching. The headset still chooses the final display mode. AFR is not frame interpolation: it never invents motion or converts a low-frame-rate file to 60 or 90 fps. Verify the live rate in Stats HUD.

HELP

The in-headset version of this manual: subjects on the left, article on the right, stick ↕ scrolls. It also includes two extra chapters — THEORY (teal) and DEEPER (green). Both are reproduced below in full: start with Theory of Operation, then enter Deeper.

Stats for nerds

PRO only. Tap STATS on the quick strip's header (or PRO → GLOBAL SETTINGS → Stats HUD) and the strip's lower half becomes a live readout: source class, video codec with resolution @ fps, decoder and dropped frames, audio codec, color info, buffer seconds against target, NAS fill % with live MB/s, position / speed / state, active lens + stereo, current Android display mode, source cadence, target refresh, and cadence multiple. It refreshes once a second while open, the scrubber and transport stay live above it, and it never appears on photos.

For example, 23.976-fps cinema at a reported 72 Hz qualifies as a 3:3 lock. LOCKED never means “requested” or merely “supported.”

05A · optional accessory control

ChloeVibes Haptic Control Panel

ChloeVibes is built directly into Finally. There is no second app to install or keep running.

Local media timing; local Bluetooth control. Finally reads a matching .funscript. Lovense-class Bluetooth control is direct; The Handy cloud path is disclosed separately below.

Visit the ChloeVibes project on GitHub →

Connect and arm

1. In the Lobby, open CFG (GLOBAL SETTINGS) → CHLOEVIBES.
2. Choose SCAN. Android may ask for Nearby Devices / Bluetooth permission the first time.
3. Select and connect the intended accessory, confirm its displayed name, and set TOY STRENGTH.
4. Choose ARM only when you are ready for accessory output.
5. Play a video with a readable sidecar that shares its complete basename: Movie.mp4 matches Movie.funscript.

During playback, open GLOBAL SETTINGS → HAPTIC CONTROL PANEL for connection/script status, STOP, ARM / DISARM, TEST, and strength. TOY STRENGTH controls the accessory; controller HAPTIC STRENGTH remains a separate setting for menu hover/click pulses. Max stroke length and max stroke speed caps tame wild funscripts so a single authored peak cannot pin the motor.

The Handy (Wi‑Fi key path)

The same panel family can drive The Handy over Wi‑Fi using a HandyFeeling connection key (clipboard paste is supported when the OS exposes it). Before the first request for a new key, Finally shows a controller-reachable disclosure with CANCEL and CONNECT. CONNECT sends the key, source IP/network-request metadata, connection/status checks, device setup, and a rest-position command to HandyFeeling (operated by Ohdoki AS) over HTTPS. CONNECT can physically reposition The Handy before ARM; keep clear. While connected and ARMED, script playback or TEST sends motion position/duration; STOP or disconnect can send mode/stop commands even when not armed. During script playback, motion values and cadence come from the local .funscript; the raw script, title, media path, and video are not sent. Coldbricks receives none of these requests. See the Finally privacy policy and The Handy privacy policy. Bluetooth Lovense-class devices remain on the direct scan/connect path above. Always STOP / DISARM before troubleshooting either path.

STOP and bounded TEST

TEST requires an already connected and armed accessory. It emits exactly one 300 ms pulse, then automatically sends STOP and DISARMS. Repeated presses cannot stack pulses or extend the safety window, and TEST is unavailable while ordinary playback owns accessory output.

Pause, buffering or lost playback ownership, leaving the player, disconnecting the accessory, or closing the session invalidates motion and follows the stop/disarm safety path.

Private by design

Bluetooth scan results, accessory identifiers, connection state, and .funscript timing stay on the headset. Finally does not send that information to Coldbricks and uses no ChloeVibes cloud backend.

The separate The Handy path uses Ohdoki's HandyFeeling service as disclosed immediately before CONNECT. Forget Handy key removes the local key; it is not a request to delete Ohdoki server records.

06 · the projection brain

Lenses & projection

Filenames hint the shape. Untagged files use the real frame geometry. Your fixes stick per title — forever.

Every VR video is a flat rectangle of pixels that has to be wrapped back into a world. Get the wrap wrong and the scale, depth, and edges all lie to you. Finally reads the filename, checks the frame, picks a projection — and when it can't know, gives you manual overrides that persist.

The lens family

FULL versus HALF stereo packing

Choose the packing that matches the file. Tap an active stereo choice again for mono/2D; AUTO returns control to detection. If depth looks inverted, swap eyes instead of changing FULL to HALF.

Flat-screen aspect repair

For a FLAT title, use ASPECT only after stereo packing is correct. It cycles AUTO → 16:9 → 4:3 → 2:1 → 2.40:1 → 1:1 → 9:16. AUTO uses decoded geometry, pixel-aspect ratio, and packing. A fixed value changes screen shape after eye unpacking; it does not change eye order, lens, projection, or AUTO/MANUAL detection. ASPECT is intentionally disabled for VR180, VR360, and fisheye projections.

When there's no tag at all

A filename tag is a promise, and Finally keeps it — tagged 180 files keep the ecosystem's SBS convention. An untagged file first consults your saved Default projection in GLOBAL SETTINGS (Flat / VR180 / FE190 / Fisheye / MKX… / 360°) when you want a house default, then falls back to a careful geometry guess: the frame is only eye-split when halving it actually yields two roughly square eyes (the classic 2:1 full-SBS dome). Portrait video is never VR. An ultra-wide frame (32:9-class) resolves to a flat 3D SBS screen — that shape is a movie pack or a monitor capture, never a hemisphere. And an odd, non-standard aspect plays mono instead of being torn in half — a wrong mono is watchable; a wrong eye-split is soup. Your per-title manual override still beats everything.

AUTO, MANUAL, and the consent card

Finally's override system exists to kill a disease other players have: silently forgetting your fixes, or silently fighting the filename. The rules:

• AUTO (default): identity is re-derived from the filename and frame every open — detector improvements and renames stay live.
• The first big manual change on a tagged file asks once: OVERRIDE (manual settings for this file) or KEEP AUTO (follow the filename preset).
• Choose OVERRIDE and your settings beat the filename forever — surviving reopens, rescans, and app updates.
• AUTO leads both lens rows as the escape hatch — one tap hands the file back to the detector. Nobody gets trapped in MKX land.

07 · reference

Filename tags

Deo-compatible and then some. Tags are case-insensitive; separators are _ - . space ( ) [ ].

Projection / lens

Stereo packing

Untagged fisheye-family files default to SBS — that's how the ecosystem ships them.

Extras

08 · your library

Sources & NAS

Local folders and SMB are first-class. The current release also has nearby SMB/DLNA discovery plus bounded FTP, WebDAV, Plex, Stash, DLNA, and direct-link paths.

The zero-setup path

Drop files into Movies/Finally on the headset and hit ↻ SCAN. Done.

Folders and files

The 2D library (reached via FOLDERS) adds any folder with ＋ Add videos folder — and it chains: Android's picker grants one folder per round, so after each scan lands Finally asks "add another?" and relaunches the picker until you're done. Two taps per extra folder, not a hunt for the pill. ＋ Add files is multi-select — long-press or tap several in the system picker and they land together, each checked for compatibility, with one summary at the end. Sidecar import/export lives here too. Clear vault removes library rows only — it never deletes files on disk or NAS.

Find nearby sources

In the 2D source-setup panel, choose 🔎 FIND NEARBY SOURCES. Finally runs a bounded Wi-Fi search and labels results honestly as SMB SERVER or MEDIA SERVER. A discovered DLNA/UPnP server can prefill its setup and browse path. A discovered SMB host prefills the address; you still sign in and choose a visible SMB2/3 share when the server permits enumeration, or type the share name manually. Results stay in first-seen order so a row cannot jump away from a controller press. Manual SMB and DLNA entry always remain available when a router, firewall, VPN, or server blocks discovery.

NAS / PC share (SMB)

Finally treats SMB2/3 as a first-class library source — stream straight off your PC or NAS over Wi-Fi, no copying.

1. On your computer, share a folder (Windows: Properties → Sharing).
2. Put some videos in that folder.
3. Note the PC's local address (shown here as NAS_IP) and the share name (for example Media) — not the full path.
4. Headset and PC on the same Wi-Fi / home network.
5. Turn off any VPN on the PC if connect fails.

Add it in Finally

1. Open the 2D library and choose ＋ Add NAS share. Enter the NAS/IP and sign-in. Leave Username blank for a guest / Everyone share; port 445 is normal.
2. Leave Shared folder blank and choose Test server sign-in to check only the server and sign-in. It saves nothing and does not test any folder.
3. Choose Browse shared folders. Pick a full-width share card, then open child-folder rows to drill down. Back moves to the parent folder, then the share list, then the form. The shared-folder root itself can be selected.
4. Choose Select this folder. This fills the form only; nothing has been saved. Optionally choose Test connection to open and list that exact share/folder. The test also saves nothing.
5. Choose the separate Add & browse action (or Save & browse while editing). Finally reopens and lists the exact folder, checks duplicates, and only then saves the source.
6. Open the saved NAS row and choose Browse instantly for one bounded folder view or Index entire source for recursive discovery.

Browse and index results

Browse instantly returns one bounded snapshot: up to 5,000 folder/media entries after inspecting at most 10,000 raw rows. Index entire source is bounded at 75,000 compatible files, 10,000 directories, and 100,000 raw rows in any one directory.

An empty or mixed folder is reported as connected, not rejected. Permission-denied, failed, unscanned, and raw-capped branches are named instead of silently skipped. If entries were omitted, the result is partial, not empty. Use Continue indexing only when a safe checkpoint is offered; otherwise use Retry indexing or choose a narrower folder. A single flat folder beyond the 100,000-row ceiling has no within-folder continuation.

A retained deterministic regression covers 54,321 files in 3,400 folders across three resumable pages; that is a host-test boundary, not a promise about every NAS or router. NAS housekeeping folders (@eaDir, #recycle, dot-folders and their cousins) are pruned by design, and one locked folder does not kill the rest of a scan.

Network scans also skip music album art automatically (cover.jpg, folder.jpg, fanart, and any thumbnail-sized still) — a share with a music library won't flood your vault with sleeve scans. Folders and files you pick directly keep every image you chose — even one named poster.jpg: locally, only thumbnail-sized files (under 256 KB) are skipped, a file whose size can't be read is never filtered, and the name-based art net stays NAS-only.

Rescan without leaving VR

The vault's ↻ SCAN re-walks your saved NAS share along with the local sources. Dropped new files on the server mid-session? One chip, headset stays on, and they're in the vault.

Soft-retain on complete rescans: for SMB / WebDAV / FTP / Plex / Stash / DLNA, titles that disappear mid-walk keep their resume position and favorites instead of being hard-deleted while the scan is still finishing. When the file is truly gone, later cleanup can still drop the row — but a flaky page no longer wipes your place in a series.

Edit / Rescan / Remove: long-press or open the source actions for Plex, FTP, WebDAV, Stash, DLNA, and XBVR. The action list must show all three choices (an older dialog bug could hide everything except Cancel). Removing a source deletes Finally's record and vault rows for that source — never the server's files.

The NAS buffer

Lobby CFG → NAS buffer cycles LEAN · DEFAULT · BIG · MAX — how far a network stream reads ahead of playback. Bigger rides out longer Wi-Fi dips before the REBUFFERING banner would ever appear; the cost is more memory and cache space on the headset. DEFAULT is the shipped profile. The setting applies from the next title you open — a title already playing keeps the buffer it started with.

The network reservoir pipelines bounded read-ahead, coalesces short server reads, cancels in-flight work on close, and handles far seeks without unbounded hot memory. Its deterministic jitter gate consumes one second at 150 Mbps and then performs a far seek inside the configured caps. That proves the buffer logic, not that a particular Wi-Fi link or spinning disk can sustain 150 Mbps.

When the stream stalls

NAS playback narrates itself. While a network title loads, the vault shows a real buffering percentage — the actual readahead fill, not a spinner. If the stream stalls mid-play, the quick strip raises itself with a REBUFFERING banner that reports buffer seconds · fill % · MB/s · network class (no silent black dome), then hides again once the flow recovers. In Stats HUD, compare sustained live MB/s against content bitrate: a negative margin predicts repeated buffering even when a short speed test looks fast.

Progressive HTTPS cache: browser/direct progressive HTTPS paths use a 512 MB on-device LRU disk cache. Clear it from GLOBAL SETTINGS → Clear HTTP cache if a stuck partial download is poisoning retries.

If a video can't play at all, the reason lands on the vault panel as a bold amber alert band, in plain language: corrupt file, unsupported codec, no permission, file missing, or "NAS stopped responding." A server that's connected but frozen is declared dead in about 20 seconds — no eternal hourglass. A network that drops out entirely gets a ~45-second self-heal window: Finally keeps reconnecting, and if the network comes back in that window, playback resumes by itself.

FTP, WebDAV, Plex, Stash, DLNA, XBVR & direct links

Seven short setup recipes

1. Nearby: Sources → Find nearby sources. Select an SMB server or DLNA media server to prefill the appropriate setup form; use manual entry if nothing answers.
2. FTP: Sources → Add FTP server. Enter a name, host/IP, port (normally 21), server folder, username, and optional password; choose Connect & scan. Use only passive plain FTP on a private LAN.
3. WebDAV: Sources → Add WebDAV. Enter the collection URL plus username/password, then Connect & scan. Prefer HTTPS; acknowledged HTTP is limited to a trusted private address.
4. Plex: Sources → Add Plex. Enter the local Plex Media Server URL and its X-Plex-Token, then Connect & scan. Finally Direct Plays the original Part and does not request transcoding.
5. Stash: Sources → Add Stash. Enter the Stash base URL and API key, then Connect & scan. Finally reads bounded GraphQL scene pages; rescan to replace blank-title scene numbers with filename fallbacks.
6. XBVR: Sources → Add XBVR. Enter the local XBVR base URL (and credentials if required), then connect. Browse titles from Lobby SRC; funscript download is optional when the server offers it.
7. DLNA: Sources → Add DLNA server. Use a discovered device or enter the trusted-LAN description URL, validate it, then browse or index its ContentDirectory.

WebDAV compatibility boundary: Connect & scan uses collection PROPFIND and can follow safe HTTPS redirects to the final collection. After listing succeeds, ranged media GETs can follow at most five HTTPS handoffs. Finally accepts exact or server-proven end-of-file 206 Content-Range replies, including chunked partial bodies. It keeps authorization only on the original origin and rejects HTTP downgrade, URL credentials, loops, excessive hops, malformed ranges, or a full 200 reply that ignored Range. A server that cannot meet that contract is reported as incompatible instead of feeding wrong bytes to the decoder.

WebDAV, Plex, Stash, and XBVR default to HTTPS when you supply an https URL. Using acknowledged HTTP or plain FTP exposes credentials and media to the local network, so keep those modes on a private LAN you control. Removing a source deletes Finally's record and vault rows, never the server's files.

What plays

Video: mp4 mkv mov webm avi m2ts ts mpg vob 3gp and friends — plus decrypted Blu-ray iso images, which play as discs (see Blu-ray ISO). Stills: jpg png webp heic avif bmp and friends. wmv / asf are deliberately not listed — the headset ships no decoder for them, so they could never play; a library row that can't play is a lie. Dead entries from older versions clean themselves up on first launch.

Hardware decode up to 8K where the headset and exact stream allow. A focused Quest 3 gate opened an 8192×4096/30-fps HEVC Main 10 MKV at about 156.7 Mbps with AAC, embedded PGS, chapters, and deliberately conflicting stereo metadata; it proved first frame, track exposure, seek, another rendered-frame callback, and resumed clock advance—not a long thermal soak or blanket subtitle/stereo approval.

Retained physical first-frame and seek-recovery proof covers 1080p60 AV1 Main 8 and Main 10 HDR10 on Quest 3 and Galaxy XR using the exposed hardware decoder; it is not an 8K AV1, HDR-output-accuracy, network, or long-soak claim. Audio decodes in hardware when possible and falls back to FFmpeg software for AC-3, E-AC-3, and DTS. Sidecar notes (*.finally.json) carry projection, preferences, and resume position with the title, matched by content hash or path.

09 · discs

Blu-ray ISO, MVC & physical DVD

The current 1.0.8 signed candidate (Quest c99 / Galaxy c10099) carries a narrow, explicit set of decrypted H.264/MVC routes at 1.0×. Quest retains production-route receipts from code 28 and earlier; those are historical device evidence. c99/c10099 has not received a complete MVC, SMB, or WebDAV device matrix, so route contract and measured acceptance remain separate.

Supported today / not today

Decrypted Blu-ray ISO

Drop a decrypted BDMV ISO into a local folder, SMB share, or compatible WebDAV collection and it appears in the vault like any other title. Finally walks UDF, resolves a playlist, and presents compatible base video/audio through the normal player. Remote ISOs stream in place; the image is not copied to the headset. The WebDAV random-access route is source/host validated but has no current live-server or on-head acceptance receipt. FTP, Plex, Stash, and DLNA ISO are refused. An incomplete image is refused with a plain-language card.

Using the MVC route

The narrow path is named Chloe MVC Engine 1. It decodes MVC video through edge264 (BSD), uses FFmpeg 8.1.1 (LGPL) for BDAV/audio support, and submits separate decoded eye views through OpenXR.

1. On Quest, open a complete decrypted MVC Blu-ray ISO, standalone .ssif, or genuine MVC .mkv/.mk3d from a granted local source. An eligible decrypted ISO can also come from configured SMB or a compatible WebDAV collection, with the current source/host and device boundaries above.
2. Keep speed at 1.0×.
3. For an authored ISO, use Resume and ◀ CHAPTER / CHAPTER ▶ when marks are present. Quest retains exact code-28 proof for nonzero resume and a later indexed restart; code 33 does not silently inherit that device result.
4. For standalone SSIF or MVC MKV/MK3D, begin at the start unless you are deliberately testing beyond the proven boundary.

An incomplete MVC layout, non-1.0× speed, unsupported target, or runtime health failure stops MVC promotion instead of displaying stale or unpaired eyes. Where a valid AVC base view exists, Finally can continue in 2D; otherwise it reports the unsupported path. ISO subtitle rendering remains disabled.

In code 32 and later, stopping MVC or leaving the app requests shutdown immediately. Decoder joins, blocked remote reads, and source closure finish on a serialized background cleanup lane, so the UI thread does not wait for the old session. A generation guard prevents stale cleanup from stopping a newer movie.

USB DVD-Video on Quest

1. Connect a compatible mobile optical drive to Quest through a data-capable USB-C/OTG path; provide external power if spin-up is unreliable.
2. Insert a DVD-Video disc.
3. Open Sources → Open DVD / VIDEO_TS → USB DVD drive · direct from disc and grant Android USB permission.
4. Choose a discovered title set. Finally validates clear sectors before playback.
5. Play, pause, and seek normally on an admitted title.

One Quest 3/mobile-drive/clear-disc route physically traversed USB mass storage and SCSI, found ISO9660 VIDEO_TS, rendered MPEG-2 720×480 with AC-3 stereo, sought, rendered again, and resumed. This does not claim CSS decryption, menus, complete chapter/title navigation, every UDF-only layout, long endurance, or Galaxy XR optical playback.

10 · two headsets

Watch Together

Synchronize two supported headsets on one private LAN. Each headset plays the exact same local media bytes.

Happy path — the same bytes on both headsets

1. Put the byte-identical file on both headsets and connect them to the same private LAN.
2. On the host, open that file and choose GROUP WATCH (under Lobby CFG) → HOST A ROOM.
3. On the follower, choose JOIN ROOM and enter the room code; use the displayed private IP:port if discovery is blocked.
4. Compare the complete pairing code on both headsets and accept only when every character matches.
5. Select the matching file if asked. The host then controls play, pause, and seek.

A matching filename is not proof of matching media; the bytes must be identical.

Host

1. Open the title, choose GROUP WATCH, then HOST A ROOM.
2. Give the follower the displayed room code. If discovery is blocked, also give them the displayed private IP:port.
3. Compare the complete pairing code aloud and choose CODES MATCH only when both headsets agree.
4. The host owns play, pause, and seek while the room is active.

Join

1. Make the byte-identical file available on the second headset.
2. Choose JOIN ROOM, enter the room code, and use the direct IP:port fallback when multicast discovery is unavailable.
3. Compare and confirm the same pairing code on both devices.
4. If MEDIA_MISMATCH appears, select the exact matching file; a matching filename is not enough.

The follower's transport controls remain locked until it leaves the room. Pairing uses TLS 1.3 mutual authentication, exact peer-certificate pinning, and a bilateral short authentication string. A physical production-UI run passed with Quest 3 hosting and Galaxy XR following, including explicit-IP fallback, wrong-media rejection, and play/pause/seek propagation.

11 · mixed reality

Your room

Passthrough puts the video in your actual space. The keying suite makes it belong there.

Toggle REAL in the lobby (persisted as your default) or PASSTHRU while playing. Then, on COLOR / KEY:

Chroma key — up to four colors

◆ MULTI-PICK samples a key color from the frame itself — point the laser at the green screen, pull the trigger. Each of the four color slots gets independent tolerance (tight ↔ wide), edge (sharp ↔ feather), and bleed (none ↔ clean) sliders. A pixel is removed when it matches any enabled color.

Packed alpha

Titles tagged _alpha in the SBS fisheye family carry their own transparency matte packed into the frame corners. The ALPHA cell decodes it directly — with optional override sliders for trim, choke, sharpen ↔ feather, and defringe when the source matte needs cleanup.

12 · environments

Worlds

Choose a bundled 8K environment or your own room image directly from the responsive ROOMS grid.

Press SET to open ROOMS. The three featured rooms appear first, followed by the established bundled rooms. User rooms follow them. Each room is a separate large controller target, and the exact selection persists across sessions.

Add your own equirectangular jpg, png, or webp images under Movies/Finally/environments, then reopen ROOMS. The measured seven-choice layout was six bundled rooms plus one user-room fixture: it proves responsive four-by-two layout at the production panel size and three-column reflow on narrower panels. It does not mean seven bundled rooms or establish an unlimited-overflow policy.

ROOM DIM is saved separately from the room. The lobby CFG preference offers the 100 / 75 / 50 / 25 / 0% presets; the playback picture slider exposes 0–100% in 5% steps. It dims the environment/passthrough layer only—not the media, subtitles, or UI.

13 · stills

Photos

Same vault, same lenses, same dome — full resolution.

Stills live in the library beside videos and project through the identical lens system: a VR180 photo wraps the half-dome, a flat photo is a panel you can place and curve. On a photo, Menu / Back opens the full cockpit directly — the quick strip is transport, and a still doesn't need one. Camera originals render at full sensor resolution on the dome — up to 8192px wide.

Stills navigate by stick: Stick ← → steps to the previous / next file — a photo has no timeline, so the seek stick pages the album instead. The hint under the title says so: stick ◀ PREV · NEXT ▶. Video seeking is unchanged.

Slideshow

On a photo, the PLAY chip runs the show: START SLIDESHOW begins it, PAUSE SLIDESHOW holds it, and the chip reports the current dwell — N seconds per photo.

• PHOTO TIME sits where Speed sits for video and sets the dwell — 3 to 60 seconds per photo. The clock arms only after a photo has actually reached your eyes, so decode or SMB transfer time never eats the dwell.
• TRANSITION picks hard cut (default) or fade. The fade dips only the photo to black for a beat — the room stays lit — and the next photo decodes behind the current one first, so there is no long black hold between slides.
• Your view holds. Slides keep your view anchor — no recenter between photos, and (per view carry) your zoom and distance ride onto untuned photos.
• Manual wins. Stick ← → NEXT / PREV stays an instant hard cut even while a show runs — user-initiated jumps should feel instant.
• Never use slideshows? A Slideshow ticker in GLOBAL SETTINGS (default ON) gates the whole feature — flip it OFF and every slideshow control on stills goes dark.

And a still that can't be decoded gets a plain amber card — "Couldn't decode this image — it may be corrupt or not really a photo" — never a raw codec string.

14 · playback

Loops, seeking & sound

View carry across a playlist

Set your zoom and distance once and continuous playback keeps it. During a continuous advance — natural-end autoplay, PREV/NEXT jumps, folder shuffle, and the photo slideshow — the incoming title inherits the session's current zoom and distance when it has no explicit view tuning of its own. Three rules keep it predictable:

• Per-title tuning always wins. A title you already tuned keeps its own saved zoom and distance, whole — the carry never mixes one saved axis with one carried axis.
• Fresh opens start clean. Opening a title from the vault, returning to the lobby, or a cold start begins a new session — nothing is inherited.
• Carried values persist normally. Values carried onto a title save into its per-title settings exactly like live adjustments do, so the next direct open of that title remembers them.

A–B loops, and then some

Set A, then B — hard loop. Add C and D — cascade: A→B jumps to C, C→D jumps back to A, forever. Marks are remembered per title (content hash, then path, then library identity), survive title changes and a Lobby visit, and Clear forgets only the current title. A Watch Together follower cannot set or trigger local loop marks.

Loop chips are a PRO tool — they live on the PRO cockpit and the PRO quick strip. If you don't see them, tap PRO in the tab row (see The Cockpit).

Seeking

Seeks land FAST by default: on the nearest keyframe, so the picture is there the instant you let go — an exact seek into a long 8K GOP silently decodes seconds of video before showing you anything. FAST also makes A–B loop jumps and resume instant. Need frame-perfect landings? Flip the lobby setting: CFG → Seek landing → EXACT.

Loading is quieter after a seek, too: the brief catch-up buffer after a jump gets several seconds of grace before the REBUFFERING strip would appear. Genuine stalls still raise it immediately.

Speed

0.25× to 3×, pitch-corrected, from the PLAY page or the quick strip.

Sound

Volume rides the quick strip and the PLAY page; Grip+A mutes. Multichannel tracks that the headset can't decode in hardware (AC-3, E-AC-3, DTS) fall back to software so they play anyway. Silent MKV is a bug, not a feature.

16 · devices

Quest vs Galaxy XR

Shared product core, separate artifacts and separate proof boundaries.

The daily-use and source work shares one codebase, but a device claim changes only after that target/build has its own physical evidence. Galaxy's older local MVC and c10098 controller receipts remain useful history; neither is relabeled as a c10099 pass. AFR uses normalized cadences such as 23.976, 29.97, and 59.94 on both targets (plus 25/50/100→100 when advertised) and lets the runtime choose the actual mode. Galaxy requests no mode below 71 Hz, so Finally does not request its flickering 60 Hz mode; a 60-fps title may remain at 72 Hz with a visible cadence mismatch. Stats HUD is the current readout.

17 · troubleshooting

Fix it

Still stuck? Use the privacy-bounded report below or email coldbricks@gmail.com — reports go to a person, not a queue.

18 · support

Submit a bug report

One explicit action creates a small privacy-bounded ZIP. Nothing is silently sent or uploaded.

1. Reproduce the problem if it is safe.
2. Choose PRO → GLOBAL SETTINGS → SUBMIT BUG REPORT. The same action appears beneath Stats HUD.
3. Finally writes the ZIP under Downloads/Finally Support.
4. If an email composer is installed, Finally opens it for coldbricks@gmail.com. Otherwise it tries the generic Android share sheet with the ZIP attached.
5. Describe what happened, verify the attachment, choose the destination, and press Send yourself.

The fixed-format archive is capped at 1,572,864 bytes. It can contain build/device/library counts, allowlisted settings, bounded app events, current playback scalar facts, and bounded playback-truth receipts such as codec family, dimensions, cadence, bitrate, buffer, dropped-frame, or rebuffer counters.

It excludes raw paths, URIs, filenames, NAS/server/share names, usernames, credentials, IP addresses, media bytes, arbitrary logcat, exception messages, DRM data, and decoder initialization blobs. Needed correlations become bundle-local opaque identifiers, not stable exported IDs.

Useful context to add

• Finally version/target shown in the Lobby, headset model, and OS version.
• Source class: local, SMB, FTP, WebDAV, Plex, Stash, DLNA, link, ISO, or DVD.
• Container/codec and approximate resolution or bitrate when known.
• The exact actions immediately before failure and whether the same file works locally.
• For picture issues: projection, stereo packing, eye order, and Stats HUD DISPLAY/CONTENT rows.
• For NAS issues: say whether Test server sign-in, Test connection, Add & browse, Browse instantly, or Index entire source failed. Never include a password.

optional appendix · type buttons

Themes

316 cockpit skins. COLOR / KEY → theme, or CFG → Cockpit skin. TYPE on the left · trigger to apply.

Sections: HOUSE · DAYLIGHT · AIRLINES · PLACES · CINEMA · MUSIC · DISCO · CRATE · STAGE · TV · GOLDEN · MARITIME · OPS · SIGNAL · MISC · HIGH CONTRAST. DAYLIGHT dual-lists light skins. HIGH CONTRAST is two or three colors only.

HOUSE · 8

DAYLIGHT · 18 dual-list

AIRLINES · 12

PLACES · 12

CINEMA · 14

MUSIC · 68

DISCO · 26

CRATE · 37

STAGE · 19

TV · 16

GOLDEN · 11

MARITIME · 19

OPS · 12

SIGNAL · 7

MISC · 38

HIGH CONTRAST · 17

19 · the promise

Privacy & about

No Coldbricks account or telemetry. Network features run only when you ask.

Your vault, settings, source credentials, and Bluetooth accessory state stay on your hardware. Optional Lovense-class control is a direct local Bluetooth connection. The separate The Handy path sends the disclosed connection and motion-control data to Ohdoki's HandyFeeling service over HTTPS after you choose CONNECT; it sends no title, media path, video, or raw .funscript, and Coldbricks receives none of the requests. There is no Finally account, catalog funnel, silent telemetry, or automatic diagnostic upload. Full policy: finallyvr.com/finally/privacy.

Do not use plain FTP or acknowledged plain HTTP outside a private network you control. Never accept a Watch Together pairing code that differs between headsets. Finally provides no CSS or Blu-ray decryption; use only media you are authorized to access.

Decode: MediaCodec hardware path with decoder fallback; FFmpeg software audio where hardware can't. Sisters: Finally is built alongside ChloeVibes and ChloeVR in the same shop.