Previs Pro Wiki

Written and maintained by Ian Lynch Smith, co-founder of Previs Pro (Brooklyn, NY). Previously co-founded Freeverse, a Mac and iOS studio. · Kept current with the shipping app ().

Previs Pro is a previsualisation tool for filmmakers, allowing you to build virtual sets, place characters, find camera angles, and assemble editorial timelines — all on iPad, iPhone, or Mac.

Unlike traditional storyboarding software that acts as a 2D drawing canvas, Previs Pro is a 3D simulation that obeys real-world optics.

Trying to figure out whether Previs Pro is the right tool for you? See our Previs Tool Comparison 2026 — a side-by-side look at nine previs and storyboarding tools indie filmmakers are actually using this year, with every claim linked to its source.

Used by employees of: Lucasfilm, Marvel, BBC, Max, and others, and students and professors at USC, NYU Tisch, UCLA Film School, and thousands of independent filmmakers.

Platforms

Available on the App Store.

Resources

Core Workflow

  1. Build — Create the environment.
  2. Block — Place characters and props.
  3. Shoot — Find the angle using virtual cameras.
  4. Iterate — View your previs in a sequential audio-visual timeline. Get it right before you get on set. Fix it in Pre.

Common Questions

Quick jumps to the answers people ask about most. Each link goes to the topical section where the full answer lives.

Subscriptions, payments, refunds

Devices & sign-in

Characters, props and 3D import

Crashes & updates

Working in the scene

Privacy & AI

Getting Started

Creating a New Project

From the Projects screen, tap the + button in the upper right. This gives you two options:

To open an existing .previs project file (one you've shared or received), use the Files app drag-and-drop onto the Projects screen, or double-click the file in Finder on Mac.

Managing Existing Projects (Select Mode)

To share, duplicate, or delete projects, use Select mode from the Projects screen.

  1. Tap Select in the top bar.
  2. Tap one or more projects in the list — each tapped project highlights as selected.
  3. A row of action icons appears at the bottom of the screen: Share, Duplicate, and Trash. Tap the icon for the action you want; it applies to every selected project.
  4. Tap Done in the top bar to leave Select mode without taking an action.

There is no swipe-to-delete or right-click context menu on the project list — the Select-mode flow is the only way to bulk-share, duplicate, or delete projects.

Starting from a Script

If you have a screenplay in Final Draft, Fountain, OSF, Fade In, Celtx, or PDF format, Previs Pro can build the project for you — scenes, cast, dialogue, action, and transitions all populate automatically. From the Projects screen, tap the + button, then tap Start from Screenplay and pick your script file.

For the full list of supported formats, what gets extracted, and how to bring in a revised version of the same script later, see the Screenplay section.

Import from Project

You can copy scenes, shots, characters, props, and other assets from one project into another using Import from Project. Open it from the Import button in the upper-right toolbar of the Scene Manager.

  1. Tap Import from Project. A project picker shows all your projects with scene/shot/asset counts.
  2. Select the source project.
  3. Choose what to import — you can pick individual items from each category:
    • Scenes — Import full scenes with all shots, or just the first shot, poster shot, or a specific selection.
    • Characters — Library characters and custom characters (including AI-generated ActorGen models).
    • Props — Library props, blocks, and custom props (including AI-generated PropGen models).
    • Images, Audio & Video — Media assets attached to imported shots.
  4. Duplicate characters (same name already in your project) are detected automatically — you can overwrite or keep both.

A summary dialog shows exactly what was imported when the operation completes.

Tip: Import from Project is great for reusing characters, set dressing, or entire scenes across episodes or related projects without rebuilding from scratch.

The Workspace

The workspace is built around three areas: the canvas (center), the shot list (right), and object menus that appear contextually.

Canvas

The central area of the app displays the canvas. The 3D/2D toggle switches between a top-down 2D or fully 3D editing mode. Additionally, the camera can be edited via CAM mode while AR provides a unique view-only presentation of your scene in the real world by way of Augmented Reality. And finally, Animatics mode transforms the canvas into a keyframe animation editor allowing you to view simple movements in action.

Canvas UI elements at a glance

Every persistent control on the canvas, where it lives, and how it's referenced internally. If you're looking for "where do I find X?", check here first.

ElementLocationTarget ID
BackTop toolbar, far left (arrow)canvasEditor.backButton
Undo / RedoTop toolbar, left of titlecanvasEditor.undoButton / canvasEditor.redoButton
Scene TitleTop toolbar, centercanvasEditor.titleBar
Director View (Timeline)Top toolbar, right side (clapperboard icon)canvasEditor.directorViewButton
Help (Previs Assist)Top toolbar, right side (? icon)canvasEditor.helpButton
Scene optionsTop toolbar, far right (three-dot menu)canvasEditor.kebabMenu
Compass / OrientationTop-left of canvascanvasEditor.compass
Zoom ControlsTop-left of canvas (− / +)canvasEditor.zoomControls
Animatic ModeTop-right of canvas (running-figure icon)canvasEditor.animaticsButton
AR ModeTop-right of canvas, next to Animatic icon (iOS / iPadOS only, requires LiDAR)canvasEditor.arButton
Add + Import (pencil)Bottom-right toggle row on macOS; top-right toolbar on iPad / iPhone. Opens the Add Objects tray.canvasEditor.editModeToggle
CAM toggleBottom-right toggle rowcanvasEditor.camToggle
2D / 3D toggleBottom-right toggle rowcanvasEditor.viewModeToggle
3D RotationBottom-left of canvas (globe icon, 3D mode only)canvasEditor.rotationToggle
Picture-in-Picture (PIP)Top-left of canvas when active — shows the selected camera's framing as a floating windowcanvasEditor.pip
Shot ListRight sidebar (vertical strip of thumbnails)canvasEditor.shotList
Selected ShotRight sidebar, red bordercanvasEditor.shotList.selected
Shot ID & Focal LengthRight sidebar, under each thumbnail (e.g. "B — FS / SL — 35 mm")canvasEditor.shotList.label
Shot OptionsRight sidebar, ⓘ icon next to each thumbnailcanvasEditor.shotList.options
Add New ShotRight sidebar, red + at the bottomcanvasEditor.addShotButton

Tapping the pencil button opens the Add Objects tray at the bottom-center, where the six object types live:

Add Objects tray buttonTarget ID
CameracanvasEditor.addObjects.camera
CharactercanvasEditor.addObjects.character
PropcanvasEditor.addObjects.prop
WallcanvasEditor.addObjects.wall
LightcanvasEditor.addObjects.light
ImportcanvasEditor.addObjects.import

3D Canvas

This is the primary working view. It shows the scene in full 3D allowing you to place characters, build sets, and compose shots.

Object Controls — when an object is selected, a row of buttons appears in the lower-left of the canvas:

Orbit / Movie Mode — available only in 3D Canvas. Enables cinematic camera paths around the scene.

2D Canvas (Overhead View)

A top-down birds-eye view of the scene. Useful for blocking actor positions, planning movement paths, and seeing the spatial layout. In Animatic mode, object movement paths appear as dotted trails with Bezier curve nodes.

Draw Mode — contains two tabs accessed via the pencil tool:

CAM Mode (Camera View)

Shows exactly what the active camera sees — the Director’s Viewfinder. This is the view used for shot composition and is what gets captured as the shot thumbnail. Tap the CAM button to enter. Within CAM mode you can actively move the camera and frame your shot.

Focal Length Slider — Adjustable slider that snaps to 17 standard prime focal lengths from wide to telephoto: 10, 15, 20, 24, 28, 32, 35, 40, 50, 65, 70, 85, 100, 105, 135, 200, 270 mm. Current focal length and prime lens name are displayed.

Focus/Depth of Field Controls:

Composition Guides — tap the composition button to toggle overlays:

CAM view UI elements:

ElementLocationTarget ID
Grid Lines toggleTop-left cornercanvasCam.gridToggle
Title bar (Scene / Shot / Focal Length)Top center, e.g. "A — FS / Zoom in / SL — 35 mm"canvasCam.titleBar
HelpTop-right (? icon)canvasCam.helpButton
DoneTop-right, exits CAM modecanvasCam.doneButton
Composition guide pickerLeft edge, vertical icon stripcanvasCam.compositionPicker
Adjust Lens (focal length slider)Bottom, with the prime-lens dot strip and film-strip indicatorcanvasCam.focalSlider
Adjust Focus (OFF / AF / MF)Right edge, near the bottomcanvasCam.focusMode
Aperture (f-stop) sliderRight edge, above focus mode (Manual focus only)canvasCam.apertureSlider
Focus distance sliderRight edge (Manual focus only)canvasCam.focusDistanceSlider

CAM gestures:

Animatics Mode

Animatic Mode transforms the canvas into a keyframe animation editor. The vertical Shot List is replaced by a horizontal continuing shot list, and animation controls overlay the canvas. Available in both 2D and 3D views. See the Animatics section for full details.

Animatics Canvas UI:

AR Mode

In AR Mode, the canvas is replaced by the device camera feed with virtual objects overlaid in the real world. Supports both life-size and tabletop scaling, with plane detection, scene placement, and frame selection. See Environments > AR Mode for the full walkthrough.

Gizmos

Tapping an object in any canvas reveals the Gizmo for moving, rotating, or scaling along X, Y, and Z axes. Switch modes with keyboard shortcuts: W Move, E Rotate, R Scale.

Selected-object handles (3D canvas):

HandleWhat it doesTarget ID
Rotate & Move (red dot in red circle)Appears at the object's base. Drag the dot to translate on the XZ plane; drag along the circle to rotate around Y.gizmo.moveRotate
Adjust Height (red upward triangle)Appears at the object's center mass. Drag vertically to move along Y.gizmo.height
Character Options MenuHorizontal action bar that appears above a selected character: Edit, Pose, Expression, Look at, Duplicate, Delete, and more behind the overflow.character.optionsMenu

Handle types vary by context:

Object Context Menus

Open the horizontal context menu on any object:

Available actions depend on the object type:

What "Lock" actually does

Lock freezes an object’s transform — it can’t be moved, rotated, or scaled, and the gizmo won’t engage on it. Locked objects can still be selected (so you can re-open the context menu to unlock them) and the canvas can still drag past them to pan. If you’re bumping the lock on a prop you wish you couldn’t even click, Hide it instead — Hide removes the object from the canvas surface until you Unhide.

Multi-Selection & Grouping

Select multiple objects to manipulate them together. The multi-selection overlay provides:

Static Image & Video Overlays

Shots can display a static image or video instead of the live 3D render:

Paste Clipboard

After copying objects, a clipboard control appears showing the item count with Paste and Clear buttons.

The Shot List (Right Sidebar)

The "spine" of your production. A vertical stack of thumbnails on the right edge representing the linear progression of your scene.

Object Menus & Info Panels

When you select an object in the canvas (3D, 2D, or Camera view), a horizontal action menu appears with context-specific options. Depending on the object type, this may include movement, rotation, duplication, deletion, and an Info button that opens a dedicated dialog with detailed properties (e.g., Lens Focal Length for cameras, Light Intensity for lights, etc.).

Environments

Walls & Set Building

Build your environment using walls, floors, doors, and windows. Access these via the pencil tool (object placement mode), which lets you add objects to the scene:

Props & Set Dressing

The built-in library includes hundreds of parametric objects (furniture, vehicles, street elements).

Props & Sets

Props exist per-shot — moving a prop in one shot does not affect other shots. To reuse an entire environment setup across scenes, you can save and load sets from the new scene dialog. This lets you define a room layout once and apply it to multiple scenes.

Duplicate vs. shared props

When you Duplicate a prop, the copy is an independent object. Resizing, rotating, or moving the duplicate doesn’t affect the original or any other copies. This is what most people want when they place multiple chairs around a table.

When you use Save Set and load that set into another scene, the loaded objects are also independent — edits in scene B don’t echo back to scene A.

The case where edits do propagate globally is the cast: characters are global, so editing the cast member in one shot changes them everywhere. See the Cast List for the workaround (Duplicate Character creates an independent cast entry, e.g. "Bond — Suit" vs. "Bond — Tux").

Per-Shot Object Limits

Object TypeMax per Shot
Props100
Characters50
Walls100
Lights10
CamerasMultiple (one active at a time)
Doodle markups100

These limits apply per shot, not per scene. Imported 3D models count toward the props limit and use more memory than built-in library props.

AI Prop Generation

If the library lacks a specific item, use the Prop Gen tool. Type a text prompt (e.g., "1950s toaster") and a unique 3D model is generated via AI. Costs 15 credits. See AI 3D Generation.

3D Model Import

Import custom .glTF / .glb models from third-party tools (Blender, SketchFab, Polycam, etc.).

Augmented Reality (AR) Mode

Use your physical location as the set. Requires an AR-capable iPhone or iPad with LiDAR. Not available on macOS.

  1. Tap the AR icon (top-right of canvas, next to the Animatic Mode running-figure icon).
  2. Scan: Point the device at the floor and move slowly to detect the plane.
  3. Anchor: Tap the grid to lock the virtual world to the real world.
  4. Block: Place virtual characters into your real environment.
  5. Walk: Physically walk around the virtual actors holding the device like a camera viewfinder.

AR mode supports both life-size and tabletop scaling, plus PoseCap and Expression Capture while in AR.

AR view UI elements:

ElementLocationTarget ID
BackTop-left (arrow). Exits AR mode.arView.backButton
Shot labelTop center (e.g. "3A")arView.shotLabel
Help (Previs Assist)Top-right (? icon)arView.helpButton
Reset ARTop-right (eye icon). Re-scans the plane and re-anchors the scene.arView.resetButton
OptionsTop-right (gear icon)arView.optionsButton
Add ShotBottom-left (+ icon). Captures the current AR framing as a new shot.arView.addShotButton
Record VideoBottom-left, next to Add Shot (red record icon). Captures live AR video.arView.recordButton
Adjust Lens (focal length slider)Bottom center, with film-strip indicator (same control as CAM view)arView.focalSlider
Toy Size / 1:1 toggleBottom-right (person icon). Switches between tabletop and life-size scaling.arView.scaleToggle
Shot list stripRight edge (collapsed shot thumbnails)arView.shotList

3D Model Import

Import custom 3D assets from external scanning or modeling tools:

  1. Scan a room using a 3D scanning app (e.g., Polycam, RealityKit) or create a model in Blender, Cinema 4D, Maya, etc.
  2. Export as .glTF or .glb.
  3. In Previs Pro, Import > 3D Model.
  4. Use the scale tool to ensure the model is 1:1 for accurate lens simulation.

Supported formats

Previs Pro accepts glTF 2.0 — either the single-file .glb (binary) or the multi-file .gltf + textures bundle. We chose glTF because it is the open, modern, widely-supported transport format for the web and AR ecosystem.

If your source tool only exports .fbx, .obj, .dae, .skp (SketchUp), .3ds, or .usdz, convert to glTF first. The most reliable path is to open the file in Blender (free) and use File > Export > glTF 2.0 (.glb). Online converters like aspose.app/3d work for simple geometry but can drop textures and materials on complex models.

Tips for clean imports

If a model imports as solid gray, the materials didn’t survive the export. Re-export with embedded textures, or use the glb (binary) variant which bundles them automatically.

See also: Props & Images articles and Walls articles on the support site.

Characters

The Cast List

Characters are global assets. Modify a character in the Cast List and they update across all scenes and shots. Two ways to add characters:

Tip: Because character edits propagate globally, use Duplicate Character when you need the same person in different outfits (e.g., "Bond-Suit" and "Bond-Tux"). Each duplicate is independent in the Cast List.

Posing

PoseCap (AI Motion Capture)

Use the device camera to capture body poses and apply them to 3D characters instantly. Requires the rear-facing camera on an iPhone or iPad (front camera and Mac cameras are not supported).

  1. Select a character.
  2. Tap Pose > PoseCap.
  3. Point the rear camera at a person, a photo, or even an image on a screen.
  4. Use the 5-second timer or tap the capture button on the right side.
  5. The app tracks the skeleton via ARKit and applies the pose to the 3D character.

Limitations: Apple's ARKit body tracking does not currently support hand poses or head/face orientation — only major body joints are captured.

Custom characters: PoseCap captures to built-in characters first. To apply a captured pose to an imported or ActorGen character, save the pose as a custom pose, then select it from the Custom section in that character's Pose menu.

Works in both standard and AR modes.

Importing a Custom Rigged Character

Yes — Previs Pro accepts custom rigged humanoid characters as .glb files (glTF 2.0 binary) with a standard humanoid skeleton (hips, spine, two arms, two legs, head, neck). Export from Blender, Mixamo, ReadyPlayerMe, or any tool that produces glTF; .fbx is not accepted — convert FBX to GLB in Blender first. Non-humanoid rigs (creatures, four-legged animals, multi-armed designs) land in your project as static meshes — the geometry is there, but the Pose menu's body-part controls won't apply.

The simpler path for most "I want my own character" use cases is ActorGen: type a description, the AI generates and auto-rigs a humanoid model that drops straight into your Cast List. No external tool, no rigging step.

If you're stuck on rigged-character import: the most reliable answer in 2026 is to use ActorGen and describe the character you want. We removed the older third-party avatar-builder integration; ActorGen is the in-app replacement and includes the rigging step for free while we tune quality. For very specific likenesses or non-humanoid designs, email hello@previspro.com — we’d like to see what you’re trying to do.

ActorGen (AI Character Generation)

ActorGen lets you create custom 3D characters from a text description, powered by a 3rd-party AI service. Characters are automatically rigged with a skeleton for posing and animation. Costs 26 credits (as of 5/8/26 ActorGen is temporarily free while we improve the results — once the quality is where we want it, the cost will return in line with our expenses, like all the external AI generation tools).

  1. Add a character > select the ActorGen option.
  2. Enter a text description of the character (e.g., "tall woman in a red dress, professional, 30s").
  3. A preview image generates first, with the option to Regen if needed.
  4. The system generates the full 3D model, then automatically rigs it with a skeleton.
  5. Generation stages: Submitting → Queueing → Generating → Rigging → Downloading (~120 seconds total).
Tip: The system automatically appends "full body, feet flat, T-pose" to your prompt for consistent skeleton alignment. Generated characters are ready for posing immediately.

ActorGen characters are stored as custom characters in the project's Cast List and behave identically to imported models — they can be posed, placed in any scene, and animated in animatics.

See also: Characters articles on the support site.

Camera & Cinematography

Previs Pro simulates physical cameras, not just 3D viewports.

Optics & Sensors

Sensor Sizes

SensorNotes
Full Frame (35mm)Default. Standard cinema reference.
Super 35Most common cinema format.
Canon APS-C1.6x crop factor.
Nikon APS-C1.5x crop factor.
Micro 4/32x crop factor.
Alexa LF Open GateLarge format cinema.
iPhone 11Mobile camera simulation.
Standard 16mmDocumentary / indie format.
Super 16mmWider 16mm variant.
2/3" VideoBroadcast video format.

Focal Length

Anamorphic Lenses

Anamorphic squeeze ratio support for cinematic widescreen looks (added November 2025).

Depth of Field

Full DOF controls are available in the CAM Mode: Off/Auto/Manual toggle, aperture (f-stop) slider, focus distance slider, and tap-to-focus with visual focus point indicator. See the CAM Mode section for details.

See also: Camera & Lights articles on the support site.

Director's View (CAM Mode)

The Director’s View is the CAM Mode — see the full documentation under The Workspace for all controls including Navigation/Edit modes, focal length slider, DOF controls, composition guides, and Monitor Mode.

Multiple Cameras Per Shot

A single shot can hold multiple cameras, but only one is active (rendering) at a time. This is useful when you want to keep several angle setups inside one shot — e.g., a master, an OTS, and a close-up — and switch between them without duplicating the shot.

  1. Add a second camera to the shot the same way you add the first: pencil tool → Add Objects tray → Camera.
  2. Position and frame each camera independently.
  3. To switch which camera renders the shot, open its context menu (right-click on Mac, or tap the camera on iPad/iPhone) and pick Enable. The previously active camera is automatically disabled.

If you want different camera angles to actually cut across the timeline (rather than just stage alternates inside one shot), duplicate the shot per angle and pick a different active camera in each — that's the standard multicam cutting workflow.

Lighting & Atmosphere

Light Types

TypeDescriptionExamples
LanternOmni-directional point lightsDefault Lantern, Practical Lantern
SpotlightDirectional cinema lightsFresnel, Ellipsoidal, PAR, Open Face, Fluorescent, LED Panel, Ring Light, Scoop, Cyc
Directional / SunInfinite directional sourceFlood lights for sun/sky simulation

Gobos / Cookies

Spotlights support gobo patterns (also called cookies) that project shadows and light patterns. Over 50 gobo variations are available:

How to add a gobo

  1. Place a spotlight in your scene (Add Objects tray → Light).
  2. Open the light's context menu — right-click on Mac, or tap the light on iPad/iPhone.
  3. Tap Gobo.
  4. Pick a pattern from the gallery — the projection updates live on the canvas.

Gobos only apply to spotlights; other light types (omni, area) don't project patterns.

AI Lighting & Atmosphere (via Style Grade)

For rapid atmospheric visualisation without placing manual lights, use the AI Style Grade in Timeline Review's Enhance Shot panel. The editable prompt system lets you describe the lighting and mood you want:

Timeline · Updated

Where to find it

The Timeline is the editorial heart of Previs Pro. It shows your shots arranged horizontally with audio tracks, scene groupings, playback controls, and inline AI tooling — everything from shot timing to AI enhancement to audio generation happens here.

Timeline UI elements at a glance

Standard Timeline view (no workspace open). For the Enhance Shot panel that takes over the viewer area, see Enhance Shot panel.

ElementLocationTarget ID
BackTop bar, far left (arrow). Returns to Canvas Editor.timeline.backButton
Title bar ("Timeline Review")Top bar, centertimeline.titleBar
Help (Previs Assist)Top bar, right (? icon)timeline.helpButton
Share / ExportTop bar, far right (share icon)timeline.shareButton
Script Panel toggleHeader row, far left (document icon)timeline.scriptToggle
Scene SelectorHeader row, left ("All Scenes ▾")timeline.sceneSelector
Project titleHeader row, center (e.g. "Example")timeline.projectTitle
Approval StatusHeader row, right ("Pending ▾", color-coded)timeline.approvalStatus
Comment Panel toggleHeader row, far right (speech-bubble icon, strobes when unread)timeline.commentToggle
ViewerLarge image/video display below the header, letterboxed to aspect ratiotimeline.viewer
Viewer fullscreenTop-right of viewer (expand-corners icon, also F)timeline.viewer.fullscreen
Viewer H-MenuBottom-right of viewer (kebab/three-dot icon). See Shot H-Menu.timeline.viewer.hMenu
Info BarThin row under the viewer, e.g. "EXT. NEW YORK STREET SET — DAY · Shot A · 10mm · f/5.6"timeline.infoBar
AI Enhance gutterLeft edge, top (sparkle icon). Toggles the Enhance Shot panel. Shortcut Alt+I.timeline.gutter.enhance
Audio gutterLeft edge, below Enhance (speaker icon). Toggles the Audio Workspace.timeline.gutter.audio
Time rulerHorizontal MM:SS markings above the shot lanetimeline.ruler
Shot lanePrimary horizontal row of shot cardstimeline.shotLane
Scene markerPill above the shot lane (e.g. "4. NEW YORK STREET SET"). Click to rename or recolor the scene.timeline.sceneMarker
Transition handleDiamond marker between adjacent shot cards. Click to change transition type.timeline.transitionHandle
PlayheadVertical red line across the lanestimeline.playhead
Audio lanesBelow shot lane, labeled "AUDIO". Collapsed to one row by default; expands to four lanes when the Audio Workspace is open.timeline.audioLanes
Skip Back / Play / Skip ForwardBottom transport, lefttimeline.transport.prev / play / next
TimecodeBottom transport, current / total (e.g. "01:14.8 / 02:20.6")timeline.transport.timecode
Step toggleBottom transport (pauses at each shot boundary during playback)timeline.transport.stepToggle
Zoom sliderBottom transport, next to Step (pixels-per-second 20–300)timeline.transport.zoom
Credit balanceBottom transport, right (number + globe icon, e.g. "473")timeline.transport.credits
ExportBottom transport, right of creditstimeline.transport.export
ShareBottom transport, far right (red button)timeline.transport.share

Layout

The Timeline interface is divided into five stacked zones, top to bottom:

1. Top Header Bar

2. Viewer Area

The large display showing the current shot. Letterboxed to the project's aspect ratio. Content depends on context:

Viewer Edit Overlay

A pencil icon in the bottom-right of the Viewer expands on click to reveal quick-action buttons:

If doodle annotations already exist on the shot, clicking the pencil shows a management dialog: the creator sees Draw / Clear All / Cancel; reviewers see Redraw / Clear Mine / Cancel.

Single-Shot AI Confirm Popover

When generating AI content for a single shot (via the H-Menu or quick keys), a modal popover appears over the viewer with:

Three modes: Enhance Image (sparkle icon), Generate Video (play icon), and Generate Transition (arrow icon, shows from/to shot info).

Video Generation Modal

During video generation, a full-viewport blocking overlay appears. Cannot be dismissed until generation completes or fails:

Enhancement Preview (Before / After)

After AI image enhancement, a split-view comparison overlay appears:

Image Fly Overlay

Tapping a shot thumbnail in the Enhance Shot panel opens a fullscreen image/video viewer with Motion fly-in animation from the source thumbnail. Swipe left/right to navigate between shots (scope-aware — respects the active scene filter). Videos show a play button overlay. Tap the backdrop to close.

Fullscreen Viewer

Press F to toggle fullscreen mode. Hides all panels and maximises the viewer area.

3. Info Bar

A thin black bar between the Viewer and the Shot Lane. Displays:

When no shot is under the playhead, the project title is shown instead.

4. Shot Lane

The primary horizontal timeline row. Each shot is a colored bar with:

A playhead (vertical red line) shows the current time position. A timecode ruler runs along the top showing MM:SS markings.

Transition Zones

Between adjacent shot bars, a small gap represents the transition. Click this gap to open a popover where you can change the transition type.

5. Audio Lanes

Below the shot lane, 4 color-coded audio tracks. Collapsed by default (single "AUDIO" row); expands to show all 4 lanes when the Audio Workspace is open:

Each lane shows waveform bars for its audio clips. See Audio System for full details.

6. Transport Bar

Fixed at the bottom of the screen. Contains (left to right):

Side Panels

Three optional right-side panels, toggled independently:

Shot Management

Selecting & Navigating

Duration Editing

Shot Reordering

Shots can be reordered within their scene by dragging:

Shot H-Menu (Quick Actions)

Click/tap a shot's thumbnail area in the viewer to reveal the horizontal quick-action menu:

Revert to Live

Reverting a shot clears the AI-generated image, video, and history reference, then requests a fresh 3D render from Unity (in embedded mode). The shot returns to showing the live camera view. Available via the H-Menu Revert button or the Shot Preview in the Enhance Shot panel.

Duplicating vs. Copying Shots

Previs Pro has two ways to create a new shot from an existing one. They behave differently:

MethodHowWhat you get
(+) Duplicate Tap the + button in the Shot List A clean new shot. Camera, characters, and props drop in for convenience, but AI style grades, animatic keyframes/motion paths, video overlays, and other shot-specific metadata are stripped. Think of it as a fresh starting point.
H-Menu Copy & Paste Tap the shot → H-Menu → Copy, then tap another position → Paste A full copy of the shot. Animatic keyframes and motion paths, AI enhancements, audio clips, and all metadata are preserved.
Tip: If you've set up animatics on a shot and want to carry over the motion paths, always use Copy & Paste from the H-Menu — not the (+) button.

Shot Metadata

Each shot carries rich cinematography metadata, set in the 3D editor and displayed in the Info Bar. This metadata also drives AI prompt generation — the system automatically describes the shot using these values.

Shot Size

ValueAI Prompt Mapping
ECUextreme close-up
Chokerchoker close-up
Close-Upclose-up
Med CUmedium close-up
Mediummedium shot
Cowboycowboy shot
Med Fullmedium full shot
Med Widemedium wide shot
Fullfull shot
Widewide shot
Longlong shot
Extreme Wideextreme wide shot
Extreme Longextreme long shot
Establishingestablishing shot
Aerialaerial shot

Shot Angle

ValueAI Prompt Mapping
Eye Leveleye level
Low Anglelow angle
High Anglehigh angle
Hip Levelhip level
Knee Levelknee level
Ground Levelground level
Shoulder Levelshoulder level
Bird's Eyebird's eye view
Dutchdutch angle
Overheadoverhead
Aerial / Helicopter / Droneaerial / helicopter / drone shot
OTSover-the-shoulder

Shot Movement

ValueAI Prompt Mapping
Staticstatic locked-off shot
Dolly In / Outcamera pushing in / pulling out
Pan Left / Rightpanning left / right
Tilt Up / Downtilting up / down
Crane Up / Downcrane shot rising / descending
Steadicamsmooth tracking shot
Handheldhandheld, natural movement

Shot Framing

Examples: SS (single shot), 2S OTS (two-shot over-the-shoulder). Displayed in the Info Bar.

Additional Per-Shot Data

Scene Selector

The scene selector pill in the top-left corner controls which portion of the project is visible in the timeline:

Each scene in the project has:

Scene & Shot Numbering

Previs Pro has a flexible numbering system with several configurable options:

Scene Numbers

Scenes are numbered sequentially starting from a configurable starting number (default 1). Walk scenes in order; if a scene has a manual number, it's used as-is without incrementing the counter.

Shot Numbers

Shots are numbered per-scene. Two modes:

Ambiguous Character Exclusion

By default, the letter set excludes I, O, and S (easily confused with numbers 1, 0, and 5) — using a 23-character set. This can be toggled to use the full A-Z alphabet.

Combined Format

Scene and shot numbers are joined with a configurable separator: nothing (1A), period (1.A), or hyphen (1-A). Two ordering variants:

Locked Numbering

When numbering is locked, the computed numbers are frozen into the database. Adding or removing shots won't automatically renumber. Useful for production when departments are already referencing specific shot numbers.

Playback & Transport

Basic Controls

ActionControl
Play / PauseSpace or Play button
Skip BackSkip button or Home (jump to start)
Skip ForwardSkip button or End (jump to end)
Seek Frame-by-Frame /
Zoom Timeline+ / -

Shuttle Control (J/K/L)

Professional NLE-style shuttle for variable-speed playback:

KeyAction
LPlay forward. Press again to increase speed (2x, 4x, 8x).
JPlay reverse. Press again to increase reverse speed.
KStop / return to normal speed.
Audio note: Audio plays only at 1x speed. Shuttle speeds (2x, 0.5x, reverse) automatically mute audio to avoid pitch distortion.

Review Auto-Play

When enabled (toggle in the Transport bar), playback automatically pauses at each shot boundary. This gives reviewers time to evaluate each shot before moving on. Continuous transitions play through without pausing.

Timecode Display

The Transport bar shows the current position in MM:SS.S format (minutes, seconds, tenths of a second).

Transitions

Click the gap between two adjacent shots in the timeline to open a transition popover. Available transition types:

TypeDescription
CutInstant switch with no duration. The default.
DissolveCrossfade between the two shots.
Fade to BlackCurrent shot fades to black, then the next shot fades in from black.
Fade from BlackVariation of fade to/from black.

For dissolve and fade transitions, the duration is adjustable. Each transition is stored with an easing curve.

AI-Generated Transitions

Between two shots that both have AI-generated images, a "Generate Transition" button appears centered at the bottom of the viewer. This creates a smooth AI video transition using both shots as start/end keyframes.

While in the viewer, transition overlays provide:

Viewer Modes & Workspaces

The Viewer area can switch between several modes. Only one workspace can be open at a time:

ModeTriggerWhat it shows
Default ViewerClose all workspacesShot thumbnail/video with edit overlay, doodle annotations
Enhance ShotGutter sparkle button or Alt+IStyle Grade / Touch Up / Import tabs with shot grid
Audio WorkspaceGutter waveform button or Alt+AScratch / Record / Import tabs for audio
FullscreenFMaximized viewer with transport only

Coach Mark (Quick Orient)

On first use, a step-through tutorial highlights key interface elements with a glow effect. Different flows for creators (introduces shot enhancement, timeline, shot management) vs. reviewers (introduces commenting, approvals, doodle annotations). Skip or Next buttons to navigate. Does not reappear after completion.

Tease Overlay

When a reviewer taps a creator-only feature (e.g., AI generation, audio workspace), a gentle overlay explains the feature is unavailable in review mode.

Undo & Redo

The timeline maintains an undo stack (up to 50 states). Every edit — shot duration changes, reorders, AI enhancements, audio placements, comment changes — can be undone:

Drag operations (shot resize, audio clip move) are coalesced into a single undo step. Audio blob data and generation history are immune to undo/redo — they persist permanently.

Mobile & Tablet Layout

On phones (under 500px width), the timeline switches to a compact layout:

On tablets (iPads), a @media (pointer: coarse) rule increases font sizes and hit targets by ~15–20% over desktop sizes. These tablet values also scale with the UI Scaling system.

UI Scaling

Text and control sizes can be adjusted via Previs Pro > UI Scaling (7 levels from Extra Small to Extra Extra Extra Large, default Large). The scaling level is sent to the Timeline WebView and applied via CSS variables. The scaling system has two strategies:

The .previs File Format

Projects are saved as .previs files — either a raw SQLite database or a zip archive (detected by PK magic bytes).

Raw SQLite

A single SQLite file containing all project data: scenes, shots, camera objects, screenplay, transitions, audio clips, comments, generation history, and document settings.

Archive Format

A zip file with .previs extension containing:

On import, the archive is extracted in-place. On share/export, the archive is assembled from the SQLite + cache folder.

Standalone Mode

In the web app (standalone mode), .previs files can be opened by drag-and-drop onto the browser window. The file is read client-side using sql.js (SQLite compiled to WebAssembly). Changes can be saved back by downloading.

Audio System · Updated

Where to find it

The Audio Workspace provides three audio creation pathways: AI generation (TTS, Music, SFX — part of the AI Generation suite, credit-based), live recording, and file import. Audio plays across four color-coded lanes.

Audio Workspace UI elements

Create tab open with Dialogue type selected. Tabs share the close button and the underlying timeline expansion.

ElementLocationTarget ID
Create tabTop of panel, left (active tab is underlined)audio.tab.create
Record tabTop of panelaudio.tab.record
Import tabTop of panelaudio.tab.import
Close panelTop of panel, far right (X)audio.closeButton
Audio type pickerTop-left of Create tab ("Dialogue ▾" / Music / SFX / Voiceover)audio.create.typePicker
Model pickerNext to type ("Best 3cr ▾" for ElevenLabs, "Fast 2cr" for Kokoro on dialogue)audio.create.modelPicker
Scope pickerNext to model ("All Scenes ▾" / Selected Scene / Selected Shot / Custom)audio.create.scopePicker
Cast listBlock of rows below the pickers, one row per character with a voice dropdown and a speaker-preview iconaudio.create.castList
Cast row — voice pickerDropdown per character (e.g. "Bill", "Daniel", "Rachel"). Tap to choose a voice from the model's voice pool.audio.create.castList.voice
Cast row — previewSpeaker icon to the right of the voice picker. Plays a short sample of that voice through Unity's native audio in embedded mode.audio.create.castList.preview
Retime checkboxBottom-left of Create tab. Auto-extends shot duration to fit generated speech (1s padding each side, 0.3s between clips).audio.create.retime
Overwrite existing dialogueBottom-left, next to Retimeaudio.create.overwrite
Generate buttonBig red button at bottom-right, label depends on type: "Generate Scene Dialogue", "Generate Music", "Generate SFX", "Generate Voiceover". Cost shown inline (e.g. "~30 cr").audio.create.generateButton
Prompt textareaReplaces the cast list for Music, SFX, and Voiceover types. Freeform text describing the desired sound.audio.create.promptInput
Duration sliderBelow the prompt for Music (3–15s) and SFX (1–22s)audio.create.durationSlider
Lane label — DIALOGFar-left of timeline, Lane 0 label (visible only when Audio Workspace is open)timeline.audioLanes.dialog
Lane label — MUSICLane 1timeline.audioLanes.music
Lane label — SFXLane 2timeline.audioLanes.sfx
Lane label — VOICEOVERLane 3timeline.audioLanes.voiceover
Audio clipA colored waveform bar on any of the four lanes. Tap the caption text to edit; drag the edges to retime; drag the body to reposition.timeline.audioLanes.clip

Create Tab (AI Audio Generation)

Previously labeled "Scratch" — the on-screen tab now reads Create. Anchor preserved for back-links.

Generate audio from text using AI. Four scratch types:

Dialogue (TTS)

Generates speech from screenplay dialogue. Choose scope:

TTS Voice Models

ModelSpeedCostVoices
Kokoro (Fast)~3s per line2 credits/line8 voices (Heart, Bella, Jessica, Nicole, Nova, Adam, Eric, Michael)
ElevenLabs (Best)~8s per line3 credits/line20+ voices (Rachel, Aria, Sarah, Roger, Charlie, George, and more)

Voice Assignment

The Cast section shows each character with a voice dropdown. Voices are assigned per-scene, with global fallback. Click the speaker icon to preview a voice. Auto-assignment fills unassigned characters from the available pool.

Music Generation

SFX Generation

Generation Options

Record Tab

  1. Click the red Record button.
  2. 3-2-1 countdown (800ms per count).
  3. Speak into the microphone; elapsed time is displayed.
  4. Click Stop.
  5. Preview in the bar, choose a lane, then + Add Audio.

Trailing silence is automatically trimmed. Recordings saved as WAV format. On iOS, recording uses the native microphone via Unity's audio pipeline (no audio bytes cross the bridge).

Import Tab

Supported formats: .wav, .mp3, .ogg, .m4a, .aac.

Drag and drop files into the drop zone (or tap to browse on mobile). Files are decoded, waveform peaks computed, and placed at the current playhead position on the selected lane.

Audio Lanes

LaneColorPurpose
Dialog (Lane 0)BlueCharacter spoken dialogue
Music (Lane 1)PinkBackground music, score
SFX (Lane 2)GreenSound effects, ambient
Voiceover (Lane 3)OrangeNarration, commentary

Clip Interactions

Clips are positioned relative to shots (shotId + shotOffset). Absolute position is derived at render time. Clips can overshoot shot duration (useful for music spanning multiple shots).

AI Generation · Updated

AI Generation is Previs Pro's umbrella system for credit-powered asset creation. It covers four families — image, video, audio, and 3D — all drawing from the same credit pool. Each family has its own access point in the app:

FamilyAccess pointWhere in the UI
Image & VideoEnhance Shot panelTimeline Review — gutter sparkle button or Alt+I
Audio (TTS, Music, SFX)Audio Workspace > Scratch tabTimeline Review — gutter waveform button or Alt+A
3D PropsGenerate AI PropAdd menu > Generate AI Prop
3D CharactersActorGenAdd Character > ActorGen

The catalog below covers each family's models, options, and behavior. For the unified credit cost reference, see Credits & Purchasing.

Models & Providers

Previs Pro uses third-party AI models (FLUX.2 Turbo, Seedream 4.5, Nano Banana 2, Wan 2.1, Veo 3.1 Fast, Seedance 2.0, Kokoro, ElevenLabs, Tripo3D) and does not train any of its own models on user content — your prompts, scripts, scenes, and images are not used as training data. Each AI feature routes to a best-of-breed third-party model via fal.ai:

If you have questions about a specific model’s training data, licensing, or output usage rights, the authoritative source is the model provider listed above. We pass your prompt through to the provider, return their output, and store the result inside your .previs project. Your prompt and the returned media are not used to train any model on our end — we don’t operate a training pipeline.

Enhance Shot Panel — Image & Video access

Where to find it

The Enhance Shot panel is the access point for image and video generation. Inside the Timeline Review panel, the Enhance Shot button opens a three-tab control:

Toggle with the gutter sparkle button or Alt+I. The estimated credit cost and time appear on the Enhance Shot button so each batch's spend is visible before you commit.

Enhance Shot panel UI elements

Style Grade tab open. The Touch Up and Import tabs share the same shot grid and many of the same controls; differences noted in their dedicated subsections.

ElementLocationTarget ID
Style Grade tabTop of panel, left (active tab is underlined)enhance.tab.styleGrade
Touch Up tabTop of panelenhance.tab.touchUp
Import tabTop of panelenhance.tab.import
Close panelTop of panel, far right (X)enhance.closeButton
Type pickerTop-left of Style Grade tab ("Image ▾" / "Video ▾")enhance.typePicker
Model pickerNext to Type ("Best 8cr ▾", shows tier + per-shot credit cost)enhance.modelPicker
Scope pickerNext to Model ("Choose Shots ▾" / "All Shots" / "Selected Scenes")enhance.scopePicker
Style preset — PHOTOStyle row, leftmostenhance.style.photo
Style preset — SKETCHStyle row, middleenhance.style.sketch
Edit PromptStyle row, right (pencil icon). Opens a popover to customize the auto-generated prompt.enhance.editPrompt
Enhance Shot buttonBig red button below the pickers, shows estimated cost + time (e.g. "~8cr · 59s")enhance.enhanceButton
Shot PreviewLarge image at the top-right of the panel showing the currently-targeted shotenhance.shotPreview
Shot GridVirtualised grid of shot thumbnails below the preview. Tap to (de)select, double-click for fullscreen.enhance.shotGrid
Shot Grid cellEach thumbnail (e.g. "1A", "1B", "2A"). A scene/shot strip overlays the bottom of each cell.enhance.shotGrid.cell

Scope Selection

Controls which shots are affected:

Shot Grid

A virtualised grid (only ~20–40 DOM nodes regardless of shot count) showing shot thumbnails with scene/shot label strips. Tap to select, double-click or long-press for fullscreen preview with swipe navigation.

Options

Image Generation (Style Grade)

Enhance shot thumbnails with AI-generated images. The system auto-builds prompts from shot metadata (characters, location, lighting, time of day).

ModelTierCostSpeed
FLUX.2 TurboFast3 credits~8 sec
Seedream 4.5Quality5 credits~25 sec
Nano Banana 2Best8 credits~15 sec

After generation, a review step lets you Accept/Reject each image individually or in bulk. Accepted images replace shot thumbnails and are stored in Generation History.

Video Generation

Generate short video clips from shot thumbnails. Switch the task selector to "Video" in the Style Grade tab.

ModelTierCostResolutionDuration
Wan 2.1Fast30 credits720p3–6 sec
Veo 3.1 FastQuality50 credits720p4, 6, or 8 sec
Seedance 2.0 NewBest (default)75 credits720p4–10 sec
Kling V3Best (legacy)75 credits1080p3–15 sec

New installs default to Seedance 2.0. Kling V3 remains available in the model picker.

Video Options

Continuous Transitions (Video)

Select "Continuous" task to generate smooth AI video transitions between adjacent shots. Uses both shot thumbnails as start/end keyframes. Same video model costs apply.

Touch Up

Refine or modify existing shot images with a text prompt. Uses Nano Banana 2 model (8 credits).

  1. Switch to the Touch Up tab.
  2. Tap a shot in the grid to select it as the target.
  3. Enter a prompt describing the edit (e.g., "make the lighting warmer", "add a beard").
  4. Generate. The current image is used as input; the AI applies the specified changes.
Note: Touch Up cannot be applied to video shots.

Audio Generation

Audio generation is the audio family of AI Gen. It is reached through the Audio Workspace's Scratch tab rather than the Enhance Shot panel, but draws from the same credit pool as image and video. Four scratch types are supported:

TypeModelCostNotes
Dialogue (TTS)Kokoro Fast2 credits / lineFast tier
Dialogue (TTS)ElevenLabs Best3 credits / lineHigher quality
MusicElevenLabs Music (text-to-music)40 creditsForce-instrumental, queue-based
SFXElevenLabs SFX v2 (text-to-sound-effect)5 creditsSync, max 22s
Voiceover(uses Dialogue TTS models)2–3 credits / lineRouted to the VoiceOver lane instead of Dialog

For the full Scratch tab UX — cast list voice assignment, scope selection, prompt + duration controls, voice sample previews — see the Audio Scratch Tab section.

AI 3D Generation

3D Props — 15 credits

  1. Open Add > Generate AI Prop.
  2. Enter a text description (e.g., "wooden chair", "glass vase").
  3. Generation stages: Submitting → Queueing → Running → Downloading (~60 seconds).
  4. Result: a .glb model imported as a prop you can position and scale.

ActorGen (3D Characters) — 26 credits (temporarily free as of 5/8/26 while we improve the results)

  1. Add a character > select the ActorGen option.
  2. Enter a text description. Preview generates first, with Regen option.
  3. Generation stages: Submitting → Queueing → Generating → Rigging → Downloading (~120 seconds).
  4. Result: a rigged .glb model with skeleton, ready for posing and animation.

Generation History

All AI-generated assets are permanently stored in the project's generation history (timeline_generation_history table). The history survives undo/redo.

Credits & Purchasing · Updated

AI features are powered by a credit system. Credits (called "tokens" internally) are consumed each time you use an AI feature.

Credit Costs per Feature

CategoryFeatureModelCredits
ImageStyle GradeFLUX.2 Turbo (Fast)3
Style GradeSeedream 4.5 (Quality)5
Style GradeNano Banana 2 (Best)8
VideoVideo GenWan 2.1 (Fast)30
Video GenVeo 3.1 Fast (Quality)50
Video GenSeedance 2.0 (Best, default)75
Video GenKling V3 (Best, legacy)75
TTSDialogueKokoro (Fast)2 per line
DialogueElevenLabs (Best)3 per line
MusicMusic GenElevenLabs Music40
SFXSFX GenElevenLabs SFX5
Touch UpImage EditNano Banana 28
3DProp GenAI 3D15
Character GenAI 3D + Rigging26 *

* As of 5/8/26 ActorGen is temporarily free while we improve quality — the 26-credit cost will return once results meet our standards.

Credits are deducted server-side before generation. If generation fails, credits are automatically refunded.

Welcome bonus: New users receive 150 free credits on sign-up — enough to try several AI features before purchasing.

Credit Packs

Purchase additional credits anytime. Exchange rate: 100 credits = $1.00.

PackCreditsPriceBadge
Starter100$4.99Top Off
Standard400$14.99Most Popular (25% savings)
Pro1,200$39.99Best Value (33% savings)

Credit packs are purchased through Apple In-App Purchase. The web review experience does not include a purchase flow — sign in to the iOS or Mac app to top up.

Value framing: The purchase dialog shows estimated output for each pack. For example, 400 credits ≈ ~133 images (using the cheapest model) or ~13 videos.

Low balance warning: Triggered when balance drops below 20 credits.

Subscription Plans

Subscriptions unlock full access to all non-AI tools and features (unlimited projects, exports without watermark, all assets, etc.).

Where to manage your subscription. Subscriptions, trials, renewals, and refunds for Previs Pro all live in your Apple account — the same place that handles every App Store purchase. The sections below link straight to the Apple controls for canceling, getting receipts, requesting a refund, and sharing your subscription with your family.
PlanPriceNotes
Free$0Limited: watermarked exports, limited animatics.
Monthly$39.99/monthFull access, cancel anytime.
Annual$119.99/year$9.99/month billed yearly.
Lifetime$359.99One-time purchase, permanent access.

Free Trial

A 7-day free trial is available for new users. All professional features are unlocked during the trial. A reminder is sent around day 5. After 7 days the trial auto-converts into the paid plan you selected when you signed up — usually the annual plan.

Avoid the surprise annual charge: The trial is a real subscription with a 7-day grace period. If you don't intend to keep it, cancel before the trial ends, not after. Canceling on day 7 or earlier still gives you the full 7 days of access — canceling after the period converts is too late to stop the charge. Apple sends the reminder, but it can land in a junk folder. See Canceling a Subscription below.

One trial per Apple ID. If you've already used your trial in the past and you re-install the app, the App Store will offer you the paid plan immediately rather than another free trial — this is an App Store policy, not a Previs Pro choice.

Lifetime vs. Annual — "Why am I being charged again?"

The Lifetime plan is a one-time purchase — it does not renew and cannot be charged again by Apple. If you are seeing a recurring charge after buying Lifetime, one of three things is happening:

Canceling a Subscription

Cancellation is done from your Apple account, not from inside Previs Pro. Apple’s current step-by-step instructions for iPhone, iPad, and Mac live here:

support.apple.com/en-us/118428 — How to cancel a subscription from Apple

You retain access until the end of your current billing period after canceling.

Refunds

Refund requests are handled by Apple directly, the same way they are for every App Store app. Here’s the fastest path:

  1. Go to reportaproblem.apple.com and sign in with the Apple ID you used to purchase.
  2. Find the Previs Pro charge in your purchase history.
  3. Tap Report a Problem and choose the reason that fits your situation (most common: "I didn’t mean to purchase this item" or "I meant to cancel my trial").
  4. Apple typically replies within 48 hours. Approvals are most common within 30 days of the charge.

Apple is the merchant of record for the App Store, so we don’t see your billing information and can’t process refunds on our side. If you’d like a second set of eyes on a tricky case, feel free to email hello@previspro.com with your Apple receipt number and a short description — we’re happy to point you to the right Apple resource.

Receipts, Invoices & VAT

Apple is the merchant of record for every Previs Pro purchase. Your receipt — including VAT/GST, business name, and reverse-charge information — comes from Apple, not from Previs Pro.

Using One Subscription on Mac, iPad and iPhone

Previs Pro signs in with Sign In with Apple, the Apple account system that’s built into iPhone, iPad and Mac. Your subscription, credit balance, and projects follow that account, not the individual device. To use one purchase across multiple devices:

  1. On each device, install Previs Pro from the App Store while signed into the same Apple ID you used to purchase.
  2. In Previs Pro, tap Sign In and complete Sign In with Apple. Use the same Apple ID on every device.
  3. If the app still shows a trial or watermarks exports, open the purchasing dialog and tap Restore Purchases. This re-checks your Apple ID for an active subscription or lifetime entitlement.
Use one Apple ID across devices. Apple ties your Previs Pro subscription to your Apple ID, so the easiest way to use one purchase on multiple devices is to make sure each device’s App Store is signed into the same Apple ID, then tap Restore Purchases in Previs Pro. If you already bought on iPad with Apple ID A and want to use the Mac with Apple ID B, the cleanest fix is to switch the Mac App Store over to Apple ID A.

Family Sharing. Previs Pro subscriptions are shareable through Apple Family Sharing — up to six family members on the same Apple Family can use one subscription. Set this up in iOS/macOS Settings > Family. Lifetime purchases follow Apple’s standard Family Sharing rules for non-consumable IAP.

"I paid on iPad — why does my Mac still say trial?"

The Mac App Store and Previs Pro both need to be using the same Apple ID that paid on iPad. If they are and the Mac still shows trial:

Tap Restore Purchases in the Previs Pro upgrade dialog while signed into the Apple ID that made the purchase — this is the fix in about 95% of cases. Watermarked exports and the upgrade prompt are tied to the active subscription state at export time, not the device, so the app is checking with Apple every time. If Restore Purchases doesn't clear it:

If the watermark persists after Restore Purchases on a device signed into the same Apple ID that made the purchase, write us at hello@previspro.com with your Apple receipt number and the device model and we’ll take a look.

Educators & Students

Previs Pro doesn’t run a formal educator program or issue student discount codes. The good news: the free version is fully functional for storyboarding. You can build sets, place characters, find shots, line scripts, export PDFs, and share for review — the only catch is that exports carry a small watermark and animatic length is limited.

For most film, theater, and animation course work, the free tier is enough.

Professors and instructors who want an unrestricted copy for personal use or class demos are welcome to email hello@previspro.com from an institutional address. Mention the school, the course, and what you’re teaching — we typically respond with a free copy.

If you’ve seen older mentions of a 70% student discount or an academic-year license, those programs have been retired. The watermark-on-export free tier replaces them.

Credits vs. Subscription: The subscription unlocks the app's tools and removes limitations. AI generation features require credits on top of the subscription — they are a separate purchase.

Earn Free Credits

The Earn Credits dialog offers three ways to earn credits without purchasing:

Reward TypeAmountFrequency
Refer a Friend+50 credits (both you and your friend)Up to 5 referrals per month
Social Share+25 creditsOnce per 7-day cooldown
Share Reviewer Link+25 creditsOne-time reward

Referral System

Social Share

Available in the iOS/Mac app. Share your project via the native share sheet (rendered with branding and user logo watermark). Earn 25 credits per share, with a 7-day cooldown. All enforcement is server-side.

See also: Pricing & License articles on the support site.

Screenplay · Updated

Previs Pro treats the screenplay as first-class project data. Once a script is imported, scenes, cast, dialogue, action, and transitions are stitched into the rest of the app — the Scene Manager, the Cast list, the Script Panel in the Timeline, and a dedicated Screenplay Manager for browsing, editing, and reconciling revisions.

Importing a Script

Previs Pro imports every major deterministic screenplay format. From the Projects screen, tap the + button, then tap Import and pick your file.

What gets extracted

The first time you import a script, Previs Pro saves an import baseline — a snapshot of the screenplay as it arrived. The baseline is what View Changes compares against, and what the Importing a New Version flow uses to reconcile a revised draft.

No script? You can still build a project from scratch and add characters one at a time from the Cast Menu — no screenplay import required.

Script privacy and confidentiality

Imported screenplays are stored locally inside your .previs project file. The file is a single SQLite database on your device — nothing about your script is sent to Previs Pro’s servers by importing it.

The exceptions are features you explicitly trigger:

If you’re working on a confidential project and want to minimize outbound traffic entirely, skip the AI features and the Publish-to-Web flow, and store the file in local-only storage. The rest of the app works fully offline.

See also: How do I start a project with my script? on the support site.

Where Screenplay Appears

Screenplay data flows into several places once it's imported:

Screenplay Manager — Browse Mode

The Screenplay Manager is a dedicated popup panel for browsing and editing screenplay data without leaving the project. Browse Mode is the default view.

Scene Tab

Character Tab

Editable Elements

Screenplay Manager — View Changes

View Changes compares the current screenplay against the import baseline — the snapshot saved when the script was first imported. Use it to see what you've edited, or to audit changes before sharing the project for review.

Scene-level diff

Element-level diff 3.4

Tap into a changed scene to see a per-line comparison of dialogue, action, and transitions. The element view mirrors the scene-level layout: a left column (baseline), a right column (current), and a gutter between them with connector lines linking matched pairs.

Move detection runs as a second pass after the line-by-line alignment, so a chunk of dialogue that simply got pushed earlier or later in the scene shows up as MOVED rather than as a paired ADDED/REMOVED.

Word-level diff highlighting, the "Show only changes" toggle, and the First/Previous/Next/Last navigation buttons all work in both the scene and element views.

Importing a New Version

If your script changes after the project is built — new scenes, cut scenes, dialogue rewrites — you can bring the revised version in without rebuilding the project.

  1. Open the Screenplay Manager from the Scene View.
  2. Tap Import New Version in the top-right of the manager (or from inside the View Changes view).
  3. Pick the new script file. Previs Pro reads it, diffs it against the import baseline, and opens the Import Review.

Import Review

The Import Review is a side-by-side comparison: your project's current scenes on the left, the incoming version on the right. It uses the same scene-level and element-level diff visuals as View Changes, plus three reviewer controls for shaping what actually gets merged.

When the review reflects what you want, tap Apply. Cancel discards the merge plan and leaves the project untouched.

Tip: The baseline updates after a successful re-import, so the next View Changes is against the freshly merged version — not the original script. If you want to keep comparing against the very first import, snapshot the project before applying.

Script Panel & Script Lining

Where to find it

Script Panel

Displays the screenplay for the current scene in the left sidebar, synced to the playhead position. Supports:

Script Panel UI elements

ElementLocationTarget ID
Header dateTop of panel ("Last edited [date]"). Shows the most recent screenplay revision date.scriptPanel.headerDate
Help (Previs Assist)Top-right of panel (? icon)scriptPanel.helpButton
Close panelTop-right of panel (X)scriptPanel.closeButton
Scene headingFirst bold line of the body (e.g. "EXT. NEW YORK STREET — DAY")scriptPanel.sceneHeading
Script bodyMonospaced screenplay text below the heading. Auto-scrolls during playback.scriptPanel.body
SCRIPT tabBottom of panel, left (active tab is underlined red)scriptPanel.tab.script
PUNCH UP tabBottom of panel, center. Switches to free-form editable text mode.scriptPanel.tab.punchUp
Annotate (pencil)Bottom of panel, right. Opens pen / highlighter / eraser annotation tools.scriptPanel.annotateButton

Script Lining Future Release

Digital "tramlines" for shot coverage visualisation — colored vertical bars per shot indicating which script elements each shot covers, mimicking traditional lined scripts with digital interactivity. This feature is currently in development and will be available in a future release.

Sharing & Review

Create a time-limited, password-protected share link that anyone can use to review your project in a browser.

  1. Open the Share dialog (G key).
  2. Choose TTL: 7, 30, or 90 days.
  3. A password is auto-generated.
  4. Share the link: share.previspro.com?session=SESSION_ID

The shared project includes thumbnails, videos, audio clips, comments, and approvals — all uploaded to the cloud.

Comments

Where to find it

Comment Panel UI elements

ElementLocationTarget ID
Scene titleTop of panel, left ("Scene 1" / "Scene 2" / etc., bold). Reflects the playhead's current scene.commentPanel.sceneTitle
Comments labelTop of panel, next to Scene titlecommentPanel.title
Copy all commentsTop of panel, right group (duplicate-pages icon)commentPanel.copyAllButton
Delete scopeTop of panel, right group (trash icon). Deletes per current filter.commentPanel.deleteButton
Author filterTop-right ("Creator" pill, tap to cycle reviewers). Filters the visible thread to one author.commentPanel.authorFilter
Comment rowEach entry in the scrollable thread. Includes avatar bubble, author name, shot tag, timecode, age (e.g. "51d ago"), body text, and Reply / Delete actions.commentPanel.commentRow
Comment — ReplyAction link under each row, opens a reply inputcommentPanel.commentRow.reply
Comment — DeleteAction link under each row (own comments and Creator-as-reviewer only)commentPanel.commentRow.delete
Add comment inputBottom of panel ("Add a comment...")commentPanel.addInput
SendBottom-right of panel (red button, disabled until input has content)commentPanel.sendButton

Reviewer Colors

Assigned deterministically based on reviewer name (same person always gets the same color):

Blue Red Green Amber Purple Cyan Deep Orange Pink

Doodle Annotations

Draw directly on the shot viewer to provide visual feedback.

Approvals

Each shot has an approval status visible in the timeline:

StatusColorMeaning
PendingGrayDefault — no review action taken.
ApprovedGreenShot accepted and ready.
NotesYellow/AmberFeedback provided, needs revision.

Approval is set per-shot by reviewers via the top header dropdown. The scene pill turns green when all shots are approved. Optimistic locking prevents conflicts from concurrent reviewers.

Publish to Web

Permanently publish your project to a web URL (separate from the time-limited review link).

See also: Save & Share articles on the support site.

Animatics

Animatic Mode adds time-based motion to your storyboard. It is a full canvas mode — switching to Animatics replaces the vertical Shot List with a horizontal continuing shot list and overlays animation controls on the 2D or 3D canvas.

Entering Animatics Mode

Tap the Enter Animatics Mode button. The main title bar is replaced by the animatics title bar (scene/shot name, Done, Undo, Redo). A continuing shot list panel appears on the side for sequencing shots. Exit by tapping Done to return to the standard canvas.

Keyframing

Camera and actor moves in Previs Pro Animatics Mode have no fixed keyframe limit — add as many as the shot needs. Each keyframe stores a position and rotation; the timing between any two is editable inline.

Position and rotation tween. Pose snaps. Previs Pro smoothly interpolates position and rotation between keyframes, so a character glides along the path or a camera dollies smoothly. But character pose doesn't tween — if the pose at the next keyframe differs from the current one, the new pose snaps in at the moment the playhead reaches that keyframe. For a walk-to-run transition, set the pose change at the keyframe where you want it to happen. There is no in-between pose blend.

Workflow:

  1. Set "Start" position (Keyframe A).
  2. Scrub the progress slider forward — keyframe indicators (dots) appear on the slider marking set positions.
  3. Move the Camera or Actor.
  4. Set the next keyframe. Repeat to add as many keyframes as you need — you’re not limited to a start and end.

Tap the duration box between keyframes to enter precise timing (e.g., "push in over 5.0 seconds").

Two different "keyframes" in Previs Pro. Animatics Mode (this section) lets you set as many keyframes per shot as you want for camera and actor moves — the only practical limit is shot duration. A separate feature, AI Video Generation in the Enhance Shot panel, uses exactly two keyframes (start frame + end frame) because that’s the input shape the AI video models expect. If you came here looking for "more than two keyframes" and you’re in the Enhance Shot panel, you’re in the wrong place — switch to Animatics Mode.

Playback

Motion Paths

In the 2D Overhead View, moving objects leave a dotted trail. Tap the path to add nodes and curve the movement with Bezier curves (e.g., a camera sweeping around a character rather than through them). In 3D, velocity curve and timing line renderers show speed and second markers along the path.

Animatic Export

Animatics can be exported as MP4 video with synchronized audio tracks.

See also: Animatics articles on the support site. Watch video tutorials on the Previs Pro YouTube channel for step-by-step walkthroughs of the animatics workflow.

Export

The Export button on the timeline's bottom shelf is the main route. It opens a tabbed dialog with all timeline-driven exports — HTML player, NLE handoff, and (in standalone) Publish to Web. PDF storyboards and MP4 video render from the Unity app's storyboard view.

PDF Storyboard

The industry-standard export format.

MP4 Video

Export your storyboard or animatic as a video file with synchronized audio. Enabled as a professional feature.

If the MP4 doesn’t look how you expected

HTML Player

Tap Export on the timeline's bottom shelf and choose Download HTML to produce a single self-contained .html file you can email, drop into Dropbox, or open directly in any modern browser — no Previs Pro install, no internet, no login required.

NLE Export (FCP7 XML)

Hand off the editorial timeline to a non-linear editor for finishing. Tap Export on the timeline's bottom shelf and choose the NLE tab to produce a Final Cut Pro 7 XML (xmeml v5) project as a zip archive containing the XML plus all referenced media (still images, video clips, audio). (Power users: Cmd+E in standalone mode is a shortcut to the same export.)

DaVinci users: after import, point Resolve's relink dialog at the unzipped folder — this is a one-time step DaVinci requires for FCP7 XML imports.

Markup & Annotations

Before exporting, you can draw red-line annotations directly on shots (arrows for movement, circles for emphasis) via Draw Mode.

See also: Storyboards articles on the support site.

Keyboard Shortcuts

Universal (3D Viewport)

ActionShortcut
Undo / RedoCmd+Z / Cmd+Shift+Z
Duplicate Shot/ObjectCmd+D
DeleteBackspace
Focus on SelectionF
Gizmo: MoveW
Gizmo: RotateE
Gizmo: ScaleR
Next / Previous Shot /

Timeline

ActionShortcut
Play / PauseSpace
Shuttle ForwardL
Shuttle ReverseJ
Stop ShuttleK
Zoom In / Out+ / -
Fullscreen ViewerF
Toggle Comment PanelC
Toggle Script PanelR
Toggle History PanelH
Toggle Drawing ModeD
Show Keyboard Shortcuts?
Open Share DialogG
Open NLE ExportCmd+E

AI & Audio

ActionShortcut
Toggle Enhance ShotAlt+I
Quick Video GenerationAlt+V
Quick TTS SpeechAlt+S
Toggle Audio WorkspaceAlt+A

Discontinued & Replaced Features

The following features from earlier versions of Previs Pro have been replaced or removed. If you're looking for them, here's where to find the equivalent functionality.

Former FeatureStatusReplacement
Post Mode Removed All post-production features (image enhancement, touch up, markup) are now in Timeline Review's Enhance Shot panel. Enhance Shot offers more powerful batch processing, newer AI models, and editable prompts.
Light Grade Replaced Atmospheric lighting and color grading are now achieved through the Style Grade prompt system. Type a lighting description (e.g., "Film Noir, high contrast") in the editable prompt field. The newer AI models produce better results than the original Light Grade feature.
Set Pieces Replaced The "Set Piece" toggle (which made individual objects global across all shots) has been replaced by the Save/Load Sets feature in the new scene dialog. Save an entire room layout as a set, then load it into other scenes.
AI Transitions (Pre-Timeline) Replaced The earlier AI-generated video transitions system has been upgraded into the Continuous task in the Enhance Shot panel. Select "Continuous" in the Style Grade tab to generate smooth AI video blends between adjacent shots using newer, higher-quality video models.
LiDAR Scanning Deprecated Great third-party iOS apps like Polycam are the best way to use LiDAR with Previs Pro — it’s fast and simple. Scan your environment, export as .glb, and import the 3D model into Previs Pro.
Ready Player Me avatar builder Removed The in-app Ready Player Me avatar-builder integration is no longer part of Previs Pro. ActorGen is the supported way to create custom characters — describe the character in text and the system generates and rigs a posable model for you. Existing RPM characters in older projects continue to work; only the in-app builder is gone.

System Requirements

Previs Pro runs on iPad, iPhone, and Mac. The main limitation — and the source of almost all unexpected quits — is RAM (memory). More RAM means more 3D props, larger scenes, and smoother exports.

Apple-only by design. Previs Pro is built for the Apple ecosystem — iPad, iPhone, and Mac. There is no Windows or Android version, and no roadmap to add one. The app relies heavily on Apple-specific frameworks (Metal rendering, ARKit, Core ML, SwiftUI bridges) that don’t cross to other platforms. If you need cross-platform review, the Publish to Web link works in any modern browser on any OS.

Rule of thumb: 4 GB of RAM is the minimum. 6 GB+ runs comfortably for most projects; 8 GB+ handles large, complex scenes with many imported assets.

Minimum OS

RAM by Device

Any device released after 2022 is supported in Previs Pro as of 2026.

RAMDevicesExperience
8+ GB iPad Pro 2021+, iPad Pro M4, M1 MacBook+ Excellent — Large projects, many imported assets, complex scenes.
6 GB iPhone 13 Pro, iPhone 14 Pro, iPad Pro 2017+, iPhone 12 Pro Good — Comfortable for most projects.
4 GB iPhone 13, iPhone 13 mini, iPhone 12, iPhone 12 mini, iPhone 11, iPad Air 2021+, iPad Pro 2017 Minimum — Works, but limit imported 3D props and high-resolution images in large scenes to avoid memory pressure.

If your device — or a more recent model of the same name — is listed in the table, you're good. Devices with less than 4 GB of RAM are not supported.

Using Previs Pro on a 4 GB Device

If you're on the minimum 4 GB tier, these tips help avoid memory pressure and crashes:

As iOS versions grow larger, older devices have progressively less available memory for apps. If you're experiencing persistent crashes on a supported device, contact support@previspro.com with your device model and what you were doing when the crash occurred.

See also: Why did Previs Pro crash? and Using Previs Pro on older devices on the support site.

Troubleshooting

Crashes & Memory

Almost always RAM related — especially on export or in large scenes. See System Requirements for device-specific RAM details and tips on reducing memory usage. If crashes persist on a supported device, email support@previspro.com with your device model and what you were doing when it happened.

Missing Textures on 3D Import

Ensure texture files are in the same directory as the .glb / .gltf file before importing.

AR Plane Not Detected

Ensure the room is well-lit. AR relies on visual contrast to detect and lock the floor plane. Move slowly while scanning.

Audio Not Playing

WebView Blank Screen

If the Timeline or Screenplay Manager panel appears blank, it will auto-recover. All WebView panels include a blank screen guard that detects and recreates the webview if needed.

Credit Balance Not Updating

Credit balance syncs after sign-in, after purchase, and after earning rewards. Try signing out and back in to force a refresh.

Non-English Text Rendering or Input

If Chinese, Japanese, Korean, Hebrew, or Arabic text isn't rendering correctly in Previs Pro, that's a bug — not expected behavior — and the fastest path to a fix is to email hello@previspro.com with a screenshot. The app's UI is localized to 11 languages and the 3D-canvas text fields (scene info, shot info, notes, dialogue) accept whatever the system keyboard sends, including CJK and right-to-left scripts. Workarounds and reporting tips:

After an Update, Something Doesn’t Look Right

App updates ship monthly-ish and occasionally introduce a regression. If a feature that worked before the update now misbehaves — missing buttons, mis-rendered text, layouts breaking, or a panel that doesn’t open — the fastest path to a fix is to flag it:

Recovering a Project That Won’t Open

If a project crashes the app on open, freezes during load, or shows an empty canvas: