Your first ten minutes

1. 1

   Launch Studio

   Open the application and confirm that it reaches the import screen without a GPU warning.

2. 2

   Add media

   Drop one or more supported camera files, or choose Open Files. Keep every required companion or segment file beside the selected file.

3. 3

   Complete calibration

   If Studio asks for stereo calibration or sensor orientation, finish that guided flow before judging the final picture.

4. 4

   Choose the motion

   Open Stabilization, enable VRadical Flow when needed, then add Lock Vertical Direction and/or Chicken Head Stabilization as intentional modifiers.

5. 5

   Shape the image

   Open Media Processing for color, LUT, image correction, and camera-specific geometry. Enable RGB histogram when you want to monitor the final left eye.

6. 6

   Set a range

   Use the left and right bracket controls to mark In and Out points when you only need part of a video.

7. 7

   Deliver

   Choose a VR or flat projection in Export, build a Timeline, or start a DeoVR stream. A higher export frame rate automatically invokes GPU RIFE interpolation.

A tiny glossary before we roll

Install on macOS

1. 1

   Open the DMG

   Use the VRadical Studio disk image supplied for your edition.

2. 2

   Copy the app

   Drag VRadical Studio into Applications. Keep the application bundle intact because it contains the GUI, CLI, libraries, and calibration tools.

3. 3

   Launch

   Open VRadical Studio from Applications. If macOS asks for confirmation, verify that you are opening the delivery you received.

4. 4

   Upgrade

   In an updater-enabled customer build, choose Help > Check for Updates or open Settings > General > Updates. A manually delivered build can still be replaced while Studio is closed.

Install on Windows

1. 1

   Run the installer

   Open VRadicalStudioSetup.exe. Windows may show an unknown-publisher UAC prompt for the current unsigned installer.

2. 2

   Choose the destination

   The default is Program Files. The installer can create Start menu and desktop shortcuts.

3. 3

   Finish prerequisites

   Allow the installer to add the Microsoft Visual C++ x64 runtime when needed.

4. 4

   Upgrade

   Use Help > Check for Updates in an updater-enabled customer build, or quit Studio and run a newer installer over the existing installation.

First-launch checks

• CHECKThe import screen appears and remains responsive.
• CHECKNo Apple Silicon or Direct3D 11 compatibility message appears.
• CHECKThe version shown in Settings matches the delivery notes.
• CHECKYour camera family is enabled in this edition. Camera support is build-specific.
• CHECKThere is enough fast local storage for camera originals, exports, and temporary calibration data.

Full version and demo editions

Accepted containers

Video profile coverage

Photo profile coverage

Canon CRM first-use workflow

1. 1

   Open the original CRM

   Studio opens a neutral native GPU preview before full visual motion analysis, so you can inspect and calibrate the source immediately.

2. 2

   Check the integrated RAW look

   Studio develops Canon RAW with its built-in recipe and packaged color resources. No separate EOS VR Utility installation is needed.

3. 3

   Calibrate video geometry

   Complete Auto-Calibration for the matching R5 Mark II or R5 C video profile before final preview, export, Timeline, or streaming.

4. 4

   Enable stabilization when needed

   Studio generates and caches the visual trajectory on demand. R5 Mark II combines optical motion with its camera metadata; R5 C uses its separate optical-only trajectory.

5. 5

   Monitor audio

   CRM exposes four 48 kHz, 24-bit mono channels. Monitoring defaults to channels 1 and 2.

Companion-file rules

Import one or many files

1. 1

   Choose media

   Use File > Open the files, the Open Files/Add files button, or drag supported files into the window.

2. 2

   Wait for the batch

   Studio probes and validates the entire selection before it exposes the first active clip.

3. 3

   Read the summary

   If some files are rejected, one summary lists every rejected name and reason. Accepted media arrives together.

4. 4

   Handle calibration

   If the active import needs calibration, that flow starts only after loading and the rejection summary are finished.

Per-media session state

• Every loaded medium keeps its own color, LUT and strength, anti-flicker, image correction, audio mode, and stabilization choices for the current session.
• Switching media restores that medium's state; it never inherits the settings of the clip that was just visible.
• Restored grade values remain exact, but the named color-profile selector returns to (None) because the session snapshot stores values rather than a live preset association.
• Removing a medium forgets its session state. Remove All clears the whole session, and restarting Studio does not restore these creative settings.
• Aliases of the same logical multipart recording share one state because Studio treats them as one inseparable medium.
• A Timeline clip starts from the source medium's current snapshot, then becomes independently editable inside the project.

Transport controls

Playback details that matter

• Fractional rates such as 29.97 and 59.94 use a high-resolution schedule rather than an integer-millisecond timer.
• When processing is late, Studio displays frames as soon as possible instead of skipping source frames to catch up.
• At end of playback, the last rendered frame stays visible. Press Play to restart from the active range.
• The preview remains centered when the window is resized.
• Photos intentionally hide playback, audio, stabilization, streaming, and In/Out controls.

Automatic calibration workflow

1. 1

   Load a calibration-capable video

   Use a clear, textured scene with useful detail across both eyes and several moments through the clip.

2. 2

   Open Media Processing

   Expand Calibration and choose Auto-Calibration. Confirm replacement if a usable calibration already exists.

3. 3

   Let Studio extract samples

   The native GPU renders several final-output eye pairs. Do not move, rename, or disconnect the source during the run.

4. 4

   Let the solver finish

   Studio prepares stereo matches, rejects weak samples, solves shared rectification and output translation, and validates the result.

5. 5

   Load automatically

   The resulting camera/profile INI is saved and applied immediately. The same profile loads automatically next time.

Modified DJI sensor orientation

• On first setup, Studio may determine cardinal sensor orientation before parallax calibration.
• Automatic setup measures stabilization ON and OFF states, then saves one complete Mod profile.
• If the scene is ambiguous, Studio does not guess. Use the calibration-purpose manual preview to capture both states, then retry calibration.
• An existing Mod profile is authoritative, including an all-zero profile created elsewhere.

Photo calibration identity

Calibration troubleshooting

A reliable setup order

1. 1

   Turn on VRadical Flow

   Start with the camera policy defaults and play a representative moving section.

2. 2

   Decide on vertical lock

   Enable Lock Vertical Direction if horizon stability matters more than retaining the camera's pitch motion.

3. 3

   Try Chicken Head only when intentional

   Use it for a fixed-forward experience, not as a generic extra smoothing switch.

4. 4

   Check source limits

   Large framing corrections or extreme motion can expose honest black borders where no source pixels exist.

5. 5

   Preview the export range

   Scrub the first, fastest, and last motion in the marked range before export.

Camera-specific controls

• GoPro BERS1 uses fixed native rolling-shutter behavior. Gyro-fusion and residual rolling-shutter sliders remain hidden.
• Older GoPro BERS0/EAC profiles can expose Gyroscope and camera-specific rolling-shutter factor controls.
• DJI Osmo 360 and Osmo 360 II use their own camera metadata and rolling-shutter policy, with separate calibration identities and one rigid motion basis for both eyes.
• Insta360 EVO, X4, X5, X6, One R/RS, and 1-inch profiles use dense FlowState motion, automatic metadata rolling shutter, and one shared trajectory for both eyes. Residual rolling-shutter sliders stay hidden.
• On X4/X5 clips recorded with both sensors down, Studio can retry left +90/right -90 automatically when no authoritative Mod profile exists, then save the working orientation. X6 keeps its own source layout policy.
• Kandao Q3U video automatically uses the FlowState path shared with Insta360 X4/X5/X6 when moving, and its steadier static path when the whole recording is detected at rest. Rolling-shutter correction is automatic with complete metadata. It supports the 24, 25, and 30 fps families within a 0.5 fps tolerance. Inspect tripod shots from start to end for residual drift.
• Canon CRM offers Off, VRadical/EOS VR Utility Flow, Lock Vertical Direction, and Chicken Head. R5 Mark II uses optical motion with its CTMD inertial data and applies exact rolling-shutter correction only when per-clip evidence proves it. R5 C has a distinct optical-only trajectory without IMU or row correction. Gyro-fusion and residual rolling-shutter controls remain hidden.
• Photos are static sources and do not expose stabilization controls.

Color grading controls

Automatic camera looks and the LOG badge

• Studio reads camera-written color metadata. A LOG badge on the media row and the exact recording format in File Properties tell you when a recognized LOG or flat recording mode is present.
• The Automatic LUT default chooses a validated camera transform when available: for example MAX2 GP-Log, Osmo 360 or 360 II D-Log M, Q3U K-Log, X5 Flat, and X6 I-Log use their matching packaged looks.
• Recognized footage without a validated transform stays neutral; Studio does not invent a LUT. A manual LUT choice, including None, overrides Automatic for that clip and its output.
• The same automatic or overridden look reaches preview, export, Timeline, and DeoVR streaming.

Live RGB histogram

1. 1

   Enable the scope

   In Color Grading, select RGB histogram below Reset. The complete final left eye stays visible; the right preview half becomes one graph.

2. 2

   Choose curves

   Red, Green, Blue, and Luminance start selected. Turn off unneeded curves while leaving at least one selected.

3. 3

   Compare edits

   The graph measures the final graded left eye, including the LUT and visible black borders. Its vertical scale is fixed from the first complete frame so later grade changes remain comparable.

4. 4

   Use Log scale if useful

   Log scale changes only graph height, not image processing or the real pixel-count labels. Toggle the scope off and on to establish a new scale.

Import and save a LUT workflow

1. 1

   Open Color Grading

   Expand the section and choose New beside LUT.

2. 2

   Select a .cube file

   Studio copies the LUT into your personal VRadical LUT folder so it remains available.

3. 3

   Set intensity

   Start around 30 to 60 percent, then tune exposure and tonal sliders. A manual choice overrides the camera's Automatic look.

4. 4

   Save a profile

   Use Save to name the complete grade for reuse.

5. 5

   Reset safely

   Reset returns the active clip's grade to neutral without deleting saved profiles or LUT files.

Image correction controls

Audio modes

Open and finish a photo

1. 1

   Import the original

   Open a supported .36p, .jpg, .cr3, .insp, or .dng whose camera family is enabled. Canon .jpeg is not an accepted alias.

2. 2

   Resolve geometry

   Use matching video calibration when the photo route requires it; Q3U can offer a compatible video-serial chooser. Original Osmo 360 and R5 Mark II photos use transient single-frame correction.

3. 3

   Inspect both eyes

   Check vertical alignment, scale, seams, and common visibility at the center and borders.

4. 4

   Frame the shot

   Use Color Grading and supported image-correction controls. Photos do not expose audio or stabilization.

5. 5

   Export

   Choose JPG final SBS/VR180, or DNG only when the source route and output contract support it.

Camera-specific photo behavior

Photos in a Timeline

• A photo becomes a silent static visual clip with a default duration of 2 seconds.
• Trim or stretch the block to change how long the same rendered frame remains on screen.
• Photo clips support placement, transitions, color/LUT, and image correction.
• Photo clips never expose audio or stabilization controls.
• Timeline export renders the calibrated native still at the Timeline cadence for the block's duration.

Export a clip

1. 1

   Set In and Out

   Mark the range in the player, or leave the full clip active.

2. 2

   Open Export

   Choose the green export button at the lower right.

3. 3

   Name the file

   Choose a destination and a meaningful filename. Studio adds a numeric suffix when the name already exists.

4. 4

   Choose the picture

   Set resolution, one of the supported VR or flat projections, frame rate, codec, bit depth, denoise, and sharpening.

5. 5

   Confirm motion and metadata

   Review stabilization, hardware acceleration, and VR metadata.

6. 6

   Start Export

   The validated job enters the Export Queue. You can keep working while it runs.

Core export controls

Choose the output projection

Raise frame rate with RIFE

1. 1

   Choose a higher target

   For a 24, 25, or 30 fps source, choose a higher export rate such as 60 fps. The RIFE badge appears in the dialog and queue.

2. 2

   Review the range

   GPU RIFE creates intermediate frames after camera rendering and New Style denoise, then the result is encoded once. It can require substantial GPU memory and time at high resolution.

3. 3

   Keep edits independent

   In a mixed Timeline, each source clip is checked independently; interpolation never crosses a cut or gap. Photos hold their image and are not interpolated.

Codec and container guide

Built-in YouTube profiles

Photo export settings

Mixed batch export

1. 1

   Select several media items

   Include supported videos and photos from one or more enabled camera families.

2. 2

   Choose Export

   Studio groups the selection by camera family and media kind.

3. 3

   Review every tab

   Each group keeps its original video or photo export controls. A fixed camera policy can override an incompatible tab choice.

4. 4

   Choose the destination

   Video groups may offer immersive or Flat projections according to every source eye in that group. A higher chosen output rate activates RIFE for eligible video sources.

5. 5

   Resolve names

   Choose output names and let Studio avoid collisions with unique suffixes.

6. 6

   Validate the complete batch

   Studio checks every photo/video job before queuing any of them.

7. 7

   Enqueue atomically

   If validation succeeds, the full batch enters the queue and executes sequentially.

Export Queue

Queue context actions

• Export Settings - review the frozen job settings.
• Show in Finder / Explorer - reveal a completed output.
• Retry - rebuild a failed or cancelled attempt from its job contract.
• Show Error - read the complete failure reason.
• Remove from list - clear a finished entry without deleting its output.
• Cancel export - request a clean stop for an active job.

Publish after export

Build a project

1. 1

   Load source media

   Import every video and photo you plan to use. Referenced media also loads when you open a Timeline project.

2. 2

   Enter Timeline

   Choose the Timeline button on the right rail.

3. 3

   Add visual clips

   Double-click or drag supported media into the visual track.

4. 4

   Add external audio

   Use + Audio for WAV, MP3, M4A, AAC, or FLAC from the file picker.

5. 5

   Arrange and trim

   Drag clips, adjust edges, split at the playhead, and remove unwanted blocks.

6. 6

   Polish each clip

   Open clip-specific audio, color, image correction, or stabilization where supported.

7. 7

   Save

   Write a .vradical-timeline project before export or streaming.

Editing operations

Transitions

Per-clip settings

• Video clips can carry their own stabilization mode, audio mode, color/LUT grade, and image correction.
• A new clip is initialized from its source medium's current session snapshot; later Timeline edits belong to that clip.
• Photo clips carry color/LUT, image correction, placement, trim duration, and transitions, but no audio or stabilization.
• Sensor rotations and Mod profiles are materialized per camera serial before a job is assembled.
• A Timeline may mix clips from different registered camera profiles on the same visual track.
• If a referenced logical multipart source changes, Studio fails closed and asks you to reload instead of rendering new physical members silently.

Save, reopen, export, and stream

• Save projects with the .vradical-timeline extension.
• Keep project media at stable paths, with companion and multipart files intact.
• Opening a project imports referenced photos and videos into the left media list.
• Timeline export uses the same camera route per clip and the selected global output cadence/codec.
• A global output cadence above a video's own source rate selects RIFE for that clip. The interpolation pair is reset at every edit boundary; photo clips are not interpolated.
• Flat 2D and 3D output are available only when every contributing camera route and source-eye size meet the selected projection contract.
• Timeline DeoVR streaming uses the same local HLS workflow as a video clip.
• Preview the frames around every cut and transition before a long master export.

Start a stream

1. 1

   Load a video or Timeline

   Photos cannot be streamed.

2. 2

   Set the range

   Optional In and Out points define the streamed section.

3. 3

   Open Stream to DeoVR

   Choose the headset button in the lower-right transport area.

4. 4

   Choose port and resolution

   Port 8080 and 4K are the defaults. Available sizes are 4K, 5.7K, 6K, and 8K. Resolutions above 4K require a very powerful GPU.

5. 5

   Review stabilization

   Use the same motion choices you previewed for the clip.

6. 6

   Start Streaming

   Wait through Buffering until Studio reports Streaming and displays the URL.

7. 7

   Open DeoVR

   On a reachable device, open http://<computer-ip>:<port>/deovr.

8. 8

   Stop when finished

   Choose Stop Streaming so the server closes and temporary segments are removed.

Streaming fixes

General

Authenticated updates

1. 1

   Open Updates

   In an updater-enabled customer build, choose Help > Check for Updates... or Settings > General > Updates.

2. 2

   Connect GitHub

   Choose Connect. In Connect VRadical Studio to GitHub, use Copy Code and Open GitHub, complete the device flow in your browser, then return to Studio.

3. 3

   Choose automatic checks

   Automatically check for updates is off by default. Enabling it shows a privacy consent before Studio contacts GitHub in the background.

4. 4

   Check

   Use Check Now or Retry. The panel shows GitHub status and Last check without blocking the rest of Studio.

5. 5

   Download

   Choose Download Update. Downloads are always user-initiated and the signed manifest is verified before installation is offered.

6. 6

   Install safely

   Choose Install Update.... Studio waits for preview/export/streaming/calibration work to reach a safe state, then installs and relaunches.

Create or edit a Mod profile

1. 1

   Open Mod Settings

   Open Settings, then choose Mod Settings.

2. 2

   Choose New or a profile

   Create a profile or select an existing camera serial from the list.

3. 3

   Enter the exact serial

   Camera serial is a semantic identity. Preserve all characters and boundary whitespace exactly as supplied by Studio.

4. 4

   Set both stabilization states

   Choose left/right cardinal sensor rotations for Stabilization ON and OFF.

5. 5

   Set eye order and focal distance

   Use Swap Left/Right Eyes and the profile focal-distance default only when the physical rig requires them.

6. 6

   Save and Apply

   Save Profile, then Apply/OK. A matching loaded camera updates immediately.

Where Studio keeps personal data

Packaged executable

Inspect a camera file

vradical-cli --json "/path/to/clip.360"

Export an 8K HEVC video

vradical-cli "/path/to/clip.360" \
  --export "/path/to/output.mp4" \
  --resolution 8K --codec hevc --depth 10 \
  --bitrate 120M --fps 0

Export a Timeline master

vradical-cli "/path/to/project.vradical-timeline" \
  --export "/path/to/timeline.mov" \
  --codec prores --resolution 7680x3840

Export a flat 2D video

vradical-cli "/path/to/clip.insv" \
  --export "/path/to/flat-video.mp4" \
  --output-projection flat-2d --resolution 3840x2160 \
  --codec hevc --fps 0

Export a supported DNG photo

vradical-cli "/path/to/photo.dng" \
  --export "/path/to/photo-output.dng" \
  --photo-format dng --resolution source

Start a local DeoVR stream

vradical-cli "/path/to/clip.360" \
  --deovr --port 8080 --resolution 4K

User-facing option groups

Collect useful diagnostics

1. 1

   Record version/build

   Open Settings and note the exact version and build.

2. 2

   Record the action

   State whether the failure happened during import, preview, calibration, Timeline, export, publish, or streaming.

3. 3

   Copy the exact error

   Use Show Error in the queue or copy the complete popup text.

4. 4

   Attach the latest session log

   Studio keeps the terminal output and also writes a bounded persistent log for every run. On macOS, open ~/Library/Application Support/VRadical/logs. On Windows, open %LOCALAPPDATA%\VRadical\logs. Choose the newest studio-* folder and include its .log files.

5. 5

   Review before sharing

   Support logs can contain media paths, calibration paths, camera serials, and non-secret processing settings. The logging layer does not add environment variables, OAuth codes, passwords, or tokens. Redact any remaining path or serial you do not want to disclose.

Before contacting support

• CHECKKeep the original camera file and all companion/multipart members.
• CHECKDo not transcode the failing source.
• CHECKNote the camera model, exact serial, Studio version/build, operating system, and GPU.
• CHECKInclude the exact route: preview, calibration, photo, Timeline, export, publish, or DeoVR.
• CHECKInclude the exact error and the smallest reproducible range.
• CHECKContact ChelouteVR via reddit u/cheloutevr or email cheloute.vr@gmail.com when the installed build instructs you to do so.

Global shortcuts

Timeline shortcuts

Final export checklist

• CHECKThe correct camera/profile appears in File Properties.
• CHECKCalibration is loaded and both eyes align in near, mid, and far regions.
• CHECKSensor rotations and eye order match the final SBS viewer convention.
• CHECKStabilization behaves correctly at the start, fastest motion, and end.
• CHECKYaw, pitch, and focal distance do not reveal unintended source borders.
• CHECKLUT and tonal controls look consistent in both eyes.
• CHECKAudio mode and monitoring volume are intentional.
• CHECKIn/Out points or Timeline duration are correct.
• CHECKProjection, aspect ratio, resolution, frame rate, codec, depth, bitrate, and metadata match the destination. Check whether a higher frame rate has selected RIFE.
• CHECKA short sample export has been checked in the target player/headset.
• CHECKThe final output folder has enough space and the queue is monitored through completion.

Fast glossary