Back to Documentation

Ambitura

v1.0

AI-powered scene detection, classification, and ambiance placement for post-production sound designers

Overview

Desktop app: scene cuts, INT/EXT and location-style labels, ambiance matching from your WAV library, export to Pro Tools, Resolve, Premiere, Nuendo, or AAF / EDL / CSV.

One pass

Markers at cuts, tags, library WAVs placed on alternating A/B tracks with crossfades where supported.

What it does

  • Scene cuts — visual + audio; sensitivity is chosen automatically from your material.
  • Classification — INT/EXT, DAY/NIGHT, location, shot type (with scores in the grid).
  • Noise filtering — shot-reverse-shot, fades, titles, credits handled.
  • Ambiance match from your folder-structured library.
  • Export — live push or file export as above.
  • Local learning from edits you make in-session.

System Requirements

WindowsmacOS
OSWindows 10 / 11macOS 12.6 (Monterey) or later
Architecturex64Intel (x86_64) and Apple Silicon (arm64)
RAM8 GB minimum, 16 GB recommended8 GB minimum, 16 GB recommended
GPUDedicated GPU recommended; runs on integrated graphics or CPU if neededRuns on built-in hardware acceleration where available
Disk~3 GB~3 GB
OtherEverything Ambitura needs is bundled in the installer — no separate downloadsAll required components are installed automatically by the setup script

For DAW Export (Optional)

  • Pro Tools 2022.12 or newer — required for one-click track creation and clip placement.
  • DaVinci Resolve — Studio for live push, Free edition via EDL import.
  • Premiere Pro 2025 or newer — install the Ambitura Link plugin from the website.
  • • Anything else needed for export is set up automatically the first time you use it.

Performance mode

Ambitura picks the best processing mode for your hardware automatically — higher quality on powerful machines, faster on laptops. You can override this any time in Preferences > Performance.

Installation & Activation

Windows

  1. 1

    Download the Windows archive

    Grab the .rar or .zip from your account page or the product page (for example Ambitura-1.0.0.rar), extract it, then run the installer inside.

  2. 2

    Run the installer

    Everything Ambitura needs is bundled — no separate downloads or setup steps.

  3. 3

    Launch & sign in

    Sign in with the same email and password as your Paraflex account. Activation ties this computer to your subscription.

macOS

  1. 1

    Download the installer package

    Download the .pkg installer (for example Ambitura-1.0.0.pkg) from your account or the product page and run it. Follow the prompts to install into Applications.

  2. 2

    First open

    If Gatekeeper blocks the app, right-click Ambitura.app and choose Open. Intel and Apple Silicon are supported.

  3. 3

    Sign in

    Use your Paraflex account email and password — same as the website.

Machines per plan

Signed-in activation. Active installs allowed at once:

Solo

1

machine

Studio

3

machines

Enterprise

5

machines (extra seats available)

Tip

Manage devices from paraflexaudio.com/account.

First Launch

First launch walks you through setup. Typical order:

  1. 1

    Local models (offline mode)

    The app downloads and installs the bundled local AI stack (including the lightweight models used for on-device analysis — e.g. Gemma-based components where applicable). Stay online until the resolver / onboarding step finishes; progress is shown there.

  2. 2

    Hardware check

    Quick status for GPU/CPU paths. Warnings are informational — analysis can still run.

  3. 3

    Ambiance library

    Add folder roots with INT/DAY/Location/… layout, or skip and use Library > Manage Libraries later.

Offline

After sign-in, you can work offline for a while; reconnect before the grace period ends so the session stays valid.

The Interface

Anatomy of the Window

1 · Top Bar

Menus: File, Library, Export, View, Help. Right side: account and status (credits, readiness).

2 · Video Viewport

Frame-accurate playback. Drag a file in or use File > Open. Below: timecode, transport, volume, scrubber.

3 · Marker Grid

Editable rows: #, Timecode, INT/EXT, DAY/NIGHT, Location, Shot Type, Notes, Confidence. Click a cell to edit. Use the Confidence column for scores — row colours are not a confidence legend.

4 · Sidebar

Collapsible panel with three tabs:

  • Quick Tags — one-click INT/EXT, DAY/NIGHT, and a list of saved location presets.
  • Ambiance — currently matched WAV for the selected scene with preview, alternatives, and "lock" controls.
  • Filters — show/hide markers by location, confidence threshold, or tag.

5 · Status Bar

Bottom row shows analysis progress, total scenes detected, ambiance coverage percentage, and export queue status.

Views & Themes

  • Detailed view — every marker as its own row.
  • Summarized view — markers grouped by location, with collapsible sections.
  • Search bar — filter by name, location, or tag (top-right of the marker grid).
  • Dark / Light theme — switch from View > Theme or in Preferences.
  • Fullscreen viewport — from the View menu or the shortcut listed under Keyboard Shortcuts below.

Importing Video

Supported Formats

Anything FFmpeg can read. Common containers: MP4, MOV, MKV, AVI, M4V, WEBM, MXF. Common codecs: H.264, H.265/HEVC, ProRes, DNxHD/HR, VP9, AV1, MPEG-2.

Frame rate

Auto-detected; override from the rate control above the grid if needed so timecode matches your session.

Loading a Video

  1. 1

    Drag & drop

    Drop a file on the window or use File > Open Video.

  2. 2

    Set the start timecode

    Click the timecode field above the viewport (default 01:00:00:00) to match your session start.

  3. 3

    Frame rate, profile, genre

    Sensitivity is automatic. Set profile/genre if you want (see Analysis).

  4. 4

    Optional: Video Concept hint

    Type a short phrase describing the content (e.g. "suburban home, hospital, small-town streets"). The AI weights its location predictions toward what you describe and against what you don't.

Batch

File > Batch Analyze — queue files; same settings per item; separate sessions when done.

Scene Detection & Analysis

Running an analysis

Analyze (toolbar or menu — default shortcut in Keyboard Shortcuts below). You get a labelled scene list. During the run:

  • • Scene cuts; filters noisy patterns (angles, fades, titles, credits).
  • • INT/EXT, DAY/NIGHT, location, shot type.
  • • Neighbour smoothing so locations don’t flicker.
  • • Confidence on markers; optional review stops if Review Mode is on.
  • • Tolerant decode — one bad frame shouldn’t stop the job.

Settings

Sensitivity

Not a manual control — the app sets cut aggressiveness from the video and context.

Profile

Built-in presets (e.g. Narrative, Documentary, Commercial, Music Video) or your own under Preferences > Detection.

Genre

Film, TV, Documentary, Music Video, Animation, Commercial — tunes classification. Pick the closest match.

Review Mode

When on, uncertain boundaries can open the frame comparison dialog. Off = unattended pass.

While it runs

  • • Progress and cancel.
  • • Less aggressive CPU/GPU use when a DAW is detected.
  • • Cached result beside the file — reopen may skip redoing work.
  • • Notification when finished (if enabled).

Reviewing Markers

The Marker Grid

Every detected scene becomes a marker. The grid is fully editable — click any cell to change it.

  • Seek — double-click a row or confirm selection (see Keyboard Shortcuts).
  • Move marker to playhead — shortcut in Keyboard Shortcuts.
  • Add marker at playhead — menu or shortcut; new markers feed local learning.
  • Rename — context menu or shortcut.
  • Copy timecode — shortcut below.
  • Delete — selection + Delete/Backspace.
  • Undo / Redo — standard edit shortcuts.

Frame comparison

With Review Mode on, uncertain boundaries can open a dialog: last frame before the cut vs first frame after. You choose:

Same scene

No real acoustic/scene change — merge or treat as one space.

Different scene

Confirm a boundary between two scenes.

Skip

Decide later; no immediate training nudge.

Tip

Marker stepping and frame-step shortcuts are listed under Keyboard Shortcuts (defaults are for Windows; macOS often uses ⌘ instead of Ctrl).

Locations & Classification

What Gets Classified

FieldValues
INT/EXTInterior, Exterior
DAY/NIGHTDay, Night, Dawn, Dusk
LocationA broad taxonomy: City Street, Living Room, Forest, Hospital, Office, Bedroom, Kitchen, Restaurant, Car Interior, Beach, Subway, Park, Warehouse, Hotel Lobby, Classroom, Stadium, and many more.
Shot TypeClose-up, Medium, Wide, Establishing, Two-Shot, Over-the-Shoulder, POV, Aerial.
SpecialProduction logos, end credits, and title cards are detected and tagged separately so they don't pollute your ambiance pass.

Editing a Location

Edit the location cell — suggestions appear as you type (with scores). Pick one or enter a custom name; custom entries are remembered locally.

Alternatives

The location picker lists suggested alternatives; choosing one is faster than typing and updates local learning.

Quick Tags & Presets

The sidebar Quick Tags panel lets you batch-tag selected markers with one click:

  • INT / EXT / DAY / NIGHT — instant tags. Multi-select rows then click.
  • Location presets — saved locations you use often. Add new ones from Preferences > Presets.

Cloud AI

Optional cloud passes for heavier labelling and matching. Local analysis stays unlimited. Pick a pass in the app before you run.

Cloud passIncludes
ClassifyINT/EXT, DAY/NIGHT, shot type, scene boundaries
Classify + LocateAll of Classify, plus location category and location name
Full Ambiance DesignAll of Classify + Locate, plus automatic ambiance matching from your catalog

The app shows credit use before you confirm a cloud run. Failed or unusable scenes are credited back when the platform applies adjustments.

Subscriptions (website names)

Cloud credits and machine seats match the pricing page: Solo, Studio, Enterprise.

Solo

100

credits / month

Studio

750

credits / month

Enterprise

1500

credits / month

Top-ups and extra machine seats: pricing page.

Ambiance Library

Folder Structure

Ambitura matches scenes to WAV files using a strict folder hierarchy. Organize your library this way and matching becomes automatic:

MyAmbianceLibrary/
├── INT/
│   ├── DAY/
│   │   ├── Living Room/
│   │   │   ├── living_room_01_st.wav   (stereo)
│   │   │   └── living_room_02_mn.wav   (mono)
│   │   ├── Office/
│   │   └── Restaurant/
│   └── NIGHT/
│       ├── Bedroom/
│       └── Bar/
└── EXT/
    ├── DAY/
    │   ├── City Street/
    │   ├── Forest/
    │   └── Beach/
    └── NIGHT/
        └── City Street/

Indexing

First-time scan walks your roots and builds a local index (filenames, layout, duration). Later scans only pick up changes. Everything stays on your machine.

  • • Stereo/mono and common naming patterns are recognised.
  • • Coverage view shows thin vs well-covered locations.
  • • Re-scan after you add files.

How scenes get a WAV

Matching prefers the closest folder for INT/EXT, time of day, and location; then broader fallbacks inside your library if needed. Per scene you can still pick or lock a file in the UI.

Library Manager

Library > Manage Libraries

  • • Add/remove multiple root folders.
  • • Re-scan.
  • • Coverage overview.
  • • Lock a WAV to a scene.
  • • Preview matches.

DAW Integration & Export

Export Targets

TargetMethodWhat you get
Pro ToolsLive pushTracks created, clips imported at timecode, crossfades applied — one click.
Pro ToolsAAFStandard session import via File > Import > Session Data.
DaVinci ResolveScripted push (Studio) / EDL (Free)Direct marker push to a running Resolve session, or EDL import.
Premiere ProAmbitura Link (UXP plugin)Live marker and ambiance push from Premiere's Window menu.
NuendoEDL (CMX3600)Coloured cycle markers for the Fill Loop ambiance workflow.
Any DAWCSVStandard comma-separated marker list with timecodes and labels.

Pro Tools Ambiance Workflow

The flagship integration creates a complete, edit-ready ambiance session in Pro Tools:

  1. 1. Open Pro Tools (2022.12 or newer) and make sure live integration is turned on in its setup menu.
  2. 2. Open or create a session at the matching frame rate and start timecode.
  3. 3. In Ambitura, choose Export > Push to Pro Tools.
  4. 4. Ambitura creates two stereo tracks (AMB-A and AMB-B) and lays clips alternately between them, so neighbouring scenes never share a track.
  5. 5. Crossfades are applied automatically at every scene boundary, plus loop crossfades for scenes longer than the source ambiance.
  6. 6. Each clip carries a source-in offset handle so editors can pull audio earlier without re-importing.

Why two alternating tracks

Because clips never overlap on the same track, you can edit, slip, or trim any single ambiance without dragging neighbours along — and the crossfades stay clean.

Premiere Pro (Ambitura Link)

Ambitura ships with the Ambitura Link plugin for Premiere Pro 2025 and newer.

  1. 1. Run the included Ambitura Link installer (under Help > Install Premiere Plugin) and follow the on-screen setup steps.
  2. 2. Once loaded, the plugin connects to a running Ambitura instance on the same machine.
  3. 3. Use the panel inside Premiere to push markers and ambiance from your current Ambitura session.

One-time setup is required

Premiere's plugin system needs a small amount of first-time configuration outside Premiere itself. The installer walks you through it; allow a few minutes the first time.

DaVinci Resolve, Nuendo, AAF, EDL, CSV

  • Resolve Studio — choose Export > Push to Resolve; markers and clips are sent through Resolve's scripting API.
  • Resolve Free — choose Export > EDL, then in Resolve Timeline > Import > EDL.
  • Nuendo — choose Export > EDL (Nuendo) for coloured cycle markers; import into a Nuendo project for Fill Loop.
  • AAF — choose Export > AAF; in Pro Tools, File > Import > Session Data and pick the AAF.
  • CSV — choose Export > CSV; opens in any spreadsheet for review or re-import elsewhere.

Preferences

Edit > Preferences (shortcut in Keyboard Shortcuts). Changes save automatically.

General

Theme, language, autosave, default frame rate and start timecode.

Detection

Profiles, optional fine-tuning, Review Mode default. Cut sensitivity is automatic.

Performance

Quality vs. speed mode, hardware acceleration on/off, reset adaptive learning.

Library & Export

Library roots, default export format, marker prefix, default DAW for one-click export.

Cloud

Default cloud pass.

Privacy

Anonymous analytics on/off, crash reporting, automatic update checks.

Presets

Quick-tag editor, location preset list, custom genre tuning.

Adaptive Learning

Ambitura adapts to the kind of work you do. Every correction you make sharpens its results on similar material next time. Adaptation stays on your machine — nothing about your projects is shared with us or anyone else.

It learns your cuts

Same-scene / different-scene choices in frame review refine cut behaviour for similar material.

It learns your locations

When you correct a location label, Ambitura remembers what that kind of scene looks like to you, and leans toward your label on similar scenes in future projects.

It corrects its own habits

If Ambitura keeps mistaking one location for another, it notices the pattern and stops doing it.

Tip

The fastest way to "train" Ambitura is just to use it. A few projects in, the accuracy on your typical material noticeably improves. You can reset everything Ambitura has learned at any time from Preferences > Performance > Reset Learning.

Keyboard Shortcuts

Shipped defaults use Windows-style Ctrl below. On macOS, usually replaces Ctrl. Use Help or Ctrl+/ in the app for the live list if you remap keys.

Playback & Transport

SpacePlay / Pause
/ Step one frame back / forward
Shift+← / Shift+→Step through key frames only
/ Previous / next marker
Shift+↑ / Shift+↓Previous / next cut (skip non-cut markers)
MMute / unmute
F11Toggle fullscreen viewport

Markers

Ctrl+MAdd marker at playhead
EnterSeek to selected marker
Ctrl+TMove selected marker to playhead
F2Rename selected scene
Ctrl+Shift+CCopy timecode to clipboard
Delete / BackspaceDelete selected marker(s)
Ctrl+ASelect all markers
Ctrl+Shift+ADeselect all

File, Edit & View

Ctrl+OOpen video
Ctrl+RRun analysis
Ctrl+EExport menu
Ctrl+ZUndo
Ctrl+Y / Ctrl+Shift+ZRedo
Ctrl+,Open Preferences
Ctrl+BToggle sidebar
Ctrl+/Show full keyboard shortcuts dialog

Troubleshooting

Health report shows "running on CPU"

Hardware acceleration isn't available on this machine. Update your graphics drivers and try again. Analysis still runs without it — just slower (typically two to four times longer).

"Video playback unavailable"

Reinstall the latest version of Ambitura. The installer ships with everything needed to play your video.

"Video tools not found"

Reinstall the latest version of Ambitura — the missing component is bundled and reinstalls automatically.

"Pro Tools connection failed"

Open Pro Tools (2022.12 or newer) with a session, make sure live integration is enabled in its setup menu, then try the push again.

Old classifications keep coming back

Ambitura caches results next to your video so re-opening the same file is instant. To start fresh, run the analysis again from the analyze menu — it will overwrite the cached result.

"Export tools missing" (AAF or Pro Tools push)

Reinstall Ambitura — the export tools are bundled and reinstall automatically. Scene detection still works without them; only AAF and live Pro Tools push need them.

Analysis slows down my DAW

Ambitura eases off automatically when a DAW is running. For an extra drop, switch Preferences > Performance from Quality to Speed.

Cloud run failed but credits were taken

Failed segments are usually re-credited automatically. If not, contact support with any reference the app shows for that run.

When in doubt, reinstall

Ambitura's installer ships with everything it needs to run. If something looks broken after a partial update or a system change, the fastest fix is to reinstall the latest version — your settings, library paths, and what Ambitura has learned are preserved.

FAQ

Do I need an internet connection to use Ambitura?

Local analysis is fully offline. Cloud features need a connection. Sign-in needs internet; after that you can work offline for a limited grace period before signing in again.

Where does Ambitura store my data?

Your settings, presets, and what Ambitura has learned about your style live in your standard user data folder for the app. Each project's analysis is saved next to the video file, so re-opening the same video is instant.

Can I run multiple Ambitura instances on different machines?

Yes — Solo allows 1 active machine, Studio 3, Enterprise 5 (with the option to add extra seats). Deactivate old machines from your account page when retiring or reformatting hardware.

Does Ambitura upload my video for analysis?

Local: media stays on disk. Cloud: only runs when you choose a cloud pass; the app sends what it needs for that pass (not a full video upload). Details appear in the cloud confirmation step.

Do credits roll over month to month?

Subscription credits reset at the start of each billing cycle. Top-up credits stack on top of your subscription allowance and expire 3 months after purchase.

Can I share my learning data with a colleague?

Not directly — what Ambitura learns is stored locally on your machine. A shared "studio profile" feature for Enterprise plans is on the roadmap. In the meantime, you can export and import detection profiles from Preferences.

What happens to my session if Ambitura crashes mid-analysis?

Progress is auto-saved every few seconds. Re-open the video after restarting and Ambitura resumes from where it left off, or offers to start fresh.