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.
Platforms
- Mac — Native macOS app (Apple Silicon + Intel).
- iPad — Native iPadOS app.
- iPhone — Native iOS app, compact layout.
Available on the App Store.
Resources
- Support & Knowledge Base — Articles on Quick Start, Camera, Characters, Props, and more.
- Updates & Release History — Changelog for every version.
- YouTube Channel — Video tutorials and feature walkthroughs.
- Instagram — Tips, user showcases, and updates.
Core Workflow
- Build — Create the environment.
- Block — Place characters and props.
- Shoot — Find the angle using virtual cameras.
- 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
- I forgot to cancel my trial and got charged — how do I get a refund?
- I have Lifetime — why am I being charged a yearly fee?
- How do I cancel my subscription?
- Where do I get a receipt or VAT-compliant invoice?
- I paid — why are my exports still watermarked?
- Is there a student or educator program? Can I use the app for class?
Devices & sign-in
- How do I use one purchase on my Mac, iPad and iPhone?
- I paid on iPad — why does my Mac still say trial?
- Is there a Windows or Android version? Which iPads / Macs are supported?
Characters, props and 3D import
- How do I create a custom character?
- Can I import a rigged character from Blender, Mixamo, or another tool?
- What 3D file formats does Previs Pro accept?
- My imported model is huge / tiny / gray — what do I do?
- How do I copy scenes, characters, or props between projects?
Crashes & updates
- The app keeps crashing — what should I check first?
- A recent update broke something — can I downgrade or report it?
- My project won’t open / lost work — what now?
- Chinese / Hebrew / Japanese text isn’t rendering correctly
Working in the scene
- I keep accidentally dragging props — how do I lock them down?
- If I resize one prop, does it change every copy?
- How many keyframes can a camera move have? (and animatics vs video gen)
- My MP4 export has gaps / shows stills instead of motion
Privacy & AI
Getting Started
Creating a New Project
From the Projects screen, tap the + button in the upper right. This gives you two options:
- New Project — Create a blank project. You can set:
- Title
- Aspect Ratio (2.39:1, 1.85:1, 16:9, etc.)
- Sensor Size (Full Frame 35mm, Super 35, Micro 4/3, iPhone, Canon APS-C, Nikon APS-C, Alexa LF Open Gate, 16mm, Super 16mm, 2/3" Video)
- Start from Screenplay — Pick a Final Draft, Fountain, OSF, Fade In, Celtx, or PDF screenplay. Previs Pro builds the project automatically — scenes, cast, dialogue, action, and transitions all populate. See Starting from a Script below.
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.
- Tap Select in the top bar.
- Tap one or more projects in the list — each tapped project highlights as selected.
- 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.
- 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.
- Tap Import from Project. A project picker shows all your projects with scene/shot/asset counts.
- Select the source project.
- 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.
- 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.
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.
| Element | Location | Target ID |
|---|---|---|
| Back | Top toolbar, far left (arrow) | canvasEditor.backButton |
| Undo / Redo | Top toolbar, left of title | canvasEditor.undoButton / canvasEditor.redoButton |
| Scene Title | Top toolbar, center | canvasEditor.titleBar |
| Director View (Timeline) | Top toolbar, right side (clapperboard icon) | canvasEditor.directorViewButton |
| Help (Previs Assist) | Top toolbar, right side (? icon) | canvasEditor.helpButton |
| Scene options | Top toolbar, far right (three-dot menu) | canvasEditor.kebabMenu |
| Compass / Orientation | Top-left of canvas | canvasEditor.compass |
| Zoom Controls | Top-left of canvas (− / +) | canvasEditor.zoomControls |
| Animatic Mode | Top-right of canvas (running-figure icon) | canvasEditor.animaticsButton |
| AR Mode | Top-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 toggle | Bottom-right toggle row | canvasEditor.camToggle |
| 2D / 3D toggle | Bottom-right toggle row | canvasEditor.viewModeToggle |
| 3D Rotation | Bottom-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 window | canvasEditor.pip |
| Shot List | Right sidebar (vertical strip of thumbnails) | canvasEditor.shotList |
| Selected Shot | Right sidebar, red border | canvasEditor.shotList.selected |
| Shot ID & Focal Length | Right sidebar, under each thumbnail (e.g. "B — FS / SL — 35 mm") | canvasEditor.shotList.label |
| Shot Options | Right sidebar, ⓘ icon next to each thumbnail | canvasEditor.shotList.options |
| Add New Shot | Right sidebar, red + at the bottom | canvasEditor.addShotButton |
Tapping the pencil button opens the Add Objects tray at the bottom-center, where the six object types live:
| Add Objects tray button | Target ID |
|---|---|
| Camera | canvasEditor.addObjects.camera |
| Character | canvasEditor.addObjects.character |
| Prop | canvasEditor.addObjects.prop |
| Wall | canvasEditor.addObjects.wall |
| Light | canvasEditor.addObjects.light |
| Import | canvasEditor.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.
- 1-Finger Drag: Move around the canvas.
- 2-Finger Vertical Drag (iOS/iPadOS only): Tilt the canvas view.
- 2-Finger Rotate: Rotate the canvas.
- Pinch/Pull: Zoom out/in.
Object Controls — when an object is selected, a row of buttons appears in the lower-left of the canvas:
- Movement — Move an object left/right, forward/back, and up/down vertically on the canvas.
- Rotation — Rotate the object around the available axes.
- Aperture — Adjust a camera’s focal length. Displays current focal length with prime lens indicator. (Camera-only)
- Cone — Adjust a spotlight’s cone angle. (Spotlights only)
- Scale — Scale an object when applicable.
- Pose Mode — Manual posing for Mixamo-compatible imported characters (see Posing).
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:
- Add Object: Add a Camera, Character, Prop, Wall, Light, or Custom Import directly onto the canvas.
- Freehand: Freehand drawing with Pen, Marker, and Eraser tools plus a color picker.
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:
- Off / Auto / Manual toggle to select focus mode.
- Visual focus point — tap an object to set focus. (Auto-only)
- Aperture (f-stop) slider controls aperture size. (Manual-only)
- Focus distance slider controls the distance within focus. (Manual-only)
Composition Guides — tap the composition button to toggle overlays:
- Rule of Thirds
- Quadrants
- Diagonals
- Reciprocal Diagonals
- Golden Ratio
CAM view UI elements:
| Element | Location | Target ID |
|---|---|---|
| Grid Lines toggle | Top-left corner | canvasCam.gridToggle |
| Title bar (Scene / Shot / Focal Length) | Top center, e.g. "A — FS / Zoom in / SL — 35 mm" | canvasCam.titleBar |
| Help | Top-right (? icon) | canvasCam.helpButton |
| Done | Top-right, exits CAM mode | canvasCam.doneButton |
| Composition guide picker | Left edge, vertical icon strip | canvasCam.compositionPicker |
| Adjust Lens (focal length slider) | Bottom, with the prime-lens dot strip and film-strip indicator | canvasCam.focalSlider |
| Adjust Focus (OFF / AF / MF) | Right edge, near the bottom | canvasCam.focusMode |
| Aperture (f-stop) slider | Right edge, above focus mode (Manual focus only) | canvasCam.apertureSlider |
| Focus distance slider | Right edge (Manual focus only) | canvasCam.focusDistanceSlider |
CAM gestures:
- Tap — Point CAM at the tapped location.
- 1-finger drag — Move camera on the X-Y plane (pan and lateral truck).
- 1-finger drag with vertical arrow — Move camera on the Z axis (dolly in/out).
- 2-finger drag — Rotate camera around its origin.
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:
- Animatics title bar — Replaces the standard title bar with scene/shot name, Done/Undo/Redo buttons.
- Continuing shot list — Side panel for managing the shot sequence within the animatic.
- Progress slider — Horizontal scrubber with keyframe indicators (visual dots marking keyframe positions).
- Play / Stop buttons for animation preview.
- Loop toggle — Continuously replay the animation.
- 2D / 3D / Fullscreen playback view buttons — Switch between overhead, 3D, and fullscreen preview during playback.
- Motion path visualisation — Position curves (spline paths), velocity curves, and timing markers (second markers on the path) appear in both 2D and 3D views.
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):
| Handle | What it does | Target 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 Menu | Horizontal 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:
- Translation arrows — Drag to move on XZ plane or Y axis.
- Rotation rings — Drag to rotate around X, Y, or Z axes, plus a Spin handle.
- Scale box — Drag to uniformly scale.
- Aperture handles — Adjust camera focal length or spotlight cone angle directly via the gizmo.
- Stretch handles — Resize walls and blocks along individual dimensions.
Object Context Menus
Open the horizontal context menu on any object:
- Mac: right-click the object.
- iPad / iPhone: tap the object. A single tap both selects it and reveals the menu. Tapping elsewhere (or starting to move/rotate the object) dismisses the menu silently — there's no close button.
Available actions depend on the object type:
- Common: Edit, Duplicate, Delete, Lock/Unlock, Hide/Unhide, Copy.
- Characters: Pose, Expression, Look At Point, Cast, Library.
- Camera/Lights: Monitor, Gobo, Tracking.
- Props: Shape, Set Piece, Mirror, Image, Face Camera.
- Groups: Group, Ungroup, PIP (Picture-in-Picture).
- Shots: Shot Movement, Shot Equipment, Shot Info, Fullscreen.
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:
- Group — Combine selected objects into a group.
- Add / Remove from Selection buttons.
- Ungroup All — Break apart all groups in the selection.
- Done / Cancel to confirm or discard the grouping operation.
- A 2D/3D mode switch is available during multi-selection.
Static Image & Video Overlays
Shots can display a static image or video instead of the live 3D render:
- Swap button — Toggle between live 3D and static image view.
- Import — Load images from Photos or Files.
- Revert to Live — Return to the live 3D camera render.
- Delete — Remove the static image.
- Video overlay — AI-generated or imported video plays in the shot view with a Revert to Live button.
- Prev / Next static images are shown alongside the current shot for context.
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.
- Select: Tap a thumbnail to jump to that camera setup.
- Reorder: Long-press and drag a shot up or down.
- Duplicate: The key to speed — build "Shot 1A" (Master), duplicate it to create "Shot 1B", then move the camera slightly. This preserves actor/prop continuity between shots.
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:
- Place Walls, Floors, Doors, and Windows to define interior and exterior spaces.
- Use the Gizmo to stretch walls to match the dimensions of your location.
- Walls support customizable textures, windows, and doors. Tap a wall, select Info from the contextual menu to access these options.
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 Type | Max per Shot |
|---|---|
| Props | 100 |
| Characters | 50 |
| Walls | 100 |
| Lights | 10 |
| Cameras | Multiple (one active at a time) |
| Doodle markups | 100 |
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.
- Tap the AR icon (top-right of canvas, next to the Animatic Mode running-figure icon).
- Scan: Point the device at the floor and move slowly to detect the plane.
- Anchor: Tap the grid to lock the virtual world to the real world.
- Block: Place virtual characters into your real environment.
- 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:
| Element | Location | Target ID |
|---|---|---|
| Back | Top-left (arrow). Exits AR mode. | arView.backButton |
| Shot label | Top center (e.g. "3A") | arView.shotLabel |
| Help (Previs Assist) | Top-right (? icon) | arView.helpButton |
| Reset AR | Top-right (eye icon). Re-scans the plane and re-anchors the scene. | arView.resetButton |
| Options | Top-right (gear icon) | arView.optionsButton |
| Add Shot | Bottom-left (+ icon). Captures the current AR framing as a new shot. | arView.addShotButton |
| Record Video | Bottom-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 toggle | Bottom-right (person icon). Switches between tabletop and life-size scaling. | arView.scaleToggle |
| Shot list strip | Right edge (collapsed shot thumbnails) | arView.shotList |
3D Model Import
Import custom 3D assets from external scanning or modeling tools:
- Scan a room using a 3D scanning app (e.g., Polycam, RealityKit) or create a model in Blender, Cinema 4D, Maya, etc.
- Export as
.glTFor.glb. - In Previs Pro, Import > 3D Model.
- 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
- Keep textures in the same folder as the
.gltffile when importing a multi-file glTF bundle. A single-file.glbembeds them automatically. - Keep polygon counts modest. Previs Pro auto-simplifies on import to fit the device’s memory budget, but a 5M-triangle photogrammetry scan can take a long time to process. If you have a tool like RapidPipeline, gridded mesh decimators in Blender (Modifier > Decimate), or the optimize/decimate export option in your scanning app, run it before importing. Aim for under ~200k triangles per single prop and under ~1M for a whole set.
- Use meters as the unit. glTF stores positions in meters by convention. If your source tool uses centimeters or inches, the imported object can land 100× too big or 0.025× too small. Either correct the export units or rescale once with the Scale gizmo in Previs Pro’s 3D Canvas.
- Apply transforms before export. In Blender, “Object > Apply > All Transforms” before exporting eliminates surprise pivots and rotations.
- One model per import. If you have a set built from many separate components, joining them in your DCC tool produces a cleaner single asset in Previs Pro and counts as one prop against the per-shot 100-prop limit.
- LiDAR scans. Polycam, Scaniverse, and similar apps can export
.glbdirectly — this is the recommended path for capturing real locations. See the Discontinued Features note on LiDAR for context.
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:
- ActorGen (AI) — the default. Generate custom characters from a text description. See ActorGen.
- Custom 3D models — import
.glbcharacters from external tools. Blend shape / morph target support is available on imported characters.
Posing
- Custom Posing: Tap a specific body part (Head, Arm, Spine) to rotate it manually. Currently available on ActorGen characters only — support for built-in characters is in development.
- Pose Library: Preset poses including Sitting, Driving, Running, Fighting, and more.
- Hand Presets: Detailed hand pose options.
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).
- Select a character.
- Tap Pose > PoseCap.
- Point the rear camera at a person, a photo, or even an image on a screen.
- Use the 5-second timer or tap the capture button on the right side.
- 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.
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).
- Add a character > select the ActorGen option.
- Enter a text description of the character (e.g., "tall woman in a red dress, professional, 30s").
- A preview image generates first, with the option to Regen if needed.
- The system generates the full 3D model, then automatically rigs it with a skeleton.
- Generation stages: Submitting → Queueing → Generating → Rigging → Downloading (~120 seconds total).
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
| Sensor | Notes |
|---|---|
| Full Frame (35mm) | Default. Standard cinema reference. |
| Super 35 | Most common cinema format. |
| Canon APS-C | 1.6x crop factor. |
| Nikon APS-C | 1.5x crop factor. |
| Micro 4/3 | 2x crop factor. |
| Alexa LF Open Gate | Large format cinema. |
| iPhone 11 | Mobile camera simulation. |
| Standard 16mm | Documentary / indie format. |
| Super 16mm | Wider 16mm variant. |
| 2/3" Video | Broadcast video format. |
Focal Length
- Full slider control with haptic feedback that clicks at 17 standard prime focal lengths from 10mm wide to 270mm telephoto (10, 15, 20, 24, 28, 32, 35, 40, 50, 65, 70, 85, 100, 105, 135, 200, 270 mm).
- Field of view is calculated from the focal length and sensor size, matching real-world optical behavior.
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.
- Add a second camera to the shot the same way you add the first: pencil tool → Add Objects tray → Camera.
- Position and frame each camera independently.
- 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
| Type | Description | Examples |
|---|---|---|
| Lantern | Omni-directional point lights | Default Lantern, Practical Lantern |
| Spotlight | Directional cinema lights | Fresnel, Ellipsoidal, PAR, Open Face, Fluorescent, LED Panel, Ring Light, Scoop, Cyc |
| Directional / Sun | Infinite directional source | Flood 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:
- Flashlight patterns (Regular, Irregular)
- Spotlight patterns (Soft, Hard, Uneven, Noisy, Rays)
- Fence silhouettes
- Tree silhouettes
- Window blind patterns
- Square mesh / signage patterns
How to add a gobo
- Place a spotlight in your scene (Add Objects tray → Light).
- Open the light's context menu — right-click on Mac, or tap the light on iPad/iPhone.
- Tap Gobo.
- 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:
- Select shots in the Enhance Shot panel, then click Edit Prompt.
- Describe the atmosphere: "Cyberpunk city, neon blue and pink", "Moody Film Noir, high contrast", "Golden hour, warm backlight".
- The AI models (FLUX, Seedream, Nano Banana) interpret lighting, color grading, and atmosphere from your text — no manual light placement required.
- Combine with the Touch Up feature for targeted refinements to specific shots.
Timeline · Updated
Where to find it
- Panel: Canvas Editor → top toolbar → clapperboard icon (right side). The Timeline opens in its own panel and replaces the canvas until you tap Back.
- Target ID:
canvasEditor.directorViewButton(entry),timeline.root(panel)
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.
| Element | Location | Target ID |
|---|---|---|
| Back | Top bar, far left (arrow). Returns to Canvas Editor. | timeline.backButton |
| Title bar ("Timeline Review") | Top bar, center | timeline.titleBar |
| Help (Previs Assist) | Top bar, right (? icon) | timeline.helpButton |
| Share / Export | Top bar, far right (share icon) | timeline.shareButton |
| Script Panel toggle | Header row, far left (document icon) | timeline.scriptToggle |
| Scene Selector | Header row, left ("All Scenes ▾") | timeline.sceneSelector |
| Project title | Header row, center (e.g. "Example") | timeline.projectTitle |
| Approval Status | Header row, right ("Pending ▾", color-coded) | timeline.approvalStatus |
| Comment Panel toggle | Header row, far right (speech-bubble icon, strobes when unread) | timeline.commentToggle |
| Viewer | Large image/video display below the header, letterboxed to aspect ratio | timeline.viewer |
| Viewer fullscreen | Top-right of viewer (expand-corners icon, also F) | timeline.viewer.fullscreen |
| Viewer H-Menu | Bottom-right of viewer (kebab/three-dot icon). See Shot H-Menu. | timeline.viewer.hMenu |
| Info Bar | Thin row under the viewer, e.g. "EXT. NEW YORK STREET SET — DAY · Shot A · 10mm · f/5.6" | timeline.infoBar |
| AI Enhance gutter | Left edge, top (sparkle icon). Toggles the Enhance Shot panel. Shortcut Alt+I. | timeline.gutter.enhance |
| Audio gutter | Left edge, below Enhance (speaker icon). Toggles the Audio Workspace. | timeline.gutter.audio |
| Time ruler | Horizontal MM:SS markings above the shot lane | timeline.ruler |
| Shot lane | Primary horizontal row of shot cards | timeline.shotLane |
| Scene marker | Pill above the shot lane (e.g. "4. NEW YORK STREET SET"). Click to rename or recolor the scene. | timeline.sceneMarker |
| Transition handle | Diamond marker between adjacent shot cards. Click to change transition type. | timeline.transitionHandle |
| Playhead | Vertical red line across the lanes | timeline.playhead |
| Audio lanes | Below 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 Forward | Bottom transport, left | timeline.transport.prev / play / next |
| Timecode | Bottom transport, current / total (e.g. "01:14.8 / 02:20.6") | timeline.transport.timecode |
| Step toggle | Bottom transport (pauses at each shot boundary during playback) | timeline.transport.stepToggle |
| Zoom slider | Bottom transport, next to Step (pixels-per-second 20–300) | timeline.transport.zoom |
| Credit balance | Bottom transport, right (number + globe icon, e.g. "473") | timeline.transport.credits |
| Export | Bottom transport, right of credits | timeline.transport.export |
| Share | Bottom 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
- Left: Scene Selector pill — shows current scene name/number or "All Scenes".
- Center: Project title / branding.
- Right: Approval status dropdown (Pending / Approved / Notes) for the current shot, color-coded. Comment toggle button with a notification strobe effect when unread comments exist. Script panel toggle (R) to show/hide the screenplay sidebar.
2. Viewer Area
The large display showing the current shot. Letterboxed to the project's aspect ratio. Content depends on context:
- Default: Shot thumbnail (3D render from Unity or AI-generated image).
- Video shot: Plays the attached video clip with poster frame on pause.
- Enhance Shot open: Replaced by the Enhance Shot panel (Style Grade / Touch Up / Import tabs).
- Audio Workspace open: Replaced by the Audio Workspace (Scratch / Record / Import tabs).
Viewer Edit Overlay
A pencil icon in the bottom-right of the Viewer expands on click to reveal quick-action buttons:
- Draw — Enter drawing/annotation mode (D).
- Record — Open the Audio Workspace Record tab.
- TTS — Open the Audio Workspace Scratch tab.
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:
- Model selector — Dropdown with three tiers (Fast / Quality / Best) showing model name and credit cost per tier.
- Info rows — Output resolution, duration limits, and total cost for the selected model.
- Include Shot Metadata toggle — Whether to feed camera/lighting metadata into the AI prompt.
- Auto-Retime toggle (video mode) — Extend shot duration to match generated video length.
- Generate Audio checkbox (video mode) — Simultaneously generate synchronized TTS with optional hint text.
- Prompt editor — Collapsible textarea with disclosure arrow to view/edit the auto-generated prompt.
- History button — Access generation history from the popover.
- Cancel / Generate buttons.
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:
- Spinner animation.
- Countdown timer (e.g., "Est. 45s remaining") or "Processing..." when time is unknown.
- Hint text: "Please wait, this may take a minute".
Enhancement Preview (Before / After)
After AI image enhancement, a split-view comparison overlay appears:
- Draggable divider — Slide left/right to compare original vs. enhanced image.
- Before / After labels on each side.
- Prompt input below the slider for editing the prompt before retrying.
- Accept / Retry / Dismiss buttons.
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.
- Swipe navigation — Swipe left/right to move between shots (hardware-accelerated virtual slides).
- Minimal transport controls overlay at the bottom.
- Press F or Escape to exit.
3. Info Bar
A thin black bar between the Viewer and the Shot Lane. Displays:
- Scene heading:
INT. OFFICE — NIGHT(location type, scene name, time of day). - Shot metadata: Shot number • focal length (mm) • f-stop • shot size • angle • movement, joined by bullets.
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:
- Scene color: Background tint matching the scene's assigned color for visual grouping.
- Thumbnail: The shot's image (3D render, AI-generated, or imported).
- Shot number: Displayed in the lower-right corner (e.g., "1A", "2B").
- Duration: Text overlay showing length (e.g., "5.3s").
- Sparkle badge: Indicates an AI-enhanced shot (Style Grade or Touch Up applied).
- Play badge: Triangle icon indicates a video is attached to the shot.
- Comment dot: Color-coded by approval status — gray (pending), green (approved), amber (notes).
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:
- Dialog (Lane 0) — Character dialogue.
- Music (Lane 1) — Score, background music.
- SFX (Lane 2) — Sound effects.
- Voiceover (Lane 3) — Narration, commentary.
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):
- Gutter buttons: Enhance Shot toggle (sparkle icon) and Audio Workspace toggle (waveform icon).
- Skip Back: Jump to start of current/previous shot.
- Play / Pause: Large central button.
- Skip Forward: Jump to start of next shot.
- Timecode: Current position in MM:SS.S format.
- Shuttle speed indicator: Shows "2x ▸" or "0.5x ◂" when shuttle is active (J/K/L keys).
- Step toggle: Pauses at each shot boundary during playback for shot-by-shot review.
- Zoom In / Out: Adjusts pixels-per-second (range 20–300) to see more or fewer shots.
- Review Mode badge: "REVIEW MODE" label visible when in read-only review.
- Connection status: Online/offline indicator with session ID (review/embedded modes).
- Menu buttons: Help (?), Export/Share (G), Account (shows credit balance).
Side Panels
Three optional right-side panels, toggled independently:
- Comment Panel (C) — Shot-level comments, threaded replies, annotations. See Comments.
- Script Panel (R) — Screenplay text for the current scene, synced to playhead. Auto-opens when a scene has screenplay content. See Script Panel.
- Generation History (H) — Browse all AI-generated assets. See Generation History.
Shot Management
Selecting & Navigating
- Click/tap any shot bar to select it. The viewer jumps to that shot and the playhead moves to the shot's start.
- Arrow keys: ← / → seek frame-by-frame.
- Click the ruler: Seek to a specific timecode.
- Scrub: Click and drag on the ruler to scrub through time.
Duration Editing
- Drag the right edge of a shot bar to extend or shorten its duration.
- The timeline auto-scrolls when dragging past the screen edge.
- Visual feedback shows the new duration during the drag.
- Undo (Cmd+Z) reverts any duration change.
Shot Reordering
Shots can be reordered within their scene by dragging:
- Long-press (or click and hold) a shot bar until the drag activates.
- Drag horizontally to a new position within the same scene.
- A drop indicator shows where the shot will land.
- Release to commit the reorder. Auto-scrolls at screen edges.
Shot H-Menu (Quick Actions)
Click/tap a shot's thumbnail area in the viewer to reveal the horizontal quick-action menu:
- Revert — Remove AI enhancement, return to original/live 3D render. Visible when the shot has a
historyId, static image, or video attached. - Copy — Copy the shot to the clipboard (preserves everything including animatics). See Duplicating vs. Copying.
- Paste — Paste the copied shot after the current shot. Only visible when a shot is on the clipboard.
- Poster — Set the poster frame for video shots (choose which frame shows as thumbnail).
- Comment — Open the comment panel focused on this shot.
- Enhance — Open the Enhance Shot panel with this shot pre-selected for style grading or touch up.
- Speech — Open the Audio Workspace Scratch tab for TTS dialogue generation.
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:
| Method | How | What 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. |
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
| Value | AI Prompt Mapping |
|---|---|
| ECU | extreme close-up |
| Choker | choker close-up |
| Close-Up | close-up |
| Med CU | medium close-up |
| Medium | medium shot |
| Cowboy | cowboy shot |
| Med Full | medium full shot |
| Med Wide | medium wide shot |
| Full | full shot |
| Wide | wide shot |
| Long | long shot |
| Extreme Wide | extreme wide shot |
| Extreme Long | extreme long shot |
| Establishing | establishing shot |
| Aerial | aerial shot |
Shot Angle
| Value | AI Prompt Mapping |
|---|---|
| Eye Level | eye level |
| Low Angle | low angle |
| High Angle | high angle |
| Hip Level | hip level |
| Knee Level | knee level |
| Ground Level | ground level |
| Shoulder Level | shoulder level |
| Bird's Eye | bird's eye view |
| Dutch | dutch angle |
| Overhead | overhead |
| Aerial / Helicopter / Drone | aerial / helicopter / drone shot |
| OTS | over-the-shoulder |
Shot Movement
| Value | AI Prompt Mapping |
|---|---|
| Static | static locked-off shot |
| Dolly In / Out | camera pushing in / pulling out |
| Pan Left / Right | panning left / right |
| Tilt Up / Down | tilting up / down |
| Crane Up / Down | crane shot rising / descending |
| Steadicam | smooth tracking shot |
| Handheld | handheld, natural movement |
Shot Framing
Examples: SS (single shot), 2S OTS (two-shot over-the-shoulder). Displayed in the Info Bar.
Additional Per-Shot Data
- Focal length (mm) — from the virtual camera lens setting.
- F-Stop — aperture setting, affects depth of field.
- Cast — characters visible in the shot, with name, gender, and expression (e.g., "Joy", "Neutral").
- Notes — free-text notes attached to the shot.
- Coverage color — hex color for visual identification (used in future script lining feature).
Scene Selector
The scene selector pill in the top-left corner controls which portion of the project is visible in the timeline:
- All Scenes (default) — The entire project timeline is displayed end-to-end.
- Individual Scene — Click the pill to open a dropdown, then select a specific scene. The timeline shows only that scene's shots.
- Progressive loading: In large projects, scenes load incrementally. Greyed-out entries in the dropdown are still loading.
- Approval indicator: The scene pill turns green when every shot in the active scene is approved.
Each scene in the project has:
- Scene number — auto-generated or manually set (see Numbering).
- Name — typically the location from the screenplay slugline.
- Location type — INT (interior) or EXT (exterior).
- Time of day — DAY, NIGHT, etc.
- Color — assigned for visual differentiation in the shot lane.
- Screenplay — optional structured screenplay data (dialogue, action, transitions).
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:
- Letters (default): A, B, C, ... Z, AA, AB, ... using bijective numeration.
- Digits: 1, 2, 3, ...
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:
- NumberLetter:
1A,1B,2A - LetterNumber:
A1,B1,A2
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
| Action | Control |
|---|---|
| Play / Pause | Space or Play button |
| Skip Back | Skip button or Home (jump to start) |
| Skip Forward | Skip 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:
| Key | Action |
|---|---|
| L | Play forward. Press again to increase speed (2x, 4x, 8x). |
| J | Play reverse. Press again to increase reverse speed. |
| K | Stop / return to normal speed. |
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:
| Type | Description |
|---|---|
| Cut | Instant switch with no duration. The default. |
| Dissolve | Crossfade between the two shots. |
| Fade to Black | Current shot fades to black, then the next shot fades in from black. |
| Fade from Black | Variation 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:
- Regenerate button (↻) — Re-generate the transition with a new seed.
- Countdown timer — Shows remaining seconds during generation.
- Remove button (×) — Delete the generated transition.
Viewer Modes & Workspaces
The Viewer area can switch between several modes. Only one workspace can be open at a time:
| Mode | Trigger | What it shows |
|---|---|---|
| Default Viewer | Close all workspaces | Shot thumbnail/video with edit overlay, doodle annotations |
| Enhance Shot | Gutter sparkle button or Alt+I | Style Grade / Touch Up / Import tabs with shot grid |
| Audio Workspace | Gutter waveform button or Alt+A | Scratch / Record / Import tabs for audio |
| Fullscreen | F | Maximized 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:
- Cmd+Z — Undo.
- Cmd+Shift+Z — Redo.
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:
- Panels stack vertically instead of side-by-side.
- Single audio lane display (instead of 4 expanded lanes).
- Touch-optimized controls with larger hit targets.
- Comment panel opens as a full-screen portal.
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:
- Script Panel: Only controls scale (text stays the same size for readability).
- Screenplay Manager: Everything scales (fonts, padding, gaps, control sizes).
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:
- The SQLite database.
- A dot-prefixed cache folder (
.hash/) with thumbnail JPEGs and videos (42.jpg,42.mp4). - Hash sidecar files (
.jpg.hash) that track scene state to avoid unnecessary re-renders.
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
- Panel: Timeline → left gutter → speaker icon (second of the two gutter buttons; turns red when active). The panel replaces the Viewer area; tap the close
Xat top-right or the gutter speaker again to dismiss. When open, the project-title row shows the banner "PREVIS AUDIO SYSTEM" and the timeline expands the four audio lanes (DIALOG / MUSIC / SFX / VOICEOVER). - Target ID:
timeline.gutter.audio(entry),audio.root(panel) - Shortcut: Option+A (macOS)
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.
| Element | Location | Target ID |
|---|---|---|
| Create tab | Top of panel, left (active tab is underlined) | audio.tab.create |
| Record tab | Top of panel | audio.tab.record |
| Import tab | Top of panel | audio.tab.import |
| Close panel | Top of panel, far right (X) | audio.closeButton |
| Audio type picker | Top-left of Create tab ("Dialogue ▾" / Music / SFX / Voiceover) | audio.create.typePicker |
| Model picker | Next to type ("Best 3cr ▾" for ElevenLabs, "Fast 2cr" for Kokoro on dialogue) | audio.create.modelPicker |
| Scope picker | Next to model ("All Scenes ▾" / Selected Scene / Selected Shot / Custom) | audio.create.scopePicker |
| Cast list | Block of rows below the pickers, one row per character with a voice dropdown and a speaker-preview icon | audio.create.castList |
| Cast row — voice picker | Dropdown per character (e.g. "Bill", "Daniel", "Rachel"). Tap to choose a voice from the model's voice pool. | audio.create.castList.voice |
| Cast row — preview | Speaker 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 checkbox | Bottom-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 dialogue | Bottom-left, next to Retime | audio.create.overwrite |
| Generate button | Big 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 textarea | Replaces the cast list for Music, SFX, and Voiceover types. Freeform text describing the desired sound. | audio.create.promptInput |
| Duration slider | Below the prompt for Music (3–15s) and SFX (1–22s) | audio.create.durationSlider |
| Lane label — DIALOG | Far-left of timeline, Lane 0 label (visible only when Audio Workspace is open) | timeline.audioLanes.dialog |
| Lane label — MUSIC | Lane 1 | timeline.audioLanes.music |
| Lane label — SFX | Lane 2 | timeline.audioLanes.sfx |
| Lane label — VOICEOVER | Lane 3 | timeline.audioLanes.voiceover |
| Audio clip | A 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:
- All Scenes — Generate dialogue across the entire project.
- Selected Scene — Only the active scene.
- Selected Shot — Single shot (requires Script Coverage enabled).
- Custom — Freeform text entry for voiceover/narration.
TTS Voice Models
| Model | Speed | Cost | Voices |
|---|---|---|---|
| Kokoro (Fast) | ~3s per line | 2 credits/line | 8 voices (Heart, Bella, Jessica, Nicole, Nova, Adam, Eric, Michael) |
| ElevenLabs (Best) | ~8s per line | 3 credits/line | 20+ 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
- Enter a text prompt describing desired music (e.g., "tense cinematic strings, 140 BPM").
- Select duration: 3–15 seconds.
- 40 credits per generation (ElevenLabs Music).
- Placed on the Music lane.
SFX Generation
- Enter a text prompt (e.g., "door slam, wooden door").
- Select duration: 1–22 seconds.
- 5 credits per generation (ElevenLabs SFX).
- Placed on the SFX lane.
Generation Options
- Retime to Match Speech: Automatically extends shot duration if speech overflows (1s padding each side, 0.3s gap between clips).
- Overwrite Existing: Re-generate over existing clips on the lane.
- Skip Approved: Skip shots marked approved (when Script Coverage is enabled).
Record Tab
- Click the red Record button.
- 3-2-1 countdown (800ms per count).
- Speak into the microphone; elapsed time is displayed.
- Click Stop.
- 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
| Lane | Color | Purpose |
|---|---|---|
| Dialog (Lane 0) | Blue | Character spoken dialogue |
| Music (Lane 1) | Pink | Background music, score |
| SFX (Lane 2) | Green | Sound effects, ambient |
| Voiceover (Lane 3) | Orange | Narration, commentary |
Clip Interactions
- Horizontal drag: Slide clip left/right along the timeline.
- Vertical drag: Move clip to a different lane (when expanded).
- Trim handles: Drag left/right edges to trim clip start/end.
- Volume: Hover to reveal volume slider (0–100%, default 75%).
- Rename: Click info button to rename the clip.
- Delete: Click × button to remove.
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:
| Family | Access point | Where in the UI |
|---|---|---|
| Image & Video | Enhance Shot panel | Timeline Review — gutter sparkle button or Alt+I |
| Audio (TTS, Music, SFX) | Audio Workspace > Scratch tab | Timeline Review — gutter waveform button or Alt+A |
| 3D Props | Generate AI Prop | Add menu > Generate AI Prop |
| 3D Characters | ActorGen | Add 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:
- Images: FLUX.2 Turbo, Seedream 4.5, and Nano Banana 2 (via fal.ai).
- Video: Wan 2.1, Veo 3.1 Fast, Seedance 2.0, and (legacy) Kling V3 (via fal.ai).
- TTS / dialogue: Kokoro and ElevenLabs.
- Music & SFX: ElevenLabs Music and ElevenLabs SFX v2.
- 3D props and characters: Tripo3D (text-to-3D, with Mixamo-style auto-rigging for characters).
- Touch-Up image editing: Nano Banana 2.
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
- Panel: Timeline → left gutter → sparkle icon (top of the two gutter buttons). The panel replaces the Viewer area; tap the close
Xat top-right or the gutter sparkle again to dismiss. - Target ID:
timeline.gutter.enhance(entry),enhance.root(panel) - Shortcut: Alt+I
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:
- Style Grade — Batch image and video generation with style presets (Photo / Sketch) and editable prompts. Supports All Shots / Selected Scenes / Selected Shots scope.
- Touch Up — Targeted prompt-based refinement of a single shot's existing image (e.g., "make the lighting warmer", "add a beard").
- Import — Drop in external images or videos as shot replacements.
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.
| Element | Location | Target ID |
|---|---|---|
| Style Grade tab | Top of panel, left (active tab is underlined) | enhance.tab.styleGrade |
| Touch Up tab | Top of panel | enhance.tab.touchUp |
| Import tab | Top of panel | enhance.tab.import |
| Close panel | Top of panel, far right (X) | enhance.closeButton |
| Type picker | Top-left of Style Grade tab ("Image ▾" / "Video ▾") | enhance.typePicker |
| Model picker | Next to Type ("Best 8cr ▾", shows tier + per-shot credit cost) | enhance.modelPicker |
| Scope picker | Next to Model ("Choose Shots ▾" / "All Shots" / "Selected Scenes") | enhance.scopePicker |
| Style preset — PHOTO | Style row, leftmost | enhance.style.photo |
| Style preset — SKETCH | Style row, middle | enhance.style.sketch |
| Edit Prompt | Style row, right (pencil icon). Opens a popover to customize the auto-generated prompt. | enhance.editPrompt |
| Enhance Shot button | Big red button below the pickers, shows estimated cost + time (e.g. "~8cr · 59s") | enhance.enhanceButton |
| Shot Preview | Large image at the top-right of the panel showing the currently-targeted shot | enhance.shotPreview |
| Shot Grid | Virtualised grid of shot thumbnails below the preview. Tap to (de)select, double-click for fullscreen. | enhance.shotGrid |
| Shot Grid cell | Each 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:
- All Shots — Every shot in the project.
- Selected Scenes — All shots in selected scene(s).
- Selected Shots — Only manually tapped shots in the grid.
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
- Skip Approved Shots — Bypass shots with approved status.
- Overwrite Existing — Re-generate over previously enhanced shots.
- Style Presets: Photo or Sketch.
- Edit Prompt: Opens a popover where you can customize the auto-generated prompt.
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).
| Model | Tier | Cost | Speed |
|---|---|---|---|
| FLUX.2 Turbo | Fast | 3 credits | ~8 sec |
| Seedream 4.5 | Quality | 5 credits | ~25 sec |
| Nano Banana 2 | Best | 8 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.
| Model | Tier | Cost | Resolution | Duration |
|---|---|---|---|---|
| Wan 2.1 | Fast | 30 credits | 720p | 3–6 sec |
| Veo 3.1 Fast | Quality | 50 credits | 720p | 4, 6, or 8 sec |
| Seedance 2.0 New | Best (default) | 75 credits | 720p | 4–10 sec |
| Kling V3 | Best (legacy) | 75 credits | 1080p | 3–15 sec |
New installs default to Seedance 2.0. Kling V3 remains available in the model picker.
Video Options
- Generate AI Audio: Simultaneously generate synchronized dialogue/narration.
- Audio Direction Hint: Optional text to guide audio mood (e.g., "dramatic music underneath").
- Retime to Match Video: Extend shot durations to match generated video length.
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).
- Switch to the Touch Up tab.
- Tap a shot in the grid to select it as the target.
- Enter a prompt describing the edit (e.g., "make the lighting warmer", "add a beard").
- Generate. The current image is used as input; the AI applies the specified changes.
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:
| Type | Model | Cost | Notes |
|---|---|---|---|
| Dialogue (TTS) | Kokoro Fast | 2 credits / line | Fast tier |
| Dialogue (TTS) | ElevenLabs Best | 3 credits / line | Higher quality |
| Music | ElevenLabs Music (text-to-music) | 40 credits | Force-instrumental, queue-based |
| SFX | ElevenLabs SFX v2 (text-to-sound-effect) | 5 credits | Sync, max 22s |
| Voiceover | (uses Dialogue TTS models) | 2–3 credits / line | Routed 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
- Open Add > Generate AI Prop.
- Enter a text description (e.g., "wooden chair", "glass vase").
- Generation stages: Submitting → Queueing → Running → Downloading (~60 seconds).
- Result: a
.glbmodel 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)
- Add a character > select the ActorGen option.
- Enter a text description. Preview generates first, with Regen option.
- Generation stages: Submitting → Queueing → Generating → Rigging → Downloading (~120 seconds).
- Result: a rigged
.glbmodel 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.
- Access via H key or "Use Saved Audio" button in model dropdown.
- Filter by type: All, Image, Video, TTS.
- Asset badges: Image Video Speech Music SFX
- Actions: re-apply to a different shot, view prompt, download, revert.
- Delete: Individual asset delete, plus Bulk Delete Unused to clean up assets not linked to any shot.
- "Use Saved Audio" button in the Audio Workspace opens the history filtered to audio assets.
- Video thumbnails auto-extracted from the 0.5s mark (or 25% of duration if shorter).
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
| Category | Feature | Model | Credits |
|---|---|---|---|
| Image | Style Grade | FLUX.2 Turbo (Fast) | 3 |
| Style Grade | Seedream 4.5 (Quality) | 5 | |
| Style Grade | Nano Banana 2 (Best) | 8 | |
| Video | Video Gen | Wan 2.1 (Fast) | 30 |
| Video Gen | Veo 3.1 Fast (Quality) | 50 | |
| Video Gen | Seedance 2.0 (Best, default) | 75 | |
| Video Gen | Kling V3 (Best, legacy) | 75 | |
| TTS | Dialogue | Kokoro (Fast) | 2 per line |
| Dialogue | ElevenLabs (Best) | 3 per line | |
| Music | Music Gen | ElevenLabs Music | 40 |
| SFX | SFX Gen | ElevenLabs SFX | 5 |
| Touch Up | Image Edit | Nano Banana 2 | 8 |
| 3D | Prop Gen | AI 3D | 15 |
| Character Gen | AI 3D + Rigging | 26 * |
* 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.
Credit Packs
Purchase additional credits anytime. Exchange rate: 100 credits = $1.00.
| Pack | Credits | Price | Badge |
|---|---|---|---|
| Starter | 100 | $4.99 | Top Off |
| Standard | 400 | $14.99 | Most Popular (25% savings) |
| Pro | 1,200 | $39.99 | Best 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.
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.).
| Plan | Price | Notes |
|---|---|---|
| Free | $0 | Limited: watermarked exports, limited animatics. |
| Monthly | $39.99/month | Full access, cancel anytime. |
| Annual | $119.99/year | $9.99/month billed yearly. |
| Lifetime | $359.99 | One-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.
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:
- You bought the Annual plan, not Lifetime. Open the App Store > your name > Subscriptions > Previs Pro to see exactly which plan is active. The Annual plan is $119.99/year and renews automatically.
- You had an Annual subscription that hasn't been canceled yet. Buying Lifetime does not automatically cancel an existing recurring subscription — Apple does not let one IAP cancel another. Cancel the Annual sub manually (steps below); the Lifetime entitlement stays in place permanently.
- You're seeing a credit pack receipt, not a subscription. Credit packs (Starter $4.99, Standard $14.99, Pro $39.99) are one-time IAPs and look like subscription charges in some email receipts. They are not recurring.
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:
- Go to reportaproblem.apple.com and sign in with the Apple ID you used to purchase.
- Find the Previs Pro charge in your purchase history.
- 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").
- 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.
- Find every receipt at reportaproblem.apple.com, or in the original email from
no_reply@email.apple.comwith subject "Your receipt from Apple". - For a VAT-compliant invoice (required in the EU, UK, and several other regions), download the PDF invoice linked at the bottom of the Apple receipt email. Apple's invoice carries the VAT registration of Apple Distribution International, which is the correct merchant for App Store sales.
- If your accounting team needs an invoice in a different format, Apple's invoice is the document of record. Previs Pro cannot issue a separate invoice for an Apple-mediated purchase.
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:
- On each device, install Previs Pro from the App Store while signed into the same Apple ID you used to purchase.
- In Previs Pro, tap Sign In and complete Sign In with Apple. Use the same Apple ID on every device.
- 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.
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:
- Open the purchasing dialog in Previs Pro and tap Restore Purchases. This asks Apple to re-deliver any active subscription on the signed-in Apple ID.
- On Mac, confirm the App Store is signed in with the right Apple ID: App Store > (your name in lower-left) > Account Settings.
- Sign out of Previs Pro and sign back in with the same Apple ID.
- If Restore Purchases doesn’t bring the subscription across after all of the above, write us at hello@previspro.com with the Apple receipt number and the Apple ID you used to purchase.
"I paid — why are my exports still watermarked?"
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:
- Sign in (Settings > Account > Sign In) with the Apple ID or sign-in method tied to your purchase.
- Tap Restore Purchases in the upgrade dialog.
- Pull down to refresh the project list, then try the export again.
- If you bought on a different device or under a different Apple ID, see Using One Subscription on Mac, iPad and iPhone above.
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.
Earn Free Credits
The Earn Credits dialog offers three ways to earn credits without purchasing:
| Reward Type | Amount | Frequency |
|---|---|---|
| Refer a Friend | +50 credits (both you and your friend) | Up to 5 referrals per month |
| Social Share | +25 credits | Once per 7-day cooldown |
| Share Reviewer Link | +25 credits | One-time reward |
Referral System
- Every user gets a unique 8-character referral code.
- Share it directly or via a referral link:
share.previspro.com?ref=CODE - When someone signs up with your code, both parties earn 50 credits.
- The Earn Credits dialog shows stats: Total Referrals, This Month (X/5), Credits Earned.
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.
- Final Draft —
.fdx,.fdxt - Fountain —
.fountain,.txt(auto-detected) - Open Screenplay Format —
.osf - Fade In —
.fadein - Celtx —
.celtx
What gets extracted
- Scenes — one scene per Scene Heading (slugline), with INT/EXT, location, and time of day parsed out.
- Cast — every character name that appears above a dialogue block is added to the project's cast list.
- Dialogue, Action, and Transitions — preserved as structured screenplay elements per scene, with parentheticals and extensions (V.O., O.S.).
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.
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:
- AI generation features (Style Grade, Touch Up, dialogue TTS, etc.) send the relevant prompt and shot context through Previs Pro’s edge function to the third-party model provider listed in Models & Providers. Those models receive only the prompt for the specific generation, not the entire screenplay.
- Publish to Web / Share for Review uploads the bits of the project needed for browser playback (shot stills, dialogue text, audio clips, etc.) to our review-link infrastructure. If you don’t publish, nothing leaves the device.
- iCloud Drive, if you save your
.previsfile there, syncs through Apple’s infrastructure under their privacy policy — not ours.
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:
- Scene Manager — each slugline becomes a scene with its name, INT/EXT, and time of day prefilled.
- Cast Menu — every speaking character is added automatically. You can assign 3D characters to script names from there.
- Script Panel in the Timeline — press R to toggle a sidebar showing the screenplay for the current scene, synced to the playhead. See Script Panel & Script Lining below.
- AI Audio Generation (Scratch tab) — dialogue lines feed straight into TTS. Assign each cast member a voice and generate scene- or project-wide scratch audio. See Scratch tab.
- Screenplay Manager button — available from the Scene View toolbar (whenever you're not in scene-selection mode). This opens the dedicated panel described below.
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
- Scene list showing scene number, name, and screenplay element counts.
- Inline editing of scene names and screenplay text.
- Drag-to-reorder: Drag scenes to change their position in the timeline.
- Drag-to-merge: Drag one scene onto another to merge them (with confirmation dialog).
- Search/filter across character names, dialogue text, and action text.
- Expandable/collapsible scenes to show screenplay details.
Character Tab
- List of all characters with dialogue count and scene appearance count.
- Expandable character details showing all dialogue lines across scenes.
- Drag-to-merge characters: Consolidate duplicate character names (updates all dialogue references).
- Per-character inline dialogue editing.
Editable Elements
- Dialogue: Character name + text + optional parenthetical / extension (V.O., O.S.)
- Action: Scene descriptions and stage directions.
- Transitions: CUT TO, FADE OUT, etc.
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
- Green solid: Scene unchanged.
- Green dotted: Scene matched but elements differ — tap to drill into the element-level view.
- Red: Scene removed (in baseline, missing now).
- Blue "Added": New scene (not in baseline).
- Orange dashed lines: Connect baseline → current scenes with changes.
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.
- CHANGED badge — the element exists on both sides but its content differs.
- MOVED badge — identical content, but its position in the scene changed.
- ADDED badge — new element, not in the baseline.
- REMOVED badge — was in the baseline, now gone.
- CHANGED & MOVED — both content and position changed (dashed border).
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.
- Open the Screenplay Manager from the Scene View.
- Tap Import New Version in the top-right of the manager (or from inside the View Changes view).
- 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.
- Drag-to-reorder the incoming column. If you want a new scene to land somewhere other than where the script puts it, drag it. Long-press on touch devices, drag-and-drop on desktop. Each drop writes a full explicit ordering, so successive reorders compose cleanly.
- Reject individual changes. Added and removed scene cards have an Approved checkbox in the footer (defaults to checked). Uncheck it and confirm to:
- Skip an addition — the new scene is dropped from the merge.
- Cancel a removal — the scene stays in the project even though the new draft omits it.
- Drill into element-level changes. Tap any modified scene card to inspect dialogue/action edits with the badges and connectors described above.
When the review reflects what you want, tap Apply. Cancel discards the merge plan and leaves the project untouched.
Script Panel & Script Lining
Where to find it
- Panel: Timeline → header row, far left → document icon (tooltip: "Toggle script panel"). The panel opens as a left sidebar showing the screenplay for the current scene, synced to the playhead. It auto-opens when a scene has imported screenplay content.
- Target ID:
timeline.scriptToggle(entry),scriptPanel.root(panel) - Shortcut: R
Script Panel
Displays the screenplay for the current scene in the left sidebar, synced to the playhead position. Supports:
- Structured rendering with color-formatted dialogue, action, and transitions.
- "Punch Up" mode for free-form text editing.
- Annotations (pen, highlighter, eraser) with per-page overlay persistence.
- Comments tied to screenplay pages.
- Auto-scroll during playback.
Script Panel UI elements
| Element | Location | Target ID |
|---|---|---|
| Header date | Top 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 panel | Top-right of panel (X) | scriptPanel.closeButton |
| Scene heading | First bold line of the body (e.g. "EXT. NEW YORK STREET — DAY") | scriptPanel.sceneHeading |
| Script body | Monospaced screenplay text below the heading. Auto-scrolls during playback. | scriptPanel.body |
| SCRIPT tab | Bottom of panel, left (active tab is underlined red) | scriptPanel.tab.script |
| PUNCH UP tab | Bottom 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.
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.
Workflow:
- Set "Start" position (Keyframe A).
- Scrub the progress slider forward — keyframe indicators (dots) appear on the slider marking set positions.
- Move the Camera or Actor.
- 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").
Playback
- Play / Stop buttons preview the animation.
- Loop toggle for continuous replay.
- 2D / 3D / Fullscreen buttons to switch between overhead, 3D, or fullscreen playback views.
- Progress slider with dual-state graphics (different appearance when playing vs. scrubbing).
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.
- Layouts: Six-Up, Two-Up, Annotated, Full (one-per-page).
- Data included: Dialogue, Action Notes, technical metadata (Lens, Camera Height).
- Format options: JPEG or PNG for individual frames.
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
- Animatic shots render as a still rather than the moving keyframe. Animatic Mode keyframes drive playback inside the app but only the first frame is baked into a still-shot MP4. To get the moving version, use the Animatic Export path (Animatics Mode > Export) which renders the in-between frames, or include rendered videos in the HTML Player.
- "Graphic breaks" or blank frames between shots. If a shot has no rendered thumbnail or has been recently edited, the MP4 may briefly show a placeholder. Open the project, scrub to each shot to force a re-render of the thumbnail, then re-export.
- Audio missing in the MP4. Audio is only included for shots whose lanes contain clips. Open the Timeline before exporting to confirm dialogue/music/SFX clips are present and not muted (greyed-out waveforms).
- Frame rate. MP4 export uses the project’s frame-rate setting (Project Settings > Frame Rate). If you need a different rate for an editorial round-trip, switch the project setting first, or use NLE Export (FCP7 XML) and let your NLE conform to its timeline.
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.
- Embedded media: shot thumbnails, audio (dialogue, music, SFX, voiceover), comments, and approval state are all baked into the file.
- Optional video: include rendered shot videos for a fully playable animatic, or leave them out for a smaller stills-and-audio review file. The dialog shows estimated file size before you export.
- Thumbnail compression is on by default to keep the file emailable; turn it off for full-quality stills.
- Standalone player: the exported HTML runs on a vanilla-JS player with no React, sql.js, or external dependencies — it just plays.
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.)
- Compatible with Adobe Premiere Pro and DaVinci Resolve. (Avid Media Composer ingest is on the roadmap.)
- Filenames are scene-qualified with shot-id disambiguators (e.g.,
1_A_2723.jpg) so DaVinci doesn't auto-merge numerically adjacent files into image sequences. - Audio formats (MP3, WAV, OGG, M4A, FLAC) are detected from file headers and translated into the XML's audio channel metadata.
- Standalone mode only at present. Embedded-mode export is on the roadmap.
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)
| Action | Shortcut |
|---|---|
| Undo / Redo | Cmd+Z / Cmd+Shift+Z |
| Duplicate Shot/Object | Cmd+D |
| Delete | Backspace |
| Focus on Selection | F |
| Gizmo: Move | W |
| Gizmo: Rotate | E |
| Gizmo: Scale | R |
| Next / Previous Shot | → / ← |
Timeline
| Action | Shortcut |
|---|---|
| Play / Pause | Space |
| Shuttle Forward | L |
| Shuttle Reverse | J |
| Stop Shuttle | K |
| Zoom In / Out | + / - |
| Fullscreen Viewer | F |
| Toggle Comment Panel | C |
| Toggle Script Panel | R |
| Toggle History Panel | H |
| Toggle Drawing Mode | D |
| Show Keyboard Shortcuts | ? |
| Open Share Dialog | G |
| Open NLE Export | Cmd+E |
AI & Audio
| Action | Shortcut |
|---|---|
| Toggle Enhance Shot | Alt+I |
| Quick Video Generation | Alt+V |
| Quick TTS Speech | Alt+S |
| Toggle Audio Workspace | Alt+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 Feature | Status | Replacement |
|---|---|---|
| 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.
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
- iPadOS / iOS 18.0 or later — as of Previs Pro 3.4.0, the App Store no longer offers the app to devices below iOS 18. This deliberately filters out older 2 GB-class devices that couldn't reliably run the app.
- macOS — current shipping version, Apple Silicon recommended. Intel Macs are supported but not the primary target.
RAM by Device
Any device released after 2022 is supported in Previs Pro as of 2026.
| RAM | Devices | Experience |
|---|---|---|
| 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:
- Restart your device before working on large projects. This frees up RAM consumed by background apps and system processes.
- Use fewer imported props and images. Custom 3D models and high-resolution images are the biggest memory consumers. Stick to built-in library props where possible.
- Split large projects. Instead of one massive project for a feature film, break it into acts, reels, or sequences. Use Import from Project to move scenes and assets between files.
- Close background apps. iPads don't have swap memory like Macs — when RAM fills up, iOS terminates apps.
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
- Check your mute switch. On iPhone/iPad, make sure the physical mute switch (or Control Center mute) is off.
- Safari auto-mutes audio. Safari often blocks audio playback in browser tabs until the user interacts. Check Safari > Settings for the site and make sure audio is allowed. You may need to tap play again after granting permission.
- Audio only plays at 1x speed. If using shuttle (J/K/L), return to normal speed.
- Check that clips are not muted in the timeline (look for greyed-out waveforms).
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:
- Try the latest build first. Text-rendering fixes ship regularly; the App Store version is usually a release or two behind the App Store cache — pull-to-refresh in the App Store updates listing.
- Report it with a screenshot to hello@previspro.com: which language, which input method, which panel (scene info, dialogue, screenplay, etc.), and what you typed vs. what appeared.
- Workaround for now: if input drops characters, paste from another app rather than typing directly. The paste path goes through a different code path than the keystroke handler and tends to be more reliable.
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:
- Email hello@previspro.com with the device model, app version (Settings > About), and a screen recording or screenshot of the problem.
- If your project has become unusable after an update, attach a
.previsfile if you can (Share > AirDrop or email the file to yourself first). A direct copy of the project is the single most useful thing in a bug report. - The App Store always serves the latest version of an app, so rolling back to an older Previs Pro build isn’t generally possible. If you’re mid-production and a regression is blocking you, get in touch — we’ll prioritize a fix and help you find a workaround in the meantime.
Recovering a Project That Won’t Open
If a project crashes the app on open, freezes during load, or shows an empty canvas:
- Force-quit the app and reopen. Previs Pro keeps an autosave alongside the active file; on relaunch you should see the project list, not the broken project.
- From the project list, tap Select in the top bar, tap the broken project so it highlights, then tap Duplicate in the bottom action bar — a copy will sometimes open where the original fails.
- If neither works, send us the project file (Share > AirDrop to yourself or email it out, then forward to hello@previspro.com). The
.previsfile is a self-contained SQLite database plus cached media; we can often inspect what went wrong and send a fixed copy back.