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 Previs Pro 3.6.0 ().

Previs Pro is a previsualization tool for filmmakers. Import a screenplay, plan each scene’s shots on boards, give every shot a frame — made with AI or staged in 3D with virtual sets, characters and cameras — and cut it all together on an editorial timeline, on iPad, iPhone, or Mac.

Unlike storyboarding software that is only a 2D drawing canvas, Previs Pro’s 3D path is a simulation that obeys real-world optics: real camera sensor sizes and focal lengths decide what each shot sees.

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

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

Platforms

All three use the same .previs project files and the same project shell, with Breakdown, Boards and Timeline tabs. See System Requirements for supported devices.

Available on the App Store.

Resources

Core Workflow

A project moves through three stages, one per tab of the project shell:

  1. Script — On the Breakdown tab, import your screenplay and Previs Pro breaks it into scenes, cast and locations. Bring in a revised draft later with Import revision. See Breakdown.
  2. Boards — On the Boards tab, plan each scene’s shots. Suggest coverage proposes a shot list from the script (tap Why these shots? to see the reasoning), script lining shows which lines each shot covers, and Shot, Scene and Project info hold the details. See Boards. Each shot then gets a frame in one of two ways:
    • AI — describe the shot in Sketch with AI, restyle a frame with Enhance Shot, or open AI Studio, the full AI workspace.
    • 3D — Build in 3D or Edit in 3D opens the shot in the Canvas Editor. There you place characters, props, sets, lights and cameras that obey real-world optics, and add camera moves as animatics.
    You can mix the two: Enhance can restyle a 3D render, and Revert to Live returns a shot to its live 3D frame.
  3. Timeline — On the Timeline tab, cut the shots together, add dialogue, music and sound effects in the audio lanes, play it back, then share or export. See 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.

Script, boards & AI

Subscriptions, payments, refunds

Devices & sign-in

Characters, props and 3D import

Crashes & updates

Working in the scene

Privacy & AI

Getting Started · Updated

First Launch

  1. The first time you open Previs Pro, a short intro video plays.
  2. A landing screen follows, with Sign In with Apple and View purchase options. If the app finds an existing subscription on your device, it says so and asks you to sign in.
  3. After you sign in (“You’re in!”), tap Let’s get started. You need to sign in before you can use the app, even if you already subscribe (see Sign-in required).
  4. New users then choose between two cards: View the Tour, which starts the Getting started tour, or Start Creating, which opens the Projects home with the Start new project chooser already open.

On later launches, a signed-in subscriber goes straight to the Projects home. If you subscribe but aren’t signed in on this device, you’re asked to sign in first. Without a subscription, the purchase options appear first (see Subscriptions and the free version).

The Projects Home

The Projects screen is where Previs Pro starts, and where you return whenever you close a project. It is one grid of poster cards, three per row in a regular-width window and two in a compact one:

In the top-right corner, ? opens Previs Assist and ☰ opens the menu. To add a .previs file, drop it anywhere on the screen (see Creating a New Project). The Projects home follows your theme, though the project cards themselves always stay dark.

Projects home UI elements at a glance

ElementLocationTarget ID
New project tileFirst card of the grid (dotted outline, red +). Opens Start new project.projects.addTile
Project cardThe grid, most recently opened first. Tap to open.projects.card
Project actions (⋯)On each project card. Right-click the card on a Mac for the same menu.projects.card.menuButton
New user guides shelfBelow your projectsprojects.guidesShelf
Help & support (?)Top right. Opens Previs Assist.projects.helpButton
Menu (☰)Top right, beside ?projects.menuButton

The Projects home menu

RowWhat it does
Back Up Projects“Archive your projects for safekeeping.” Writes every project into one archive you can save or share. On a Mac, choose Save to disk or Share with another app.
Purchase Options“Subscription management.” Shows the plans if you don’t subscribe, or your current subscription if you do. See Subscriptions and Managing your subscription.
Log Out“Sign out of your account.” The sign-in screen then appears.
What’s NewOpens the release notes page in your browser. A dot on the row means something new has been posted.
Contact UsStarts an email to Previs Pro support.
PreferencesTheme, performance, interface scaling and more. See Appearance & Preferences.

The bottom of the menu shows the app version and build, your plan, and the account you’re signed in as. It’s handy to include when you contact support.

New User Guides

The New user guides shelf on the Projects home holds five cards:

Each tour runs on a fresh copy of its own sample project, so you can replay it any time from the shelf. Tour copies never appear among your projects. The tour card docks at the bottom left and the app stays usable behind it. Skip tour is on every step except the last, where End tour takes its place; both close the tour project and return you to the Projects home. The tours use prepared results, so they don’t spend your credits.

The Example scene card behaves like one of your own projects: it has a ⋯ menu, and if you delete it, the card disappears from the shelf.

Tip: The first time you open the Breakdown tab and the Timeline in one of your own projects, coach marks point out the main controls. They appear once per device and never inside a tour copy. The 3D canvas has its own first-time coach marks: see Canvas coach marks.

Creating a New Project

On the Projects home, tap the New project tile (the first card, with the red +). The Start new project chooser offers three ways in:

To add a .previs project someone sent you, use Import Project in the chooser, drag the file onto the Projects home (up to 100 MB by dragging), double-click it in Finder on a Mac, or use Open With from the Files app on iPad or iPhone. When you drag a file in, double-click it or use Open With, Previs Pro asks Import Project? before adding it. If a project is open when you use Open With, it closes first. If a project with the same name already exists, Duplicate Project? lets you Replace it, Keep Both (optionally renaming the existing one), or cancel.

Starting from a Script

If you have a screenplay, Previs Pro can build the project for you. On the Projects home, tap the New project tile, then New Project from Script, and pick your file.

The new project’s scenes, cast and locations come from the script. As it opens, Previs Pro gives each character a body that matches their description (“Casting characters…”) and renders the shot thumbnails (“Preparing scenes”). The Script Import Checklist then lists what to check: the script, the cast and the locations.

Already working in a project? Import its script from the Breakdown tab’s Script view, or drop the file onto that view.

For what gets extracted, see Screenplay. To bring in a revised draft of the same script later, see Import revision.

Managing Projects

Every project card on the Projects home has a ⋯ button (on a Mac you can also right-click the card). Its menu offers:

A project that can’t be read shows a ! badge and won’t open; its menu offers only Delete. To rename a project, open it and change the title in Project info. On a Mac, Preferences › Show Projects Folder in Finder shows where your project files are stored.

Actions apply to one project at a time; the Projects home has no multi-select. To archive every project at once, use ☰ › Back Up Projects, which writes all your projects into one archive you can save or share. (Selecting several shots at once is done on the board: see Select mode.)

The Project Shell

When a project is open, a bar runs across the top of the window. It is the same on Mac, iPad and iPhone:

In the narrowest windows, Home and ? hide together to make room. ☰ always stays, so you can close the project with ☰ › Close Project.

No connection? If you ask Previs Assist a question while the device is offline, it asks No network connection, load local wiki? Tap Load wiki to open the copy of this wiki that is bundled with the app. See Working offline.

Project shell UI elements at a glance

ElementLocationTarget ID
Home (“Projects”)Bar, far left (house icon). Closes the project.shell.homeButton
Breakdown tabBar, center (first tab). Script, Cast and Locations.shell.tab.breakdown
Boards tabBar, center (second tab). The board.shell.tab.boards
Timeline tabBar, center (third tab). The edit.shell.tab.timeline
Help & support (?)Bar, right. Opens Previs Assist.shell.helpButton
Menu (☰)Bar, far rightshell.menuButton

The project menu

RowWhat it does
Project info“Title, aspect ratio & format.” Opens Project info.
Share“Save or send a copy of this project.” Packages the project, then offers Save to disk or Share with another app on a Mac, or the share sheet on iPad and iPhone.
Export“PDF, MP4, & PNG/JPEG.” Opens the export options (see Export). Grayed out while an AI generation is running.
Import From Project“Reuse scenes from another project.” See Import From Project.
What’s NewOpens the release notes page in your browser. A dot means something new has been posted.
Contact UsStarts an email to Previs Pro support.
PreferencesSee Appearance & Preferences.
Close ProjectThe last row. Same as the Home button.

In a read-only review session, Share, Export and Import From Project are hidden. Back Up Projects, Purchase Options and Log Out are only on the Projects home menu. On the Boards tab, when the side panel is showing and no shot is selected, its Project Actions view offers Project info, AI Studio, Export, Import From Project, What’s New, Contact Us and Preferences.

Selection and the Escape key

The shot you select stays selected when you switch between the Boards and Timeline tabs.

With a keyboard (on a Mac, or an iPad with a hardware keyboard), Esc on the Boards and Timeline tabs steps back one level per press:

  1. closes an open dialog or full-screen preview;
  2. closes a Shot, Scene or Project info panel;
  3. closes AI Studio or the Audio workspace;
  4. leaves drawing mode;
  5. closes the ☰ menu;
  6. leaves Select mode;
  7. steps the side panel’s Coverage view back;
  8. deselects the shot;
  9. and, once nothing is open or selected, closes the project.

While a blocking progress screen is up (for example, while a newly imported script’s shots render), Escape does nothing. For the Timeline’s own panels, see Escape on the Timeline. While you review an Import revision, the tabs, ? and ☰ are locked until you finish or cancel.

Appearance & Preferences

Open ☰ › Preferences on the Projects home or inside a project. On the Boards tab it is also in the side panel’s Project Actions view when no shot is selected.

The Theme section at the top sets the look of the Breakdown, Boards and Timeline tabs, the Projects home and Previs Assist:

The project cards on the Projects home, and screens such as sign-in and purchasing, stay dark. (The Appearance heading further down Preferences holds the language setting.)

SettingWhat it does
Preview Size (Fixed / Resizing)In a wide window, Fixed shows more previews and Resizing makes them larger. Narrow windows look the same either way.
Force scenes open on Board tabKeeps every scene on the Boards tab expanded. Off by default, except on a Mac.
Performance LevelLow Power saves battery and runs cooler, Balanced balances quality and battery life, High Power gives the best quality and frame rate. The current frame rate is shown underneath.
Interface ScalingA slider that makes the interface larger or smaller (see UI scaling). On iPad and iPhone, Use System Text Size follows the text size in iOS Settings; turn it off to use the slider.
SnappingSnap to Edit Camera, Snap to Canvas Object and Snap to Director View switches.
Language (under Appearance)Changing the language reloads the app. It can’t be changed while Preferences is open from the 3D canvas.
AdvancedEnable Trackpad Gestures (Mac only), Show Errors, Enable Touch Visualizer, Save Tripo Characters, Save Tripo Props, and Show Projects Folder in Finder (Mac only).

Tap Done to close Preferences.

Import From Project

Bring scenes, cast members, props and images from one of your projects into the open one with Import From Project (called Copy From Project in 3.5). Open it from the ☰ menu inside a project, or on the Boards tab from the side panel’s Project Actions view, which appears when no shot is selected. It isn’t available in a read-only review session.

  1. Select Project To Copy From lists your other projects with their numbers of scenes, shots, characters in cast, props in library, imported props, imported characters and images. A project saved by an older version must be opened once to update it first. One made in a newer version of Previs Pro needs an app update.
  2. Select the source project.
  3. Pick what to copy, then tap Continue:
    • Scenes — tick the scenes you want (Select all / Deselect all) and choose whether to copy the First shot, the Poster shot or All shots of each. The copied shots bring their cast, props and images with them, including imported 3D characters, plus their audio clips and videos.
    • Cast members, library props, imported props and images — copy specific assets on their own, without a scene. Imported 3D characters can’t be picked on their own; copy a scene that uses them.
  4. If the selected scenes contain set objects, Copy Set Objects asks whether to copy them too.
  5. If copied characters have the same names as characters already in the project, Duplicate Characters lets you Replace the existing ones or Keep Both.

Copy Successful then lists what was added (new scenes, cast members, library props, imported props and characters, images, audio clips and videos) and notes any duplicates that were skipped. If the copy would take the project past its limit for images and imported props, Too Many Assets stops it before anything is copied.

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

Boards · Updated

The Boards tab is your project’s storyboard. Each scene is a row of shot tiles, in script order, and on Mac and iPad a side panel on the right holds the actions for whatever you have selected. It is the middle of the three tabs in the project’s top bar (Breakdown | Boards | Timeline; see the in-project shell), and it is the default tab when you open a project. The Boards tab (formerly the Scene Manager) is where you add, arrange and open shots.

Every shot can take a 3D path or an AI path. Build in 3D / Edit in 3D opens the shot in the Canvas Editor; Sketch with AI draws it from a text prompt (see Sketch with AI). To leave the project, tap the home button at the left of the top bar, or choose Close Project from the ☰ menu.

Editing needs an editable project. In a read-only project the ⋯ menus, the Add tiles and the tile chips are hidden. You can still scroll the board and select shots.

Where to find it

Boards at a glance

ElementLocationTarget ID
Top barHome button, the three tabs, ? (Previs Assist) and ☰. See the in-project shell.shell.bar
Scene headerTop of each scene row: number and slugline, then a clapper icon with the shot count and a person icon with the character count. Tap to show or hide the scene’s other rows.sceneBoard.sceneHeader
Scene actions (⋯)In the scene header, right after the title and counts. Opens the scene menu, whose second row is Add shot.sceneBoard.sceneMenuButton
Edit coverageUnder the scene header while a shot in that scene is selected. Opens the scene’s Coverage overview.sceneBoard.editCoverageButton
Shot tileThe shot’s picture. Tap to select; double-tap (or double-click) a live 3D shot to open it in the Canvas Editor; hold to drag.sceneBoard.shotTile
Shot numberBottom-left of the tile (scene + shot, e.g. 3-C)sceneBoard.shotNumber
Shot-type badgeTop-left of the tile: Animatic, AI video or Static image. Plain 3D shots have no badge.sceneBoard.shotTypeBadge
Shot actions (⋯)Top-right of the tile. Opens the shot menu.sceneBoard.shotMenuButton
3D chipTop-right of the tile, under ⋯. Opens the shot in the Canvas Editor.sceneBoard.build3dChip
Revert to Live chipBottom-right of a tile showing a still image or an AI video. Such a tile has no 3D chip; a tile never shows both.sceneBoard.revertChip
Add shot tileDashed tile at the end of each scene. Opens Add new shot; the new shot goes at the end of the scene.sceneBoard.addShotTile
Add sceneBottom of the board. Adds a new scene.sceneBoard.addSceneButton
Side panelRight edge on Mac and iPad. Shot actions, or Project Actions when nothing is selected.shotActionsPanel
Rendering progressA pill at the bottom of the screen, or the Preparing shots… card for big jobsboardFill.pill / boardFill.modal

Scenes and shot tiles

Scene rows

Shot tiles

Selecting and moving shots

The shot menu

Open it with the tile’s ⋯ (or a right-click on a Mac). The rows, top to bottom:

There is no Copy row. To copy shots, choose Select, tick them and tap Copy (see Select mode), or select a shot and press ⌘C. The copy board is shared with the Canvas Editor’s shot menu, so a shot copied there can be pasted here too.

Replace is hidden for now. It only appears on the Getting started tour’s render step on a phone. To redo an existing shot with AI, open AI Studio from the side panel on Mac and iPad, or from the Timeline. To put your own picture on a shot, drop it on the tile (see Drag and drop images) or use AI Studio’s Import tab.

Escape or a tap outside closes the menu. The menu is not available in Select mode.

The scene menu and Edit coverage

The scene header’s ⋯, right after the scene title and counts, opens:

Edit coverage sits under the header of the scene whose shot is selected (or under every scene with Force scenes open on Board tab). It opens that scene’s Coverage overview, where Suggest coverage lives (see Suggest coverage). If the project has no script yet, it opens Suggest coverage from your script instead, with Close, Learn more and Import script. On iPhone this button is the way into the Coverage overview.

Adding shots and scenes

Tap the dashed Add shot tile at the end of a scene, or choose Add shot in the scene’s ⋯ menu, to open the Add new shot chooser:

  1. Build in 3D (“Block your shot in 3D”) — adds a 3D shot right away and selects it. It does not open the canvas; use the tile’s 3D chip or the panel’s Edit in 3D when you are ready.
  2. Sketch with AI (“Draft an image from prompt”) — opens Sketch with AI. The shot is created only when you apply a generated image.
  3. Import an image (“Use an existing image”) — opens the Photos library on iPhone and iPad, or a file panel on Mac. The shot is created once you pick a picture, exactly as if you had dropped it on the Add shot tile. The board shows Choose an image… while the picker is open. If Previs Pro is not allowed to use your photos, the app asks you to enable access in the iOS Settings app.

Cancel or Escape closes the chooser. Whichever row you pick, the new shot starts as a copy of the scene’s last shot and goes at the end of the scene, even when another shot is selected.

Insert shot (shot menu → Insert) is the same chooser for adding a shot right after a particular one. Build in 3D adds a copy of that shot’s 3D setup directly after it; Sketch with AI and Import an image work as above, but the new shot lands directly after that shot instead of at the end. With numbering locked, the new shot gets a revision number (see Numbering).

Replace shot (shot menu → Replace, hidden for now except on the Getting started tour’s render step on a phone) has the same three rows, applied to that shot: Sketch with AI opens the dialog for it, Build in 3D reverts any image, video or animatic to the live 3D shot and opens it in the Canvas Editor, and Import an image puts the picked picture on it.

Add scene at the bottom of the board creates a new scene with one shot, selects that shot and opens the new scene’s Scene info. The Add tiles are grayed out in Select mode.

Select mode

Select mode lets you act on several shots at once. Open any shot’s ⋯ menu and choose Select; that shot starts ticked.

The side panel

On Mac and iPad, in either orientation, the side panel is always on screen at the right of the board, and the grid reflows to make room. iPhone (and very narrow iPad windows) has no side panel: use the tile chips, the ⋯ menus, Edit coverage and the ☰ menu instead.

With a shot selected, the panel shows:

Shot info, Scene info and Project info open inside the panel on Mac and iPad and as a centered card on iPhone. Only one is open at a time. You can also drop an image on the panel to put it on its shot (see Drag and drop images). A read-only project’s panel shows only the Coverage row.

Sketch with AI. The board’s AI dialog opens from the panel row (fresh scenes) and from the Add new shot and Insert shot choosers (the shot is created only when you apply). It opens on its Create side (restyling an existing frame is AI Studio’s Enhance tab) and has an Open AI Studio hand-off. Full details are in Sketch with AI.

Coverage. In an editable project the Coverage row (“View/Edit Scene Coverage”) opens the scene’s Coverage overview, the same as the header’s Edit coverage; with no script imported it offers to import one. In a read-only project the row opens a Coverage view inside the panel instead: the scene’s script with each shot’s coverage drawn as colored lines, closed with Close. See Script lining. The Coverage row is hidden during a guided tour.

Project Actions

When no shot is selected, the side panel on Mac and iPad shows the project’s title and a list of project-wide actions. Apart from AI Studio, every row here is also in the ☰ menu, which is where iPhone finds them.

Shot info

Open it from the panel’s Shot info row or a tile’s ⋯ → Info. On Mac and iPad the board stays usable while it is open, and tapping another tile switches Shot info to that shot.

Scene info

Open it from the panel’s Scene info row or the scene menu’s Info; it also opens by itself after Add scene and Insert Scene. Unlike Shot info, nothing is saved until you tap Apply. Cancel throws your edits away, and so does Escape or tapping the dimmed board. If you had changed anything, a Changes applied or Changes discarded toast tells you which happened. The header shows the scene’s number and slugline, and updates as you edit.

After an Apply, the shots whose look changed are re-rendered (see Rendering progress).

Set Library

Scene info → Add existing set › opens the Set Library as a sheet on the right (a centered card on iPhone). Pick a set from the list, which is grouped Built In and Custom (the sets you saved). The large preview and its thumbnails show what the set looks like; older sets may show No preview available.

For what sets are and how to build them, see Sets.

Project info

Open it from Project Actions, the panel’s Project info row, or ☰ → Project info. On the Boards tab it opens in the side panel on Mac and iPad, and as a centered card on iPhone. Like Scene info it uses Apply and Cancel, with the same toasts. The header shows the project name; its pencil lets you rename the project.

Applying a new aspect ratio, sensor, Post-Processing or Tone Mapping re-renders the board, and then re-renders your animatic videos to match (see Rendering progress).

Drag and drop images

You can drag image files (PNG, JPEG, WebP, GIF and other image types) onto the board on Mac, iPad and iPhone. A ring highlights the target. Drops work in editable projects only, and not in Select mode or while a dialog covers the board.

Drop onWhat happens
A shot tile (or the side panel)One image only. Replace shot with image? — Replace makes it the shot’s static image. If the shot already has a still or a video, those are replaced.
The Add shot tile or the scene’s header rowOne image: Create shot from image? Several: Create 3 new shots?, one shot per image, made one at a time in the order you dropped them. New shots go at the end of the scene.
Add sceneOne image: Create scene from image? Several: Create scene with 3 shots?, one shot per image.

Each picture becomes the shot’s static image (badge Static image), with a 3D shot underneath. Revert to Live brings that 3D shot back at any time. Preparing image… shows while the system hands over the file, which can take a second or two on iPad and iPhone. If the image can’t be read or applied you’ll see Couldn’t apply the image. To do the same without dragging, use Import an image in the Add new shot chooser. For dropping scripts and .previs files, see Script import and Projects home.

Rendering progress

When shots need new thumbnails (opening a project with unrendered shots, after a Scene info or lighting change, after adding a set, or after a Project info look change), Previs Pro renders them in the background. Tiles that are still waiting shimmer.

Keyboard shortcuts and Escape

KeysWhat it does on the Boards tab
⌘CCopy the selected shot (“Copied 1 shot”). In Select mode, copy the ticked shots.
⌘VPaste after the selected shot, or after the board’s last shot if nothing is selected
⌘⌥→ / ⌘⌥←Select the next / previous shot in board order. With nothing selected, the first press picks the first / last shot. Also works on the Timeline tab.
EscapeStep back one level (see below)

The shot shortcuts do nothing while you are typing in a field, while a dialog or menu is open, during the Getting started tour, or under the Preparing shots… card. Copy and paste also do nothing in a read-only project. With text selected, ⌘C copies the text as usual.

Escape steps back one level per press: first it closes whatever is open on top (a chooser, a dialog or confirm, the Coverage overview, the full-screen preview, Shot, Scene or Project info, or the ☰ menu); then it leaves Select mode; then it deselects the shot; and finally it closes the project and returns to the Projects home. It does nothing under the Preparing shots… card. For Escape on the Timeline, see Timeline Escape.

The Canvas Editor · Updated

The Canvas Editor (the 3D canvas) is where you stage one shot: place characters, props, walls, lights and cameras, then frame the shot through its camera. You open it from the Boards tab, and it fills the screen. Along the top bar are Back, Undo and Redo, the shot title, Script, ? (Previs Assist) and the ··· menu. The canvas is in the middle. The scene’s shot list runs down the right edge, with a column of mode tabs beside it (CAM, Viewer, AR, Animatics). Selecting an object brings up its object menu.

Where to find it

A shot that shows an image or a video has no 3D button and doesn’t open on a double-tap: its tile shows Revert to Live in the bottom-right corner, and the side panel shows it in place of the Edit in 3D row. An animatic shot opened with its 3D button or a double-tap goes straight into the Animatic view.

Back (the arrow at the far left of the top bar) returns to the Boards tab with the shot you were last on in the canvas selected, and refreshes that shot’s thumbnail. With a keyboard, Escape does the same when no mode is active. Inside a mode it backs out of that mode instead: it cancels Pose Mode, leaves Look at, and closes a finished orbit. Escape does nothing in the Animatic view.

The canvas needs a wide window. On an iPhone held upright, or in a narrow iPad window, a cover asks you to Rotate your device to continue or Increase window size to continue. Tap Return to board on it to go back to the Boards tab instead.

First-visit tips

The first time you open the canvas in one of your own projects, a short walkthrough points an arrow at each main control in turn:

  1. CAM button — Fine-tune the camera position
  2. Viewer button — Preview your entire scene
  3. AR button — Project your shot in the real world (only on devices that support AR)
  4. Animatics button — Turn this shot into an entire animatic sequence
  5. 2D/3D toggle — Switch between overhead and 3D views
  6. Add a new object — Add a new camera, character, prop, light, or wall to the shot
  7. Add a new shot — Add a new shot to the scene
  8. Script — View your script for this scene (only when the project has a script)
  9. Back button — Return to the Board view

Each card shows its place (for example “1 / 9”). Tap Next, or anywhere outside the card, to move on; the last card says Got it!. Press Escape to skip the rest. If the shot list is closed, it slides open for the add-shot step and closes again afterwards.

The tips show once: after you finish or skip them, they don’t come back. They don’t appear in the bundled projects (the New user guides’ tutorial copies and the Example scene), and they wait while a guided tour is running, while the shot shows an image, video or animatic, or while a mode, the Script panel, the add-object menu or a popup is open.

Canvas & Modes

The middle of the screen is the canvas. The 2D / 3D switch (at the foot of the shot list) flips between a top-down overhead view and a full 3D view. The modes live in the tab column beside the shot list: CAM edits the shot through its camera, Viewer previews every shot in the scene, AR places your scene in the real world (iPhone and iPad), and Animatics turns the shot into a keyframed animatic sequence. The pencil beside the 2D/3D switch adds objects.

Canvas UI elements at a glance

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

ElementLocationTarget ID
BackTop bar, far left (arrow). Returns to the Boards tab with the shot you were last on selectedcanvasEditor.backButton
Undo / RedoTop bar, left of the titlecanvasEditor.undoButton / canvasEditor.redoButton
Shot titleTop bar, center: the shot number and scene heading (e.g. “2B - INT. PREVIS OFFICE – DAY”), shortened on narrow screens. Tap it to open Scene infocanvasEditor.titleBar
ScriptTop bar, right side (page icon). Opens the Coverage overview panel on the left. Shown only when the project has an imported scriptcanvasEditor.scriptButton
Help (Previs Assist)Top bar, right side (? icon)canvasEditor.helpButton
MenuTop bar, far right (···). Opens Scene info, Shot info, Export, Export 3D, What’s New, Contact Us and Preferences over the canvas (see The canvas menu)canvasEditor.kebabMenu
CompassTop-left of canvas. Tap to face north again, double-tap to recenter the view, drag to turncanvasEditor.compass
Zoom controlsTop-left of canvas (− / +). Mac only; on iPhone and iPad, pinchcanvasEditor.zoomControls
Tilt sliderTop-left, beside the compass (Mac only, 3D only)canvasEditor.tiltSlider
Find CameraTop-left, end of the row. Tap to center on the shot camera (tap again within 4 seconds to step through other cameras); double-tap to look from directly behind itcanvasEditor.findCameraButton
OrbitTop-left, under the compass (3D only). Plays an orbit around the scene (see 3D Canvas)canvasEditor.orbitButton
CAMTab column beside the shot list, top tab. Opens CAM mode to fine-tune the shot’s cameracanvasEditor.camToggle
ViewerTab column, under CAM. Shows all the scene’s shots as a grid; see ViewercanvasEditor.viewerButton
AR ModeTab column, under Viewer. iPhone and iPad only (models that support AR); hidden while the shot shows an image, video or animaticcanvasEditor.arButton
Animatic ModeTab column, bottom tab (running-figure icon). Opens the Animatic view for this shotcanvasEditor.animaticsButton
Add object (pencil)At the foot of the shot list, beside the 2D/3D switch: right of it when the window is tall enough for the open menu, left of it otherwise. Opens six rows, top to bottom: Import, Wall, Camera, Character, Light, Prop. Right of the switch the menu stays open until its chevron closes it; left of the switch picking a row or tapping anything else closes itcanvasEditor.addObjectMenu
2D / 3D toggleAt the foot of the shot list. Shortcut: SpacecanvasEditor.viewModeToggle
Object edit togglesBottom-left of the canvas, 3D only, while an object is selected (see Object Controls)canvasEditor.objectEditToggles
Picture-in-Picture (PiP)A floating window on the side of the canvas away from the shot list, showing the shot camera’s framing. Turn it on with PiP in the shot camera’s menu (this closes the shot list); it has its own enlarge, reduce and close buttonscanvasEditor.pip
Shot ListRight sidebar (vertical strip of thumbnails)canvasEditor.shotList
Selected ShotRight sidebar, red bordercanvasEditor.shotList.selected
Shot labelRight sidebar, under each thumbnail: shot number, the shot’s name (or, without one, a summary such as its size, movement and angle), focal length (e.g. “B - CU - 65 mm”)canvasEditor.shotList.label
Shot menuRight sidebar: tap the selected shot again, or its label (with the ⓘ), to open the shot menucanvasEditor.shotList.options
Add shotRight sidebar: a dashed Add shot tile after the last shot, filling the same space as a shot (picture and label) with a small red + disc, and a floating + at the bottom of the list that shows only while the tile is out of view. Either one adds a copy of the scene’s last shot at the end of the scene and selects itcanvasEditor.addShotButton

Tap the pencil at the foot of the shot list to open the add-object menu (it takes the place of Draw Mode and its Add Objects tray from earlier versions). The pencil sits right of the 2D/3D switch when the window is tall enough for the open menu to clear the tab column (CAM, Viewer, AR, Animatics), and left of the switch in a shorter window. Six rows open above it, top to bottom: Import, Wall, Camera, Character, Light and Prop, and the pencil becomes a down chevron. Each row opens that object’s picker or editor, and the new object lands in the middle of your view (in 3D it’s selected for you). If you cancel the editor that opens for a new camera, wall or light, the object is removed again. When the pencil sits right of the switch, the menu stays open after you pick a row or tap the canvas, so you can add several things in a row; tap the chevron to close it, and it also closes when you select another shot or leave the canvas. When it sits left of the switch (a short window, such as a phone held sideways), the menu closes as soon as you pick a row or tap anything else, such as an object on the canvas or one of the tabs. The pencil stays available while an object is selected, but hides while a mode (Pose, Look at, grouping, the orbit, the Animatic view) is active or the shot shows an image, video or animatic.

Add object menu rowTarget ID
ImportcanvasEditor.addObjects.import
WallcanvasEditor.addObjects.wall
CameracanvasEditor.addObjects.camera
CharactercanvasEditor.addObjects.character
LightcanvasEditor.addObjects.light
PropcanvasEditor.addObjects.prop

3D Canvas

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

Object Controls — when you select an object in the 3D canvas, a row of edit toggles appears at the lower left. With a keyboard, Tab / Shift+Tab step through them and the arrow keys nudge the object along the active tool.

Orbit — 3D canvas only. The orbit button under the compass plays a camera orbit around your scene. When it finishes, tap Replay to watch it again, Record to capture it as a screen recording, or Done. Shortcut: O.

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.

Canvas drawings — Draw Mode (formerly opened with Cmd+E, an Apple Pencil double-tap or an earlier pencil button) has been retired. The pencil at the foot of the shot list now opens the add-object menu. Freehand drawings already in older projects still show on the canvas; select one to Lock, Hide or Delete it. To mark up a shot now, use Draw in the Timeline viewer (see Doodle Annotations).

CAM Mode (Camera View)

Shows exactly what the shot’s camera sees (Director’s View). This is the view used for shot composition and the one captured as the shot thumbnail. Tap the CAM tab to enter; you can move the camera and frame your shot directly. Double-tapping a live shot in the shot list opens it too.

Focal Length Slider — Adjustable slider with 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. With a full-frame camera sensor (see camera sensors), the slider snaps to these primes and marks them along the track; with other sensors it moves freely.

Focus/Depth of Field Controls:

Composition Guides — tap the grid button at the top-left to pick overlays:

CAM view UI elements:

ElementLocationTarget ID
Composition guidesTop-left (grid icon). Opens a picker: Rule of Thirds, Quadrants, Diagonals, Reciprocal Diagonals, Golden Ratio, or nonecanvasCam.compositionPicker
Title barTop center: the shot label, e.g. “B - CU - 65 mm”canvasCam.titleBar
HelpTop-right (? icon)canvasCam.helpButton
DoneTop-right, exits CAM modecanvasCam.doneButton
Previous / next shotLeft and right edges (arrows)canvasCam.prevNextShot
Focal length sliderBottom; the pill on its thumb shows the value, and it snaps to the prime lenses on Full frame 35mm projectscanvasCam.focalSlider
Adjust Focus (OFF / AF / MF)Right edge, near the bottomcanvasCam.focusMode
Aperture (f-stop) sliderRight edge, above focus mode (Manual focus only)canvasCam.apertureSlider
Focus distance sliderRight edge (Manual focus only)canvasCam.focusDistanceSlider

CAM gestures:

Viewer

The Viewer tab (under CAM) shows all of the scene’s shots as a grid. Use + and − to change the grid size, play the shots through as a slideshow, or tap a shot to see it full screen with its notes. Double-tap the notes in the full-screen view to open Shot info. The Viewer tab is hidden in the Animatic view.

Animatics Mode

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

Animatics Canvas UI:

AR Mode

In AR Mode, the canvas is replaced by the device camera feed with virtual objects overlaid in the real world. Supports both life-size and tabletop scaling, with plane detection, scene placement, and frame selection. AR is available on iPhone and iPad models that support it, not on a Mac. 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. With a keyboard, Tab / Shift+Tab step through the editing tools in 3D, W A S D nudge the selected object (hold Shift for bigger steps), and Q / E rotate it. See Canvas keyboard shortcuts.

Selected-object handles (3D canvas):

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

Handle types vary by context:

Object Context Menus

Open the horizontal context menu on any object:

Available actions depend on the object type:

Shot-level actions (Info, Insert, Copy, Paste, Delete, Combine) are in the shot menu, not in object menus.

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

Tap Group in an object’s menu (behind the ▶ arrow) to pick more objects (“Select objects to group together”). Group isn’t offered for locked or hidden objects, or for set pieces. The multi-selection overlay provides:

Static Image & Video Overlays

A shot can show a still image, a video or an animatic instead of the live 3D render (added on the board or in AI Studio). In the canvas it covers the 3D view:

Paste Clipboard

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

Canvas keyboard shortcuts

With a hardware keyboard (Mac, or iPad with a keyboard), these work in the canvas. The full list for the whole app is in Keyboard Shortcuts.

KeysWhat they do
SpaceSwitch between 2D and 3D
EscapeBack out of the current mode; otherwise return to the Boards tab
Return / EnterApply the pose in Pose Mode
Delete / BackspaceDelete the selected object
Tab / Shift+TabStep through the editing tools (3D, object selected)
Arrow keysNudge the selected object along the active tool, or move the view when nothing is selected (hold Shift for bigger steps)
W A S DNudge the selected object forward, left, back, right (hold Shift for bigger steps)
Q / ERotate the selected object, or turn the view when nothing is selected
+ / −Zoom in / out
Cmd+↑ / Cmd+↓Zoom in / out; in 2D with a camera or spotlight selected, narrow / widen its cone
Cmd+DDuplicate the selected object
Cmd+Z / Shift+Cmd+ZUndo / redo
Cmd+CCopy the selected objects, or the current shot when nothing is selected
Cmd+VPaste copied objects into the shot, or a copied shot after the current one
Cmd+P / Option+Cmd+PPose menu for the selected character / manual pose editor for a custom character
Option+Cmd+← / →Previous / next shot
OPlay the orbit

The Canvas Menu, Scene info & Shot info

The ··· at the far right of the top bar opens a menu over the live canvas:

Tapping the shot title in the top bar also opens Scene info, and the shot menu’s Info opens Shot info. Scene info and Shot info look exactly as they do on the board at the same window size: a centered card on a small window, a sheet docked on the right otherwise. Your changes apply to the live canvas.

Preferences opened from the canvas work as they do elsewhere, except that the language can’t be changed there (“Exit the canvas to change the language”). The canvas’s snapping options live in Preferences → Snapping: Snap to Edit Camera, Snap to Canvas Object and Snap to Director View, all on by default.

The menu in CAM mode opens the same overlay; there Scene info is unavailable, and Shot info is unavailable while you’re editing the camera.

Coverage overview (the Script button)

When the project has an imported script, the Script button (page icon, top bar) slides in a panel from the left with the Coverage overview for the canvas’s scene — the same table as the board’s Coverage overview, in its compact form. Use it to adjust the scene’s shots while you look at them in 3D.

The panel isn’t available in the Animatic view. If you leave it open when you go back to the board, it opens again the next time you enter the canvas.

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. Each label shows the shot number, the shot’s name (or, without one, a summary such as its size, movement and angle), and its focal length. The number is gray while numbering is locked, and red for a variant number.

The shot menu offers:

Object Menus & Info Panels

When you select an object in the canvas (3D or 2D), a horizontal action menu appears with options for that object type (see Object Context Menus). Edit opens the object’s editor: Edit Camera (lens and camera settings), Edit Light, Edit Wall or Edit Prop. Shot-level settings are in Shot info, from the shot menu’s Info or the ··· menu.

Environments · Updated

Walls & Set Building

Build your environment with walls and props. In the Canvas Editor, tap the pencil beside the 2D/3D switch at the bottom of the shot list and choose Wall, Prop or Light. The menu’s other rows are Camera, Character and Import, and it stays open until you close it, so you can place several things in a row. The scene’s floor and sky aren’t placed as objects; set them in Scene info.

Props & Set Dressing

The built-in Prop Library holds hundreds of props. They’re sorted into categories such as Furniture, Vehicles, Interior, Exterior and Nature, and there’s a search box. Tap the pencil → Prop to open Add Prop:

Props & Sets

Props exist per-shot — moving a prop in one shot does not affect other shots. To reuse a whole room in other scenes, save it as a set and add it to those scenes; see Sets & Locations.

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.

Size, position and rotation always belong to the one placement you’re editing, so resizing a prop never resizes its copies. A prop placed from Your Prop Library does share its name, type, color and image with that library entry. Changing one of those updates every placement of it.

When you save a scene with Save as Set and add that set to another scene with Add existing set, the added objects are copies. Edits in scene B don’t echo back to scene A. Every shot in scene B also gets its own copy, so moving a set piece in one shot leaves the other shots alone.

The case where edits do propagate globally is the cast. Characters are global, so editing a cast member in one shot changes them everywhere. See the Cast List for the workaround: duplicate the cast member to get an independent entry, e.g. “Bond — Suit” vs. “Bond — Tux”. The copy button is on their card in Breakdown › Cast.

Per-Shot Object Limits

Object TypeMax per Shot
Props100
Characters50
Walls100
Lights10
Cameras10 (one active at a time)
Doodles100

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.

A project also has a cap on imported assets in total: imported characters, images and props count together. When you reach it, Previs Pro shows Imported Asset Limit, and you’ll need to delete some of them before you can import more.

AI Prop Generation

If the library lacks a specific item, generate one: tap the pencil → Prop → Create Custom to open Describe Prop.

  1. Type a short description of at least 3 characters, e.g. “1950s toaster”.
  2. Tap Create (15cr). A unique 3D model is generated via AI.

This costs 15 credits and needs an internet connection and a signed-in account. Tapping Create without a usable description shows Prompt Required and nothing is generated. See AI 3D Generation.

3D Model Import

Import custom .glTF / .glb models from third-party tools (Blender, SketchFab, Polycam, etc.). See 3D Model Import below.

Sets & Locations

A set is a saved copy of a room that you can add to any scene: the walls, props and lights you built. Every shot owns its own objects, and anything you build exists only in that shot. Sets are how you reuse a room instead of building it again.

Where to find it

Locations

Each scene’s Location is chosen in Scene info. Pick one of the project’s locations or None, or tap New to add one in New Location. When you import a screenplay, the locations come from the script’s sluglines. You can rename, merge and duplicate them in Breakdown › Locations.

Save a scene as a set

  1. Build the room in the scene’s first shot, because only that shot is saved.
  2. In Scene info, give the scene a Location. Save as Set stays unavailable until the scene has one.
  3. Tap Save as Set. The set is saved under the location’s name, and saving can take up to about 45 seconds.

Characters aren’t saved with a set. If a set with that name already exists, Previs Pro asks Set already exists; tap Replace to overwrite it.

Your saved sets are stored on the device. They’re available in all your projects there, but they don’t carry over to your other devices.

Add a set to a scene

  1. In Scene info, tap Add existing set. The Set Library opens.
  2. Choose a set from the Set Library dropdown. The sets that come with the app are listed under Built In (a few come in more than one version), and your own under Custom. A preview shows the set; tap the thumbnails to see its other views when it has more than one.
  3. Tap Done.

The set’s objects are copied into every shot of the scene. Each shot gets its own copy, so moving a set piece in one shot leaves the other shots alone. Adding a set also brings in its floor and sky, and in the scene’s first shot the set’s camera becomes the active camera.

Sets can’t be added to a scene that has animatic shots. To delete one of your own sets, select it in the Set Library and tap Delete; the sets that come with the app can’t be deleted. See also Set Library.

Matching set found: if you choose a Location whose name matches one of your saved sets, Previs Pro offers to add that set’s objects to the scene. Tap Add set to accept.

With Suggest coverage: the board’s coverage dialog has its own Set dropdown, with None, Generate Background, or one of your Built-in or Custom sets. The AI’s pick appears beside it as Suggested set: …, but it’s never chosen for you. A set you pick there is added to the scene when the shots are created. See Suggest coverage.

Building a set from scratch: start a scene and build the room with walls and props in its first shot. Then give the scene a Location and tap Save as Set. From then on, the room is one Add existing set away in any project on that device.

Augmented Reality (AR) Mode

Use your physical location as the set. AR mode runs on iPhone and iPad and uses Apple’s ARKit; a LiDAR sensor isn’t required. It isn’t available on macOS.

  1. Tap AR in the column of buttons beside the shot list; the column also holds CAM and the Animatics button. When asked to proceed to augmented reality mode, tap Enter. Don’t show this again skips that question in future. AR isn’t offered while the shot is an image, a video or an animatic.
  2. Scan: Point the device at the floor and move slowly to detect the plane. On-screen hints help, such as “Move your device around to find a flat surface” and “Move your device around more slowly”.
  3. Anchor: Tap the grid to lock the virtual world to the real world (“Tap to place your shot”).
  4. Block: Place virtual characters into your real environment.
  5. Walk: Physically walk around the virtual actors holding the device like a camera viewfinder.

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

AR view UI elements:

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

Options holds these toggles: Show walls, Lights on/off, Show stage floor, Show matte, Show equipment and New shot background. If a new shot’s background image can’t be saved because the project already holds too many images, you’ll see Too Many Images. Delete some images or turn off New shot background.

While recording, the screen shows “Screen recording starting…”; tap anywhere to stop. For a walkthrough, the AR viewer card in New user guides on the Projects home plays a video in your browser.

3D Model Import

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

  1. Scan a room using a 3D scanning app (e.g., Polycam, RealityKit) or create a model in Blender, Cinema 4D, Maya, etc.
  2. Export as .glTF or .glb.
  3. In Previs Pro, tap the pencil → Import → 3D Prop or Set. Use 3D Character instead for a rigged person; see Importing a Custom Rigged Character. In Recently Imported, tap the folder icon to pick the file from your device. The magnifying glass opens a Sketchfab search in your browser.
  4. Use the scale tool to ensure the model is 1:1 for accurate lens simulation.

Supported formats

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

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

Tips for clean imports

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

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

Characters · Updated

The Cast List

Characters are global assets: edit a cast member and they update across all scenes and shots. Your project’s cast lives in Breakdown › Cast, where every row shows the character’s headshot.

A cast member whose body wasn’t made in the Character Creator (an imported, ActorGen or older character) shows Update model instead of Edit character. It replaces their body with a new one. If the current body is an imported or generated one, Previs Pro first warns you that it will be replaced and deleted, and that this can’t be undone. Then pick a source in Replace Character. From Breakdown, only Character Creator works there for now; the other sources show Coming Soon! and return you to the list.

When you import a screenplay, your cast is created for you. Each character in the script gets a ready-made body chosen to fit their description; you’ll see Casting characters… while the board opens. You can edit any of them later like any other cast member.

A new scene, and a new project’s first scene, also start with two ready-made people in the shot. They aren’t in your cast yet. Select one, choose Edit, then Body: Previs Pro asks for a name and adds that person to the cast before the Character Creator opens.

In the Canvas Editor, the pencil → Character opens Add Character:

To bring in a character built in another tool, tap the pencil → Import → 3D Character and choose a .glb file. See Importing a Custom Rigged Character. Imported characters can carry blend shapes for facial expressions.

Tip: Because character edits propagate globally, duplicate a cast member when you need the same person in different outfits (e.g., “Bond-Suit” and “Bond-Tux”). Tap the copy button on their card in Breakdown › Cast. Each duplicate is independent, so editing one never changes the other.

Character Creator

The Character Creator builds a realistic, fully-rigged 3D person right inside Previs Pro — no external tools, no AI credits. A live 3D preview updates as you make changes. When you save, the character drops straight into your Cast List, ready to pose and place. It’s available in the iPad, iPhone and Mac apps, and on iPhone it works in portrait as well as landscape.

To open it, tap Add character in Breakdown › Cast, or tap the pencil → Character → New Character in the Canvas Editor. A person made from the Canvas Editor is also placed in the current shot. One made from Breakdown › Cast joins the cast without being placed. The Casting guide on the Projects home walks you through it; see New user guides.

Drag the preview to turn the character; on a Mac trackpad, a two-finger sideways swipe turns it too. Customization is organized into tabs, listed here top to bottom. The creator opens on Body.

Tap Save character and give the person a name in Name your character. A name that’s already in your cast is refused with “That name is already taken”. The person is then added to the cast — there’s no separate “add to cast” step.

Because characters are global, editing one later updates that character everywhere in the project, and the creator asks you to confirm. If you want an independent variant, duplicate the cast member first. Character Creator people include facial blend shapes, so the Expression option and FaceCap work on them.

Editing later: in Breakdown › Cast, tap the person’s headshot or Edit character. In the Canvas Editor, select them, choose Edit, then Body in the Edit Character panel. Either way, the Character Creator reopens with their current look.

Posing

PoseCap (AI Motion Capture)

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

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

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

Custom characters: PoseCap shows and drives the character you selected, so the pose you capture is the pose you see. That includes Character Creator people, ActorGen characters and posable imported characters. PoseCap (like FaceCap) isn’t offered for imported Ready Player Me web avatars or for characters on a Reallusion Character Creator (CC) skeleton.

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) whose skeleton meets the requirements below. To import one, tap the pencil → Import → 3D Character in the Canvas Editor.

Export from Blender, Mixamo, Ready Player Me, or any tool that produces glTF with those bone names. .fbx is not accepted, so 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.

Requirements for posing

If you're stuck on rigged-character import: for most “I want my own person” cases you don’t need to import at all. Use the Character Creator to build a rigged character in-app, or ActorGen to generate one from a text description (it auto-rigs for you). Reserve .glb import for characters you’ve built in external tools. For very specific likenesses or non-humanoid designs, email hello@previspro.com — we’d like to see what you’re trying to do.

ActorGen (AI Character Generation)

ActorGen lets you create custom 3D characters from a text description, powered by a 3rd-party AI service. Characters are automatically rigged with a skeleton for posing and animation.

ActorGen is currently free while we improve the results, so the button reads Create (0cr). If a price returns, the button will show it before you tap.

  1. Tap the pencil → Character → Create Custom. ActorGen needs an internet connection and a signed-in account.
  2. In Describe Character, enter a short description of the character of at least 3 characters, e.g., “tall woman in a red dress, professional, 30s”. Then tap Create. Tapping it without a usable description shows Prompt Required.
  3. The system generates the full 3D model, then automatically rigs it with a skeleton.
  4. Progress shows Submitting request → Waiting in the queue → Generating → Rigging → Downloading, about two minutes in all.
  5. Check the result in Final Inspection. If it faces the wrong way, turn it in 90° steps. If the shoulders look off, pick another body frame (Small, Medium or Large), which re-rigs it. Then name the character and save; they join your cast.

If the service is busy, you’ll see Tripo Service Busy; wait a minute and try again.

Tip: The system automatically appends "full body, feet flat, T-pose" to your prompt for consistent skeleton alignment. Generated characters are ready for posing immediately.

ActorGen characters are stored as custom characters in your cast. They can be posed, placed in any scene and animated in animatics. They don’t support facial Expressions or hand poses, as the note under the prompt says.

See also: Characters articles on the support site.

Camera & Cinematography · Updated

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

Where to find it

Optics & Sensors

Camera Sensors

Every camera in a project uses the project’s camera sensor. Choose it in Sensor size when you create a project or import a screenplay, or change it later in Project info → Camera Sensor. The camera preview at the top of Project info renders a sample scene through a 50mm lens with the sensor and Aspect Ratio you picked, so you can see the framing before you tap Apply.

Changing the sensor keeps every camera’s focal length and recalculates each shot’s field of view for the new sensor, as if you’d swapped camera bodies behind the same lenses. Shot thumbnails re-render to match.

Camera SensorSize (mm)Notes
Full frame 35mm36 × 24The default. The only sensor where the focal-length slider snaps to prime lenses.
iPhone Native11.04 × 6.21Phone camera.
Canon APS-C22.30 × 14.871.6x crop factor.
Nikon APS-C23.60 × 15.731.5x crop factor.
Super 35mm24.89 × 18.66Common cinema format.
Micro 4/317.30 × 13.002x crop factor.
2/3" Video8.80 × 6.60Broadcast video format.
Standard 16mm10.26 × 7.49Documentary / indie format.
Super 16mm12.52 × 7.41Wider 16mm variant.
Alexa LF Open Gate36.70 × 25.54Large format cinema.
Alexa 6554.12 × 25.5865mm large format.
Alexa 26554.12 × 25.5865mm large format.
Blackmagic URSA Cine 17K 6550.81 × 23.3265mm large format.

Focal Length

Focal length is set per camera, in three places:

  1. In the canvas: select the camera and turn on its lens toggle among the object’s edit controls. The focal length shows on screen; drag the handles that appear on the camera to widen or narrow its view.
  2. In CAM mode: drag the focal-length slider along the bottom; the pill on the slider’s thumb shows the focal length.
  3. In the Coverage overview: type a value in mm in a shot’s Lens cell (see Suggest coverage and the Canvas Editor’s Coverage overview).

The range runs from 10mm to 270mm, and new cameras start at 35mm (both full-frame equivalents). On a project whose sensor is Full frame 35mm, the slider snaps to 17 prime focal lengths: 10, 15, 20, 24, 28, 32, 35, 40, 50, 65, 70, 85, 100, 105, 135, 200 and 270 mm. Dots mark each prime, and devices with haptics give a click at each one. With any other sensor the slider moves freely. Field of view is calculated from the focal length, the project’s sensor and aspect ratio, and the lens squeeze if the camera has an anamorphic lens, matching how real cameras behave.

Lens vs. aperture. The canvas lens toggle changes focal length (the field of view), not the f-stop. The f-stop is the aperture slider in CAM mode, which appears in manual focus — see Depth of Field.

Anamorphic Lenses

Each camera can have a spherical or an anamorphic lens. Select the camera and tap Edit in its context menu, then in Edit Camera tap Lens type and pick 1.0x Spherical (the default) or a squeeze: 2.0x, 1.85x, 1.8x, 1.6x, 1.55x, 1.5x, 1.33x or 1.3x Anamorphic. That camera’s focal-length readouts take the squeeze into account.

Depth of Field

All depth-of-field controls are in CAM mode; there is no depth-of-field control anywhere else. Open CAM mode for the camera you want to focus, then use the OFF / AF / MF toggle:

  1. OFF — no depth of field; everything is sharp. New shots start here.
  2. AF (auto focus) — turning depth of field on focuses automatically. Tap anything in the picture to focus on it; AF also sets the aperture for you from the lens’s focal length.
  3. MF (manual focus) — two sliders appear beside the picture: the aperture (the f-stop) on the left, where a lower f-stop gives a blurrier background, and the focus distance (the in-focus distance from the camera) on the right. The previous/next-shot arrows hide while they’re shown. Tapping the picture still sets the focus distance but leaves your aperture alone.

Depth of field is saved with the shot. A shot that shows a static image, a video or an animatic has no camera controls in CAM mode, so there’s no focal-length slider or focus toggle for it.

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

Director's View (CAM Mode)

Director’s View is CAM mode, the view through the shot’s active camera. Its controls and modes are documented under CAM mode: the focal-length slider, depth of field (OFF / AF / MF), grid lines, POST mode and camera tracking (CAM TRACKING).

Multiple Cameras Per Shot

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

  1. Add another camera: tap the pencil (beside the 2D/3D switch, at the bottom of the shot list) → Camera. The new camera becomes the shot’s active camera and the previous one is disabled. If you cancel the Edit Camera panel that opens, the new camera is removed and the previous camera is active again.
  2. Position and frame each camera independently.
  3. To switch which camera renders the shot, select the camera you want (tap or click it) and tap Enable in its context menu. The previously active camera is disabled automatically.

A shot can hold up to 10 cameras.

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 · Updated

Where to find it

Default Lighting

A new scene — one you add yourself or one created from a screenplay import — starts with a three-point lighting rig: three spotlights named Key Light, Fill Light and Back Light, aimed at the cast. All three cast soft shadows at full strength. Their colors follow the scene’s time of day: by day a warm key against a cooler fill and back light, at twilight a warm orange key and fill, and at night cool blue light. How bright they are depends on the scene’s Type and Time: the rig adds to the scene’s sun and ambient light, so it’s a subtle accent in a daytime exterior and does most of the work in interiors (which have no sun) and at night. They’re ordinary lights — move, edit, add a gobo to, or delete any of them.

Light Types

TypeDescriptionExamples
LanternOmni-directional point lightsLantern, Practical Lantern
SpotlightDirectional cinema lights. New lights start as a Spotlight.Spotlight, Practical Spotlight, Ellipsoidal Light, PAR Light, Small / Medium / Large Fresnel, Open Face Light, Fluorescent Tube 1 / 2 / 4, LED Panel, Light Panel, Ring Light, Scoop Light, Cyc Light
DirectionalParallel light from one directionFlood Light

Editing a light

Select a light (tap or click it) to show its context menu: Edit, Gobo (Spotlight types only), Duplicate and Delete, with Lock, Add to Set / Remove from Set, Copy, Copy+, Copy- and Group on its second page. Edit opens Edit Light, where you pick the fixture from the list above and set Intensity, Color, Shadows and Name.

A shot can hold up to 10 lights. To keep the fixtures themselves out of your rendered shots, turn off Show Lighting Equipment in Project info (under Miscellaneous); Show Camera Equipment does the same for camera bodies. Changing either re-renders every shot thumbnail.

Scene Lighting, Floor & Sky

Each scene has its own lighting environment, set in Scene info. Open it from a scene’s ⋯ menu → Info on the Boards tab, the Scene info row in the Boards tab’s side panel or the Canvas Editor’s menu, or the pencil on an expanded scene card in Breakdown’s Script tab. Changes take effect when you tap Apply; Cancel discards them. The one exception is Scene Lighting (below), which saves its own changes.

Once you’ve customized a scene’s lighting, changing Type or Time asks Reset Lighting? (asked once each time you open Scene info). Yes switches to the default lighting for the new Type and Time when you tap Apply; No keeps your custom lighting and still changes the Type or Time.

Gobos / Cookies

Spotlights can project a gobo (also called a cookie): a pattern in the beam that throws shadows and shapes onto the set, including the default walls. There are more than 200 patterns:

How to add a gobo

  1. Add a light (the pencil → Light; new lights are Spotlights), or use any light in the Spotlight row above.
  2. Select the light (tap or click it) to show its context menu.
  3. Tap Gobo.
  4. In Gobos, tap a pattern. The gallery closes and the light projects the pattern. To remove a gobo, open Gobos again and tap the first tile (no pattern).

Only Spotlight-type lights take a gobo. Lanterns and the Flood Light don’t show the Gobo button.

AI Lighting & Atmosphere

To try a lighting mood on a shot’s image without placing lights, restyle it with AI in AI Studio’s Enhance tab:

Look & Tone Mapping

Tone mapping controls how Previs Pro turns the high-dynamic-range 3D scene into the final on-screen image — it sets the overall “film stock” feel of highlights, shadows, and color. It’s a project setting: it applies to everything rendered in that project (the 3D canvas, CAM mode, shot thumbnails and exports) and is saved in the .previs file, so every device that opens the project shows the same look. It’s separate from AI Studio’s Enhance, which restyles a shot’s image.

To change it, open Project info (the menu ☰ at the top right of the project shell → Project info, or the Project info row in the Boards tab’s side panel) and pick a mode in Tone Mapping, just below Post-Processing. The camera preview at the top re-renders a sample scene in the mode you pick. Nothing changes in the project until you tap Apply; the shot thumbnails then re-render.

Moved in 3.6.0. Tone mapping used to be a device setting (Mac Preferences, or the Previs Pro page in the iPhone/iPad Settings app). Those settings are gone. A project that doesn’t have a tone mapping setting yet — a new project, or one made before 3.6.0 — takes the mode your device was last set to (None if you never changed it) the first time you open it, then keeps it.
ModeLook
NoneThe default. No tone mapping — the raw linear render. Flatter, and bright areas can clip hard.
NeutralGentle highlight roll-off that keeps colors close to their original hue.
ACESThe filmic film-industry standard — punchy contrast and saturated highlights.
AgX - three.jsModern filmic curve that rolls bright highlights off gracefully and desaturates them, avoiding the “neon” clipping ACES can show. A natural, cinematic look.
PBR NeutralKhronos standard tuned to preserve material colors accurately — good when you want the render to match the assets.
AgX - BlenderThe Blender version of AgX, for matching looks developed in Blender.

If you’re not sure, AgX - three.js or ACES give the most cinematic result; None shows the unprocessed render.

Timeline · Updated

Where to find it

The shot you selected on the Boards tab comes with you: the Timeline moves the playhead to it and scrolls it into view (unless the Timeline is filtered to a different scene). To leave, tap another tab, or tap the home button (Projects) at the left of the shell bar to close the project. When the bar is too narrow to show the home button, use ☰ → Close Project. The Timeline is no longer opened from the Canvas Editor; it’s always one tap away in the shell bar.

The Timeline (formerly the Timeline Review screen) is the editorial stage of Previs Pro: your shots laid end to end with their timing, transitions and audio lanes, a large viewer, and playback controls. It is also where AI Studio and the Audio workspace open.

Timeline UI elements at a glance

The standard Timeline view, with neither workspace open. When AI Studio is open it fills everything above the transport bar; the Audio workspace replaces only the viewer.

ElementLocationTarget ID
Shell barTop of the screen: Projects (home), the Breakdown | Boards | Timeline tabs, ? (Previs Assist) and the ☰ menu. See the in-project shell.shell.bar
Script panel toggleHeader row, far left (document icon). Shows or hides the Script panel.timeline.scriptToggle
Scene SelectorHeader row, left (“All Scenes ▾” or the picked scene’s number and name). Hidden when the project has only one scene.timeline.sceneSelector
Project titleHeader row, center (the project’s name)timeline.projectTitle
Approval statusHeader row, right (color-coded pill for the shot under the playhead). Tap to choose Pending, Approved or Notes.timeline.approvalStatus
Comments toggleHeader row, far right (speech bubble with the shot’s comment count). Pulses when you land on a shot that has comments and isn’t approved, and flashes when a reviewer’s new comment arrives. Shortcut C.timeline.commentToggle
ViewerLarge image/video display below the header, letterboxed to the project’s aspect ratiotimeline.viewer
Viewer fullscreenTop-right of the picture (expand icon, also F)timeline.viewer.fullscreen
Edit ToolsBottom-right of the picture (round … button): Draw, Record audio, Add Speech. See Viewer Edit Overlay.timeline.viewer.editTools
Info BarThin row under the viewer, e.g. “EXT. NEW YORK STREET SET — DAY • Shot A • 10mm • f/5.6”timeline.infoBar
AI gutterLeft end of the shot lane, top (sparkle icon, captioned AI). Opens AI Studio on its Enhance tab for the shot under the playhead. Shortcut Option+I.timeline.gutter.enhance
Audio gutterLeft end of the shot lane, below AI (speaker icon, captioned Audio). Opens or closes the Audio workspace. Shortcut Option+A.timeline.gutter.audio
Time rulerAbove the shot lane (M:SS labels, e.g. “0:05”). Click to jump the playhead.timeline.ruler
Shot lanePrimary horizontal row of shot barstimeline.shotLane
Shot quick-action menuAbove a shot bar; tap the shot’s thumbnail in the shot lane. Revert, Poster, Comment, Enhance, Speech. See Shot Management.timeline.shotLane.hMenu
Retime handleRight edge of each shot bar. Drag to change the shot’s length. Hidden during playback and for reviewers.timeline.shotLane.retimeHandle
Scene labelAt the start of each scene in the shot lane (e.g. “4. NEW YORK STREET SET”), on the scene’s color. To rename a scene, use Scene info on the Boards tab.timeline.sceneMarker
Transition handleDiamond between adjacent shot bars, lettered C, D, F or ⟷. Click to change the transition type.timeline.transitionHandle
PlayheadVertical red line across the lanes. Drag to scrub.timeline.playhead
Audio lanesBelow the shot lane, labeled “AUDIO”. Collapsed to one row by default; expands to four lanes when the Audio workspace is open.timeline.audioLanes
Previous shot / Play / Next shotTransport bar, lefttimeline.transport.prev / play / next
TimecodeTransport bar, current / total (e.g. “01:14.8 / 02:20.6”)timeline.transport.timecode
Shuttle speedTransport bar, next to the timecode while shuttling (e.g. “2x ▶”)timeline.transport.shuttle
Step toggleTransport bar (Step; pauses at each shot boundary during playback). Shortcut R.timeline.transport.stepToggle
Zoom sliderTransport bar, next to Step (20–300 pixels per second)timeline.transport.zoom
Review Mode badgeTransport bar (reviewers only), with ? (Review Guide) and Moretimeline.transport.reviewBadge
Connection statusTransport bar, when the project has a review session (Live / Connecting... / Offline)timeline.transport.connection
Help (Timeline guide)Transport bar, right (?). Opens the Previs Pro Timeline guide; reviewers see the Review Guide. Previs Assist is the ? in the shell bar.timeline.transport.help
Credit balanceTransport bar, right (number with a coin icon). Tap for your account menu: Add Credits, Earn Credits / Referral, AI Gen History, Sign Out.timeline.transport.credits
ExportTransport bar, right of credits. Opens the export hub (Download HTML, Publish to Web, Export for NLE). Cmd+E opens it on the NLE tab.timeline.transport.export
ShareTransport bar, far right. Shares the project for online review (needs an active subscription; otherwise you’ll see Subscription Required). See Share link.timeline.transport.share
Tip: There are two ? buttons. The ? in the shell bar opens Previs Assist; the ? in the transport bar opens a quick Timeline guide. Pressing the ? key shows the keyboard shortcuts.

Layout

Under the shell bar, the Timeline tab is laid out in six bands, top to bottom:

1. Header Row

2. Viewer Area

The large display showing the current shot, letterboxed to the project’s aspect ratio. Content depends on context:

Viewer Edit Overlay

A round … button at the bottom-right of the picture (Edit Tools) expands to show quick actions. When only one action is available, it shows on its own without the … button:

If the shot already has doodles, Draw may ask first: when other people have doodled on it, the project’s creator sees Shot Markup (“This shot has markup from …”) with Draw / Clear All Doodles / Cancel; otherwise, if you have a doodle of your own on the shot, you see Your Doodle with Redraw / Clear My Doodle / Cancel. When you finish, Add Doodle Comment lets you add a note (Post / Discard). See Doodles.

Fullscreen Viewer

Press F or tap the expand icon at the top-right of the picture to fill the window with the viewer; the header, panels and lanes hide.

3. Info Bar

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

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

4. Shot Lane

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

A red playhead marks the current time; drag it to scrub. The ruler above the lane shows M:SS; click it to jump. A label at the start of each scene shows its number and name on the scene’s color.

The AI and Audio gutter buttons sit at the left end of the shot lane.

Transition Zones

Where two shots meet, a small diamond shows the transition (C cut, D dissolve, F fade, ⟷ continuous). Click it to change the type — see Transitions.

5. Audio Lanes

Below the shot lane are four color-coded audio lanes. They’re collapsed to a single Audio row until you open the Audio workspace, which expands all four (on phones, just the active one). Reviewers don’t see the lanes when the project has no audio.

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):

While shots render in the background, a progress pill (“Rendering shots — 12 of 40”) sits just above the transport bar. See board rendering.

Side Panels

Three optional panels, toggled independently:

Shot Management

Selecting & Navigating

Duration Editing

Shot Reordering

To reorder shots, use the Boards tab: hold a shot tile until it lifts, then drag it to its new place (with a mouse, just drag it). The Timeline follows the new order.

Shot Quick-Action Menu

Tap the thumbnail of a shot bar in the shot lane to select it and open its quick-action menu above the bar (tap again to close it and deselect). The menu isn’t available during playback or to reviewers:

Revert to Live

Reverting a shot clears its AI picture, imported still or video and its generation reference, then has the 3D canvas render a fresh frame. Revert is in the shot’s quick-action menu here, in AI Studio’s Enhance tab, and on the shot tile on the Boards tab.

Dropping an Image on a Shot

Drag an image file (PNG, JPEG, WebP or GIF) onto a shot bar in the shot lane, or onto the viewer to use it for the shot under the playhead. You’re asked Replace shot with image? (“Use … as the static image for Shot …?”); tap Replace or Cancel. If the shot already has a still or video, the dialog warns that it will be replaced. When it’s done you’ll see Image applied to shot.

You can drop images on board tiles too — see Dropping images on the board.

Duplicating vs. Copying Shots

The Timeline has no copy or duplicate commands of its own; you make new shots from existing ones on the Boards tab or in the Canvas Editor. The two routes behave differently:

MethodHowWhat you get
Add shot / Insert In the Canvas Editor’s Shot List: the Add shot tile (or the floating +) copies the scene’s last shot to the end of the scene; the shot menu’s Insert copies the selected shot right after it. On the Boards tab: Add shot → Build in 3D copies the scene’s last shot to the end; a shot’s ⋯ → Insert → Build in 3D (or Shot info’s Duplicate shot) copies that shot right after it A clean new shot. Camera, characters and props come along (an animatic contributes its final positions), but AI pictures, animatic keyframes and motion paths, video overlays and other shot-specific data are stripped. Think of it as a fresh starting point.
Copy & Paste On the Boards tab, a shot’s ⋯ menu → Select, tick the shots and tap Copy, then another shot’s ⋯ menu → Paste (they land after that shot). The shot menu has no Copy row. With a keyboard, Cmd+C / Cmd+V copy the selected shot and paste on the Boards tab. A full copy of the shot, including an animatic’s keyframes and motion paths.
Tip: To carry an animatic’s motion paths over to a new shot, use Copy and Paste on the Boards tab — not Add shot or Insert. See the shot menu.

Swiping Between Shots

Swipe across the viewer to step through your shots:

Each swipe selects the shot, moves the playhead to its start and scrolls the shot lane to it. Swipes are ignored while you’re drawing a doodle, recording audio, or while an AI generation is running. In fullscreen, swiping slides between shots with an animated carousel.

The keyboard equivalent is Cmd+Option+→ / ←.

Note: The Mac-only Enable Trackpad Gestures switch in Preferences doesn’t affect swiping on the Timeline. That switch controls trackpad gestures in Previs Pro’s native screens, such as the Canvas Editor and Director’s View.

Shot Metadata

Each shot carries cinematography metadata, set in Shot info on the Boards tab or in the Canvas Editor. The Info Bar shows the lens, f-stop, size, angle and movement, and the same values feed AI prompts — the system describes the shot using them.

Shot Size

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

Shot Angle

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

Shot Movement

ValueAI Prompt Mapping
Staticstatic locked-off shot
Dolly In / Outcamera pushing in / pulling out
Pan Left / Rightpanning left / right
Tilt Up / Downtilting up / down

Any other movement (Pan, Tilt, Truck, Pedestal, Arc, Whip Pan, Zoom, Roll and so on) is passed to the AI as written.

Shot Framing

Values: SS (single), 2S–5S (two- to five-shot), OTS (over-the-shoulder), OTH (over-the-hip) and POV (point of view). A shot can combine them, e.g. 2S OTS.

Additional Per-Shot Data

Scene Selector

The scene selector pill at the left of the header row controls which portion of the project is visible in the timeline:

Each scene in the project has:

Scene & Shot Numbering

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

A worked example at the top of the page updates as you change the settings. Lock script and Renumber take effect as soon as you confirm them, without waiting for Apply.

Scene Numbers

Scenes are numbered in order from 1, or from the number in Start scene # (turn on the switch beside it; it must be a whole number of 1 or more). A scene with a custom number keeps it and doesn’t use up a number in the count (custom scene numbers need a letter or symbol; plain numbers are reserved for automatic numbering).

Shot Numbers

Shots are numbered within each scene, with letters (ABC, the default: A, B, C … then AA, AB …) or digits (123). A custom shot number is kept as typed and doesn’t use up a letter (it needs a digit or separator; plain letters are reserved).

Ambiguous Character Exclusion

By default, shot letters skip I, O and S (easily confused with 1, 0 and 5), leaving 23 letters. Turn on Allow ambiguous characters in shot numbers to use the full A–Z.

Combined Format

Scene and shot numbers are joined with the Scene/Shot Separator: None (1A), . (1.A) or - (1-A).

Revision Numbers

While numbering is locked, a scene or shot you insert gets a revision number instead of renumbering everything after it. Scene revisions (1A or A1) and Shot revisions (A-1 or 1-A) choose the style; they can only be changed while numbering is locked.

Locked Numbering

Turn on Lock script (Lock Script?) to freeze the current scene and shot numbers. After that, adding or removing shots doesn’t renumber anything, and inserted items get revision numbers — useful once departments are already referencing shot numbers. While locked, the page shows “Numbering is locked for this project.” and the separator, starting-number and lettering controls are disabled.

Turning the lock off (Unlock Script?) keeps revisions and custom numbers and renumbers everything else in order. Renumber (Reset Numbering?) renumbers every scene and shot by its position in the script. Neither unlocking nor renumbering can be undone.

Playback & Transport

Basic Controls

ActionControl
Play / PauseSpace or Play button
Previous / next shotSkip buttons, or Cmd+Option+← / →
Jump to start / endHome / End
Seek 1 second← / →
Zoom Timeline+ / - or the zoom slider

Shuttle Control (J/K/L)

Professional NLE-style shuttle for variable-speed playback:

KeyAction
LPlay forward. Press again to increase speed (2x, 4x, 8x).
JPlay reverse. Press again to increase reverse speed (2x, 4x, 8x).
KPause.

Pressing the opposite key while shuttling slows down first, then changes direction.

Audio note: Audio plays only at 1x. At 2x, 4x and 8x shuttle speeds, playback is silent.

Step Mode

Turn on Step in the transport bar (or press R) to pause at every shot boundary — handy for reviewing shot by shot. Shots joined by a Continuous transition 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 diamond where two shots meet to choose a transition:

TypeDescription
CutInstant switch with no duration. The default.
DissolveCrossfade between the two shots (1 second).
FadeThe first shot fades to black, then the next fades up from black (0.5 seconds).
Continuous (⟷)Two shots joined by an AI video made with AI Studio’s First/Last Shot Video task (see AI Video). It isn’t offered in the diamond menu.

Transition lengths are fixed: 1 second for a dissolve and 0.5 seconds for a fade.

Viewer Modes & Workspaces

The viewer area switches between these modes; only one workspace can be open at a time.

ModeOpen it withWhat it shows
ViewerClose any workspaceThe shot’s picture or video, doodles and the Edit Tools button
AI StudioThe AI gutter button (opens on the Enhance tab for the shot at the playhead), Option+I (Enhance, image), Option+V (Enhance, video), or Enhance in a shot’s quick-action menuAI Studio with its Create, Enhance, Touch Up and Import tabs, filling everything above the transport bar. Close it with its close button or Esc.
Audio workspaceThe Audio gutter button or Option+A; Option+S opens it on Create for speechCreate, Record and Import tabs in place of the viewer, with all four audio lanes. Close it with its close button, the gutter button or Esc.
FullscreenF or the expand iconThe viewer alone with a minimal transport

AI Studio also opens from the Boards tab (Open AI Studio in Sketch with AI, or AI Studio in the side panel); closing it there takes you back to the board.

Timeline Tips (first visit)

The first time you open the Timeline in one of your own projects, a short series of tips points at the main controls with an arrow: Scenes & Script, Comments & Approval, Your Timeline, AI & Audio and Back to Projects. Reviewers get their own three: Shots, Comments & Approval and Visual Notes. Tap Next (or anywhere outside the card) to move on and Got it! to finish; Esc skips them. They don’t appear in the Getting started or Casting tutorial projects or over AI Studio, and they show only once. Press T on the Timeline tab to see them again.

Tease Overlay

When a reviewer taps the AI or Audio gutter button in a share link, the workspace doesn’t open; instead a Previs Pro card describes the app’s AI or audio tools. Close it with × or by tapping outside it.

Undo & Redo

The Timeline keeps an undo history of up to 25 steps. Edits on the Timeline tab — retiming shots, changing transitions, moving and trimming audio clips — can be undone:

These shortcuts work on the Timeline tab with a keyboard; the Timeline has no on-screen Undo buttons. A drag (resizing a shot, moving an audio clip) counts as one step. Generation History isn’t affected by undo, and every project opens with an empty undo history.

The Escape Key

Esc steps back one level per press, through selection, panel and project. On the Timeline tab, each press does the first of these that applies:

  1. Closes AI Studio or the Audio workspace.
  2. Leaves Doodle (drawing) mode.
  3. Closes the ☰ menu.
  4. Deselects the selected shot.
  5. If the Script panel, Comments panel, Generation History or fullscreen is open, or a dialog is up (help, keyboard shortcuts, export hub, share, tips), it goes no further: Esc never closes the project from under them. Close the panels with their own buttons or shortcuts.
  6. Otherwise, closes the project and returns you to the Projects home.

Some dialogs and menus handle Esc themselves: the Timeline guide, the keyboard shortcuts overlay, the Scene Selector list and the approval status menu close, and the first-visit tips are skipped. While the blocking Preparing shots… window is up, Esc does nothing. In the app, Esc doesn’t leave fullscreen — press F or tap Exit.

Tip: Esc never skips a level: if a workspace is open, the first press only closes it.

Mobile & Tablet Layout

On a phone (portrait or landscape), or in a very narrow window, the Timeline switches to a compact layout:

On any screen too narrow for it, the transport bar wraps onto two rows.

On iPad, fonts and touch targets are about 15–20% larger than on a Mac. On touch screens, each shot bar’s retime handle is wider so it’s easier to grab.

Reviewers opening a share link on a phone in portrait are asked to Rotate to landscape.

Interface Scaling

Text and control size is set with Interface Scaling in Preferences (☰ menu → Preferences): a seven-step slider shown as a percentage. On iPhone and iPad, Use System Text Size follows the text size in iOS Settings instead and disables the slider.

Among the web-based screens, the setting resizes the Breakdown tab, text and controls together. The Timeline and Boards tabs keep their own 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:

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

File Version & Saving

The current format is file version 57. Opening a project made with an earlier version of Previs Pro upgrades it automatically. In the app, projects save as you work — there’s no Save button.

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 (Cmd+S).

Audio System · Updated

Where to find it

The Audio Workspace has three tabs: Create (AI speech, music and sound effects — part of the AI Generation suite, credit-based), Record and Import. Audio plays across four color-coded lanes.

Audio Workspace UI elements

Create tab open with Dialogue type selected. All three tabs share the close button and the expanded lanes.

ElementLocationTarget ID
Create tabTop of panel, first tab (the active tab is underlined)audio.tab.create
Record tabTop of panelaudio.tab.record
Import tabTop of panelaudio.tab.import
Close panelTop of panel, far right (ⓧ)audio.closeButton
Audio type pickerTop-left of the Create tab: Dialogue / Music / SFX / Voiceoveraudio.create.typePicker
Model pickerNext to Type, for Dialogue and Voiceover only: Fast 2cr (Kokoro) or Best 3cr (ElevenLabs). The dropdown shows each model’s speed and ends with Use Saved Audio.audio.create.modelPicker
Scope pickerNext to Model, Dialogue only: All Scenes / Selected Scene / Selected Shot / Customaudio.create.scopePicker
Cast listBelow the pickers (CAST), for Dialogue in any scope except Custom: one row per character with a voice dropdown and a preview buttonaudio.create.castList
Cast row — voice pickerDropdown per character (e.g. “Bill”, “Daniel”, “Rachel”). Tap to choose a voice from the model’s voice pool.audio.create.castList.voice
Cast row — previewSpeaker icon to the right of the voice picker; plays a short sample of that voice. Choosing a voice in the dropdown plays its sample too.audio.create.castList.preview
PromptMusic and SFX: describe the sound (“Describe the music...” / “Describe the sound effect...”).audio.create.promptInput
Text box + Voice pickerVoiceover, and Dialogue with Custom scope: type the words to speak (“Enter text to generate...”) and pick a voice from the Voice pill at the end of the picker row.audio.create.voicePicker
DurationBottom bar, Music and SFX only: a dropdown of lengths — Music 3–15 s (default 15), SFX 1–22 s (default 5).audio.create.durationSlider
Retime checkboxBottom bar, left (Retime). Extends shots so generated speech fits (1 s padding at each end, 0.3 s between clips).audio.create.retime
Overwrite existing dialogueBottom bar, next to Retime (Dialogue, any scope except Custom)audio.create.overwrite
Skip approved dialogueBottom bar, next to Overwrite (Dialogue, any scope except Custom)audio.create.skipApproved
Generate buttonRed button at bottom-right. The label follows Type and scope: Generate Dialogue (Custom), Generate Shot Dialogue, Generate Scene Dialogue, Generate 3 Scene Dialogue (All Scenes), Generate Music, Generate SFX, Generate Voiceover. The estimate follows it (e.g. ~30 cr, lines × the per-line rate). While music or SFX generates, the button shows the status and a timer; tap it to cancel.audio.create.generateButton
Record buttonRecord tab, center: a large red circle (Click to record). While recording it becomes a Stop button under the elapsed time.audio.record.button
Import drop zoneImport tab: Drop audio file here or tap to browse, listing .wav .mp3 .ogg .m4a .aacaudio.import.dropZone
Preview bar — lane pickerBottom of the Record and Import tabs once you have a take or a file: play/stop, and a lane dropdown (Dialog / Music / SFX / Voiceover)audio.preview.laneSelect
Preview bar — + Add AudioRight end of the preview bar; places the clip at the playhead on the chosen laneaudio.preview.addButton
Lane label — DIALOGFar left of the timeline, Lane 0 label (shown while the Audio Workspace is open, except on phone-size screens). Tap a lane label to make it the target lane.timeline.audioLanes.dialog
Lane label — MUSICLane 1timeline.audioLanes.music
Lane label — SFXLane 2timeline.audioLanes.sfx
Lane label — VOICEOVERLane 3timeline.audioLanes.voiceover
Audio clipA colored waveform bar on a lane. Drag the body to move it (on touch screens, press and hold first), drag either edge to trim, hover for the volume slider; i renames it and × deletes it.timeline.audioLanes.clip

Create Tab (AI Audio Generation)

Generate audio from text using AI. Pick a Type — Dialogue, Music, SFX or Voiceover — and the result lands on that type’s lane.

Dialogue (TTS)

Generates speech from screenplay dialogue. Choose a scope:

TTS Voice Models

ModelSpeedCostVoices
Kokoro (Fast)~3s per line2 credits per typed line; 10 per shot or scene batch8 voices (Heart, Bella, Jessica, Nicole, Nova, Adam, Eric, Michael)
ElevenLabs (Best)~5s per line3 credits per typed line; 15 per shot or scene batch20+ voices (Rachel, Aria, Sarah, Roger, Charlie, George, and more)

A typed line (Custom dialogue or Voiceover) is billed per line. Script dialogue goes out in batches — one for Selected Shot, one for Selected Scene, one per scene with dialogue for All Scenes — and each batch costs a flat 10 credits on Kokoro or 15 on ElevenLabs, however many lines it holds. The Generate button shows the total before you tap.

Voice Assignment

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

Music Generation

SFX Generation

Generation Options

If a generation fails, a Generation Failed message explains why; tap Dismiss to close it.

Record Tab

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

Silence at the start and end is trimmed automatically, and recordings are saved as WAV. In the app on iPhone, iPad and Mac the device microphone is recorded directly; one take can run up to 5 minutes. The clip is placed at the playhead on the lane you pick.

Import Tab

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

Drop one file on the drop zone (Drop audio file here or tap to browse). It appears in the preview bar: play it, pick a lane and tap + Add Audio to place it at the playhead. You can also drop audio files straight onto the Timeline’s audio row (an empty row reads Drop audio files here); they land where you drop them — with the Audio Workspace open, on the lane under the pointer.

Audio Lanes

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

With the Audio Workspace closed, the Timeline shows all clips in one combined audio row. Open the workspace to see the four lanes; tap a lane’s label to make it the target lane (Select Dialog lane).

Clip Interactions

A clip stays attached to the shot it starts in, keeping its offset from that shot’s start, and it can run past the end of that shot — handy for music that spans several shots. Select a clip and press Delete to remove it (you’ll be asked to confirm).

AI Generation · Updated

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

FamilyAccess pointWhere in the UI
Image & VideoAI Studio; on the board, Sketch with AITimeline tab → gutter AI button or Option+I; Boards tab → side panel → AI Studio
Audio (speech, music, SFX)Audio Workspace > Create tabTimeline tab → gutter Audio button or Option+A
3D PropsDescribe PropCanvas Editor → Add Prop → Create Custom
3D CharactersAI-generated characters (Describe Character)Canvas Editor → Add Character — see Characters

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, MiniMax H3 Max, MiniMax H3 (2K), 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. Image, video, speech, music and sound-effect requests go through fal.ai; 3D requests go to Tripo3D directly:

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.

AI Studio

AI Studio is where image and video generation lives. It opens in the Timeline tab and replaces the viewer; while it’s open the header reads STYLE & VIDEO GRADING.

Where to find it

AI Studio has four tabs: Create, Enhance, Touch Up and Import.

The shot you pick carries across tabs. Toggle AI Studio with the gutter AI button or Option+I. The estimated credit cost and time appear on the generate button, so each batch’s spend is visible before you commit.

While a generation runs

Spending and refunds

Create Tab

The Create tab makes a new image or video from a description alone; the shot’s current frame is not used. It’s where AI Studio lands when you open it without a shot (the side panel’s AI Studio row on the Boards tab with no shot selected; see the board’s side panel).

  1. Tap a shot in the grid to pick it. Until you do, the button reads Select a shot first; tap the chosen shot again to deselect it.
  2. Choose Type (Image or Video) and Model. The model choice is shared with the Enhance tab.
  3. Describe what you want (“Describe the image you want to create. Be as detailed as possible.”; e.g. “A wide angle panorama of the NY skyline”). For video the hint reads “Describe the video you want to create. Be as detailed as possible.” (e.g. “A slow push in across the NY skyline”).
  4. Tap Create (it shows the estimate, e.g. ~12cr · 15s). Progress reads Creating Shot 1C....
  5. Review the result and tap Apply to put it on the chosen shot — or, with Add as new shot ticked, Add Shot.

Add as new shot (in the app; off by default): when ticked, the result becomes a new shot inserted right after the chosen one instead of replacing its frame. If AI Studio was opened from the Boards tab, Add Shot closes back to the board on the new shot.

A video’s price is the per-second rate × the chosen shot’s length, clamped to 5–15 seconds (see Video Generation).

ElementLocationTarget ID
Create tabTop of panel, first tabenhance.tab.create
Type pickerType, top-left: Image / Videoenhance.create.typePicker
Model pickerModel, beside Type: Fast / Quality / Best with the price under it (3 cr / 6 cr / 12 cr); for video, the model name with 10cr/s or 20cr/senhance.create.modelPicker
PromptText box under the pickersenhance.create.prompt
Add as new shotCheckbox under the prompt (app only)enhance.create.addAsNewShot
Create buttonRed button at the end of the picker row, with the estimateenhance.create.createButton

Enhance Tab (formerly Style Grade)

The Enhance tab restyles existing shot frames into finished images, or animates them into video clips, for one shot or many at once. Opening AI Studio from the Timeline gutter, Option+I or Option+V lands here.

Enhance tab UI elements

Enhance tab open. All four tabs share the same shot grid and many of the same controls; differences are noted in their own subsections.

ElementLocationTarget ID
Create tabTop of panel, first tabenhance.tab.create
Enhance tabTop of panel, second tab (after Create); the active tab is underlinedenhance.tab.styleGrade
Touch Up tabTop of panelenhance.tab.touchUp
Import tabTop of panelenhance.tab.import
Close panelTop of panel, far right (ⓧ)enhance.closeButton
Type pickerType, top-left: Image / Video / First/Last Shot Video (grayed out with “(needs next shot)” when there’s no following shot)enhance.typePicker
Model pickerModel, beside Type: tier and price, Best 12 cr by default (Fast 3 cr / Quality 6 cr / Best 12 cr). For video it shows the model name and per-second price (e.g. MiniMax H3 Max 10cr/s). The dropdown ends with Use Saved Image / Use Saved Video.enhance.modelPicker
Range pickerRange, beside Model: Choose Shots / Choose Scenes / All Shots (hidden for First/Last Shot Video)enhance.scopePicker
Skip approved shotsCheckbox under the pickers (Choose Scenes and All Shots)enhance.skipApproved
Overwrite existing static shotsCheckbox under the pickers (Choose Scenes and All Shots, when the project has static shots)enhance.overwriteStatic
Style preset — PHOTOStyle row, left (Image type only; your choice is remembered)enhance.style.photo
Style preset — SKETCHStyle row, rightenhance.style.sketch
Generate AI audioVideo type only, in place of the Style rowenhance.video.generateAudio
Retime shots to match videoVideo type only, beside Generate AI audioenhance.video.retime
Audio directionVideo type, when Generate AI audio is ticked: “Audio direction, e.g. rain, distant thunder”enhance.video.audioDirection
PromptPrompt ✎ pill at the end of the Style row (or of the video options). Opens a popover to edit the generated prompt, with + Actor, + Scene, Reset, Copy and Done.enhance.editPrompt
Generate buttonRed button under the options. The label follows the job — Enhance Shot, Enhance 3 Shots, Generate Video, Generate 3 Videos — followed by the estimate (e.g. ~12cr · 15s). It reads Choose shots to enhance until you pick shots.enhance.enhanceButton
Shot PreviewLarge image at the top-right of the panel showing the targeted shot (“Tap a shot below to enhance it” until you pick one)enhance.shotPreview
RevertPill under the preview when the shot shows an AI image, an imported still or a video; returns it to its live 3D frameenhance.revertButton
Saved Image / Saved VideoPill under the preview when the shot shows its live frame but has earlier results; restores the latest (with several, a menu lists them)enhance.restoreButton
Shot GridGrid of shot thumbnails below the preview. Tap to select or deselect; double-click or press and hold for a full-screen preview.enhance.shotGrid
Shot Grid cellEach thumbnail (e.g. “1A”, “1B”, “2A”). A scene/shot strip overlays the bottom of each cell.enhance.shotGrid.cell

Range

Controls which shots are affected:

Shot Grid

Thumbnails labeled with their shot numbers (e.g. 1A). Tap to select; double-click or press and hold for a full-screen preview you can swipe through.

Options

Animatic shots: if the range includes an animatic, you’re asked Enhance an animatic? first. Enhancing turns an animatic back into a single static shot and removes its continuing shots and animatic video. Tap Revert and enhance to go ahead, or Cancel.

In a browser, if you aren’t signed in, the generate button reads Sign In to Enhance (Sign In to Generate for video).

Image Generation

Turn shot frames into finished storyboard images. AI Studio builds the prompt from the shot’s metadata — interior/exterior and location, time of day, shot size, lens and shot notes. Use Prompt ✎ to edit it: + Actor adds a count of the people in the shot and + Scene adds up to three of the scene’s action lines.

ModelTierCostSpeed
FLUX.2 TurboFast3 credits~8 sec
Seedream 4.5Quality6 credits~25 sec
Nano Banana 2Best (AI Studio default)12 credits~15 sec

When it finishes, a review shows Before and After. For one shot, tap Apply or Discard; for several, accept or reject each result (or Accept All / Reject All) and tap Apply 3 Enhancements. Every result is saved to Generation History. Discarding a result, or rejecting it before you apply, returns its credits and removes it from the history.

Video Generation

Animate shot frames into short video clips: on the Enhance tab set Type to Video (or press Option+V). The Create tab can also make a video from a description alone.

ModelTierCostResolutionDuration
MiniMax H3 MaxDefault10 credits / second768p5–15 sec
MiniMax H3 (2K)Higher resolution20 credits / second2K5–15 sec

Video is priced per second, and the duration is the shot’s own length clamped to 5–15 seconds — so the cheapest clip you can generate is 5 seconds on MiniMax H3 Max, at 50 credits. The exact cost is shown on the Generate Video button before you commit.

Video Options

First/Last Shot Video

Set Type to First/Last Shot Video to make one clip that moves from a shot into the next, using the two frames as start and end. Tap a shot to pick it and its neighbor; the hint reads “* Will use Shot 1B as the end frame”. The clip’s length is the first shot’s length, clamped to 5–15 seconds, and it is priced per second like any video. See also Transitions.

Touch Up

Refine or modify an existing shot image with a text prompt. Uses the Nano Banana 2 model (12 credits).

  1. Switch to the Touch Up tab.
  2. Tap a shot with an image in the grid to make it the target.
  3. Describe the change (e.g. “Change the car from red to blue”). Be as detailed as possible.
  4. Tap Touch Up (it shows the estimate, e.g. ~12cr · 15s). The current image is the input; check the before/after and tap Apply or Discard.
Note: Touch Up is not compatible with video shots. Select an image shot to use it.

Import Tab

Put your own image on a shot, free of charge.

  1. Tap a shot in the grid. Without one you’ll see Select a shot first.
  2. Drop an image on the drop zone (Drop images here or tap to browse; JPEG, PNG, WebP, GIF). One file at a time.
  3. Check the before/after and tap Apply (“Image applied to shot”) or Discard. Closing AI Studio without applying drops the import.

Sketch with AI

Sketch with AI is a small generate dialog that opens over the Boards tab, so you can draft or restyle a shot without leaving the board. It’s in the app (not in read-only or review projects). There are two kinds, and how you open it decides which:

Create

Enhance

Both kinds

Audio Generation

Audio generation is the audio family of AI generation. It lives on the Audio Workspace’s Create tab rather than in AI Studio, but draws from the same credit pool. Four types:

TypeModelCostNotes
Dialogue (TTS)Kokoro Fast2 credits / lineFast tier
Dialogue (TTS)ElevenLabs Best3 credits / lineHigher quality
MusicElevenLabs Music40 creditsInstrumental only; 3–15 s
SFXElevenLabs SFX5 credits1–22 s
Voiceover(uses the Dialogue models)2–3 credits / linePlaced on the Voiceover lane instead of Dialog

For the whole Create tab — cast voice assignment, scope, prompt and duration, voice previews — see Create Tab.

AI 3D Generation

3D Props — 15 credits

  1. In the Canvas Editor open Add Prop and choose Create Custom (needs an internet connection). The Describe Prop window opens.
  2. Enter a short description of the prop (e.g. “A yellow convertible on the ground”) and tap Create (15cr). With fewer than 3 characters, tapping Create shows Prompt Required instead of starting.
  3. Stages: Submitting request → Waiting in the queue → Generating → Downloading (about 60 seconds).
  4. Result: a .glb model imported as a prop you can position and scale.

3D Characters — free

  1. Add a character and choose the AI option (see AI-generated characters; needs an internet connection). The Describe Character window opens.
  2. Enter a short description (e.g. “A beautiful woman in a black evening gown”) and tap Create (0cr). As with props, fewer than 3 characters shows Prompt Required. Generated characters don’t support Expressions or Hand Poses.
  3. Stages: Submitting request → Waiting in the queue → Generating → Rigging → Downloading (about 120 seconds).
  4. Result: a rigged .glb model with skeleton, ready for posing and animation.

Generation History

Every AI result — images, videos, transitions, speech, music and SFX — is kept in the project’s Generation History until you delete it; undo and redo don’t remove entries. Results you discard in a review are removed, and their credits returned.

Credits & Purchasing · Updated

AI features are powered by a credit system. Credits (called “tokens” internally) are used each time you generate something with AI. AI features need you to be signed in (see Sign-In Required). Asking Previs Assist (the ? button) doesn’t use credits.

Your Credit Balance

Your balance shows up wherever you can spend credits:

Buttons that spend credits show the cost before you tap — for example Create (15cr) on Create Object. Suggest coverage shows its estimated credits and time on the button, and is disabled (“Not enough credits”) when your balance is below its cost (see Suggest coverage).

Credit Costs per Feature

Image, video and Touch Up generation happen in AI Studio; dialogue, music and sound effects in Audio on the Timeline tab; 3D generation in the Canvas Editor.

CategoryFeature (where)ModelCredits
ImageCreate or Enhance (AI Studio)FLUX.2 Turbo (Fast)3 per image
Create or Enhance (AI Studio)Seedream 4.5 (Quality)6 per image
Create or Enhance (AI Studio)Nano Banana 2 (Best)12 per image
Sketch with AI (Boards tab)FLUX.2 Turbo (Fast), always3 per image
Create in Coverage overview (rows set to Image)FLUX.2 Turbo (Fast)3 per image
VideoGenerate Video (AI Studio)MiniMax H3 Max (768p, default)10 per second of video; clips run 5–15 s (50–150)
Generate Video (AI Studio)MiniMax H3 (2K)20 per second of video; clips run 5–15 s (100–300)
DialogueGenerate Dialogue (Audio)Kokoro (Fast)2 per typed line; 10 per shot or scene batch
Generate Dialogue (Audio)ElevenLabs (Best)3 per typed line; 15 per shot or scene batch
MusicGenerate Music (Audio)ElevenLabs Music40 per clip (3–15 s)
SFXGenerate SFX (Audio)ElevenLabs SFX5 per clip (1–22 s)
Touch UpTouch Up (AI Studio)Nano Banana 2 (Best)12
3DCreate Object (Canvas Editor)Tripo 3D Prop15
Create Character (Canvas Editor)Tripo 3D Character (rigged)0 *

* Create Character (ActorGen) is free for now while we improve quality — its button reads Create (0cr).

Credits are deducted server-side before generation. If a generation fails, the credits go straight back and the app tells you “No credits were deducted.”

Welcome credits: New accounts start with 250 free credits — enough to try several AI features before buying a pack.

Credit Packs

Buy more credits anytime from Add Credits (see Your Credit Balance). The dialog shows three pack cards, each with its credits, price, an estimate of what it buys and a Buy Starter, Buy Standard or Buy Pro button, plus a Purchase history toggle.

PackCreditsPrice (US)Card label
Starter100$4.99Top Off
Standard400$14.99Save 25% (the highlighted card)
Pro1,200$39.99Save 33%

The pack cards round to whole dollars ($5, $15, $40); Apple’s purchase sheet shows the exact price in your currency before you pay. In the iPhone, iPad and Mac app, credit packs are bought through Apple In-App Purchase. Online review links are read-only and have no purchase flow. When a purchase completes you’ll see Purchase Successful! with your previous and new balance.

Value framing: Each pack card estimates what it buys, using the cheapest image model and a 5-second MiniMax H3 Max clip: 100 credits ≈ ~33 images or ~2 videos; 400 ≈ ~133 images or ~8 videos; 1,200 ≈ ~400 images or ~24 videos.

Low balance: below 20 credits the balance switches to its warning style, the balance menu’s first item reads Running low — Add Credits, and Add Credits opens with “Running low — add credits to keep creating.”

Running out: if a generation would cost more than you have, tapping generate opens Add Credits instead. If you’ve never bought credits, a dialog first celebrates what you made with your free credits (for example “You’ve created 12 images with your free credits.”) and offers the Starter pack (“Keep going — your next 100 credits are just $5”, Continue Creating — $5), with View all credit packs for the others.

Subscription Plans

A subscription (or the Lifetime purchase) lifts the free-mode limits: exports without a watermark, unlimited animatics and project images, and team sharing for online review. See Free Mode for exactly what the free version includes. AI features still use credits.

Where to manage your subscription. In the app: on the Projects home, open the menu (☰) and tap Purchase Options (Subscription management) — see Managing Your Subscription. Billing itself (trials, renewals, cancellations, refunds and receipts) is handled by Apple, the same as every App Store purchase; the sections below link to Apple’s own pages for each.
PlanPrice (US)Notes
Free$0Sign-in required. Watermarked exports, one animatic per project, up to 20 images per project, no team sharing. See Free Mode.
Monthly$39.99/monthFull access, cancel anytime.
Annual$119.99/yearAbout $10/month, billed yearly. The 7-day free trial is a trial of this plan.
Lifetime$359.99One-time purchase, permanent access.

The purchase screen shows each plan’s price in your own currency, straight from the App Store. While it asks, it reads Checking prices…; if the App Store can’t be reached it says why (“You’re offline.”, “Sign in to the App Store to see plans.” or “Can’t reach the App Store right now.”) with Try again, and a plan without a price shows just its name and can’t be bought yet — it never shows a made-up price.

Credits vs. Subscription: The subscription unlocks the app’s tools and removes the free-mode limits. AI generation features use credits on top of the subscription — they are a separate purchase.

Free Trial

New users can start a 7-day free trial from the purchase screen (How Your Free Trial Works → Start my free trial). The trial is the start of the Annual plan: the screen reads “7-day free trial, then $119.99 / annual” (in your currency) and shows the date your subscription starts. Everything is unlocked during the trial — no watermarks, animatics unlocked and all professional features. Unless you cancel before it ends, it renews as the Annual plan.

Avoid a surprise annual charge: the trial is a real subscription. If you don’t want to keep it, cancel before the 7 days are up — canceling after it renews is too late to stop that year’s charge. The quickest way is in the app: ☰ → Purchase Options → Manage in App Store. Set yourself a reminder rather than relying on a notification. See Canceling a Subscription.

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.

Managing Your Subscription

On the Projects home, open the menu (☰) and tap Purchase Options (subtitle Subscription management). It’s on the Projects home only, not in the menu inside a project. What opens depends on your plan:

Your Subscription panelWhat it does
Plan lineNames your plan: Monthly Access, Yearly Access or Lifetime Access (one, two or three trophies).
Manage in App StoreMonthly and Annual only. On iPhone and iPad it opens Apple’s subscription sheet right in the app; on a Mac it opens your App Store subscriptions page (apps.apple.com/account/subscriptions), which is also the fallback if the sheet can’t be shown.
Upgrade to LifetimeMonthly and Annual only. While your plan is set to renew, it first shows Cancel Your Subscription First (“To upgrade to Lifetime, first cancel your auto-renewing subscription in the App Store.”) with Manage in App Store and Back. Once it no longer renews, it opens Choose Your Plan so you can buy Lifetime.
Restore PurchasesRe-checks your Apple ID. After a short check you’ll see “Subscription refreshed.” or “No purchases to restore.”
Bulk & Education PricingOpens our education and volume pricing page.
Learn More About PricingOpens our pricing page.
DoneCloses the panel.

The bottom of the Projects home menu always shows your plan (Lifetime All Access Pass, Yearly subscriber, Monthly subscriber, Free trial or Free user) and Logged in as … with your account. Credit packs aren’t sold here — use Add Credits (see Credit Packs).

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

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

Canceling a Subscription

You can cancel from inside Previs Pro: on the Projects home, open ☰ → Purchase Options → Manage in App Store. On iPhone and iPad this opens Apple’s subscription sheet right in the app; on a Mac it opens your App Store subscriptions page. You can also cancel from your Apple account directly — Apple’s step-by-step instructions for iPhone, iPad and Mac are here:

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

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

Refunds

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

  1. Go to reportaproblem.apple.com and sign in with the Apple ID you used to purchase.
  2. Find the Previs Pro charge in your purchase history.
  3. Tap Report a Problem and choose the reason that fits your situation (most common: “I didn’t mean to purchase this item” or “I meant to cancel my trial”).
  4. Apple reviews the request and lets you know its decision by email.

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.

Sign-In Required

Previs Pro asks everyone to sign in with Sign In with Apple, free or paid. Here’s where you’ll meet it:

Paid, but sign-in can’t get through? If this device has a Lifetime purchase or an active subscription and sign-in can’t reach our server (you’re offline, or the server is unreachable), the sign-in screen adds Continue without signing in. At launch or after signing out it takes you into the app; if an AI, 3D or board feature asked you to sign in, it just closes the prompt — that feature still needs an account. It’s never offered after a wrong or canceled sign-in, or without a paid plan, and nothing is remembered: the next launch asks again.

Offline: a paid plan keeps working offline — the app reads your purchase from the App Store receipt saved on the device, so there’s no offline countdown or launch limit. If that receipt shows a subscription that is no longer current and the App Store can’t be reached to check it, you may see “We couldn’t reach the App Store. Your subscription couldn’t be checked right now.” Try again asks the App Store again; Continue for now carries on into the app without the check. See also Troubleshooting.

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 follows the Apple ID that bought it, and your credit balance follows the account you sign in with — not the individual device. Projects are saved on the device where you made them — to move one, use ☰ → Share (“Save or send a copy of this project”) inside the project, or Back Up Projects on the Projects home. To use one purchase across multiple devices:

  1. On each device, install Previs Pro from the App Store while signed into the same Apple ID you used to purchase.
  2. Open Previs Pro and tap Sign In with Apple on the welcome screen — sign-in is required before you can enter the app (see Sign-In Required). Use the same Apple ID on every device.
  3. If the app still treats you as a free user (watermarked exports, or the bottom of the ☰ menu reads Free user), open ☰ → Purchase Options on the Projects home and tap Restore at the bottom of the purchase screen (or Restore Purchases in the Your Subscription panel). This re-checks your Apple ID for an active subscription or Lifetime purchase.
Use one Apple ID across devices. Apple ties your Previs Pro subscription to your Apple ID, so the easiest way to use one purchase on multiple devices is to make sure each device’s App Store is signed into the same Apple ID, then tap Restore in Previs Pro (☰ → Purchase Options on the Projects home). If you already bought on iPad with Apple ID A and want to use the Mac with Apple ID B, the cleanest fix is to switch the Mac App Store over to Apple ID A.

“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:

Free Mode

Free mode is Previs Pro without a subscription or Lifetime purchase. You need to be signed in (see Sign-In Required), and the bottom of the Projects home menu reads Free user. Without a subscription, later launches open on the purchase screen; close it to continue in free mode.

Free-mode limitWhat happens
WatermarkExports carry a small watermark.
One animatic per projectMaking a second shows Limit Reached — “You’ve reached the maximum number of animatics allowed in a project.” Continue opens the plans; Cancel goes back. See Animatics.
Up to 20 images per projectAdding images past 20 opens the purchase screen.
No team sharingShare on the Timeline tab (online review) shows Subscription Required — “Team functionality requires an active subscription.” Continue opens the plans. See Sharing.

Everything else is included: there’s no limit on how many projects you make, adding scenes and shots on the Boards tab isn’t limited, all characters are available, and AI features work in free mode — they spend credits, starting with your welcome credits. Upgrading means, in the purchase screen’s words, “No more watermarks. Animatics unlocked and all professional features unlocked.”

Tap Restore on the purchase screen (☰ → Purchase Options on the Projects home) while signed into the Apple ID that made the purchase — this fixes most cases. The watermark is added when the app thinks this device has no active subscription or Lifetime purchase at the moment you export, so once the purchase is restored, new exports come out clean. If Restore doesn’t clear it:

If a purchase seemed to go through but the app said “This is taking longer than expected. If you completed your purchase, please restart the app to continue — your purchase is safe.”, restart Previs Pro and tap Restore if it still shows the watermark.

If the watermark persists after Restore 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 issue student discount codes. For schools and teams, the Site License link on the plans screen opens our volume pricing page, and subscribers also see Bulk & Education Pricing in the Your Subscription panel. The good news for students: the free version is fully functional for storyboarding. You can build sets, place characters, find shots, line scripts and export PDFs — exports carry a small watermark, you get one animatic per project, and team sharing for online review needs a subscription.

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 buying them. To open it, tap your credit balance on the Timeline tab (the number with a coin, beside the ?) and choose Earn Credits / Referral.

RewardAmountFrequency
Refer a friend (both get credits)+50 credits for you and your friendUp to 5 referrals per month
Share your work on social+25 creditsOnce a week (7-day cooldown)
Share a Reviewer Link (first time)+25 creditsOne time; sharing for review needs an active subscription

Referral System

Social Share

Available in the iPhone, iPad and Mac app. Tap Share beside Share your work on social: Previs Pro renders the scene you’re in (or all scenes if none is selected) with branding and your logo watermark, then opens the share sheet. When the share completes you’ll see “Shared! Credits will appear shortly.” — 25 credits, once a week. All limits are enforced on our server.

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

Script & Breakdown · Updated

Previs Pro treats your script as first-class project data. Import it once and its scenes, cast, locations, dialogue, action and transitions flow into the rest of the app: the Breakdown tab for checking and editing what came in, the Boards tab, where every scene is ready for shots, the Coverage overview for planning which shots cover which lines, and the Script panel in the Timeline. See the in-project shell for how the three tabs fit together.

Importing a script

Previs Pro imports every major screenplay format. There are three ways to bring a script in:

Supported formats:

PDF on iPhone and iPad: PDF import needs the Mac app. On iPhone and iPad the app says “PDF import requires a Mac” — import a Final Draft, Fountain, Fade In, Celtx, OSF or plain-text script instead. A scanned PDF is refused with “This PDF is a scan with no selectable text.”

What gets extracted

Each import also saves an import baseline — a snapshot of the script as it arrived. View changes compares your project with the most recent baseline, and Import revision uses it to merge a revised draft. Each successful import revision makes the new draft the baseline, and the version chip on the Breakdown tab (for example “v2 · MyScript.fdx · date”) counts up.

No script? You can still build a project from scratch. On the Breakdown tab, Add character on the Cast sub-tab opens the Character Creator, and Add location on the Locations sub-tab adds a place — no import required.

Script privacy and confidentiality

Imported scripts are stored inside your .previs project file on your device. Importing a script, the automatic casting that follows, and reviewing or editing it on the Breakdown tab send nothing from your script to Previs Pro’s servers.

The exceptions are features you explicitly trigger:

If you’re working on a confidential project and want to keep everything on the device, skip the AI features and Publish to Web, and keep the project file in local storage. Reading the script, casting it and editing it on the Breakdown tab all happen on your device.

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

Script Import Checklist

After every successful import — a new project from a script, a first import on the Breakdown tab, or an Import revision — a card titled Script Import Checklist (“Let’s ensure your script imported correctly.”) appears so you can check the result:

A row you have tapped is struck through. The top-most row you haven’t done yet is highlighted red as the suggested next step, but you can take them in any order. Review later closes the card without ticking anything and leaves you where you are. Once every row is ticked the button turns red and reads All set!; tapping it closes the card and takes you to the Boards tab.

The chevron in the card’s top-right corner (Hide checklist / Show checklist) slides the card down to a thin strip and back; tapping the card itself does the same. On a phone, tapping a Verify row slides the card aside by itself so it doesn’t cover the sub-tab. The card shows on the Boards and Breakdown tabs, hides (keeping your ticks) on the Timeline tab and while a guide or coach marks are on screen, and goes away when you open another project.

Where your script appears

Script data flows into several places once it’s imported:

The Breakdown tab

The Breakdown tab (formerly the Screenplay Manager) is where you check and edit everything that came in from your script — in film terms, the script broken down into its scenes, cast and locations. It is the left-hand tab of the three at the top of every open project, and it has three sub-tabs: Script, Cast and Locations.

Where to find it

If you switch to Breakdown with a shot selected on the board, the tab opens with that shot’s scene expanded.

Layout

With no script yet, the tab says “No script imported” with an Import script button; the Cast and Locations add buttons still work. In a read-only project (an online review session) the edit and delete icons are hidden; Copy still works.

The first time you open the Breakdown tab in one of your own projects with a script, five coach marks name the controls: Script tab, Cast tab, Locations tab, View changes (“Track changes made from your originally imported script”) and the import button (“Import new script revisions to update your project as production progresses”). They don’t appear in tutorial projects, and they show only once.

UI elements at a glance

ElementLocationTarget ID
Breakdown tabShell tab bar, left segmentshell.tab.breakdown
Script sub-tabTop left, document iconbreakdown.tabScript
Cast sub-tabTop left, person iconbreakdown.tabCast
Locations sub-tabTop left, map-pin iconbreakdown.tabLocations
Add characterCast, top rightbreakdown.addCharacter
Add locationLocations, top rightbreakdown.addLocation
SearchSecond rowbreakdown.search
All Scenes menuSecond row, right (Script and Cast)breakdown.sceneFilter
Version chipThird row, leftbreakdown.versionChip
View changesThird rowbreakdown.viewChanges
Import revision / Import scriptThird row, rightbreakdown.importRevision
Scene info (pencil)Expanded scene cardbreakdown.sceneInfo
Delete scene (trash)Expanded scene cardbreakdown.deleteScene
Copy / Edit / Delete lineRight of each script line in an expanded cardbreakdown.elementActions
Cast headshotLeft of each cast cardbreakdown.castHeadshot
Edit character / Update modelExpanded cast cardbreakdown.editCharacter

Script

One card per scene, in script order. Each card shows the scene number, the full slugline (for example “EXT. DINER - DAY”) and three counts: cast members, dialogue lines and action lines.

What you can edit on a line:

An edit opens a text box with Save and Cancel (Escape also cancels). Omit Scene is not here: it is on the scene’s menu on the Boards tab (see the scene menu).

Cast

After an import, every speaking character is cast automatically: Previs Pro picks a 3D body from its built-in cast, guided by the character’s name and by how the script describes them. The pick is made on your device, with no AI call and no credits, and the same body is used in every shot. After an Import revision, newly added characters are cast the same way.

For managing characters in your scenes, see the cast list.

Locations

One card per location named in the sluglines, in alphabetical order, with the number of scenes that use it. Scenes with no location sit on an UNASSIGNED card at the end. Locations has a search field but no All Scenes menu.

To keep a scene’s 3D look for reuse, use Save as Set in Scene info; Add existing set there opens the Set Library. See Sets.

Suggest coverage

The Coverage overview lists the shots in one scene, lets you edit them as a table, and can ask AI to suggest a complete set of coverage from the scene’s script.

Where to find it

In a project with no script, both buttons open Suggest coverage from your script instead, with Import script and Learn more.

The shot list

Opening the Coverage overview costs nothing: the rows are the scene’s current shots. The columns are # (the shot number; tap it to select the row), Size, Angle, Move, Lens, Dur, In frame and Description. After a Suggest run a Type column (3D or Image) appears, and an Image Prompt column when any row is typed Image.

Suggesting shots

Under the shot list, Suggest coverage (or Regenerate coverage once the scene has a suggestion) asks AI to read the scene and propose its coverage. The button shows the price and time: about 4 credits and 15 seconds (see Credit costs). On a scene nobody has worked on yet, it sits in a two-step card: 1. Read & Suggest and 2. Confirm & Create.

Why these shots?

After a Suggest run, Why these shots? opens by itself, listing each shot’s number, size, angle and movement with the AI’s reason for it. Close it with Got it. The reasons are kept with the shots, so the Why these shots? button under the Suggest button reopens the list later, here or in the Canvas Editor’s Coverage overview.

Image rows

After a Suggest run, each row’s Type can be 3D or Image. Inserts, point-of-view shots of a vista, empty wide, establishing and aerial shots, and exteriors with nobody in them start as Image. An Image row gets an editable Image Prompt written for you, and when you press Create it is generated as a still with FLUX.2 Turbo, at 3 credits per image. The Create button then shows a sparkle and the total. If an image can’t be generated, that shot is left empty and you are not charged for it.

Applying

Afterwards the Coverage overview closes and the scene opens on the board showing its shots. To turn a shot into an image afterwards, use Sketch with AI.

From suggested shots to 3D

Create makes one shot per row, carrying its size, angle, movement, lens, duration, description, coverage lining and color. In each new shot the scene’s speaking characters stand in a row facing the camera (the one with the most lines first, about a meter apart), lit by the default three-point lighting, with the camera raised just enough to keep their heads in frame. A scene with no dialogue gets default shots with no characters.

From there, stage each shot yourself: select it on the board and use Build in 3D or Edit in 3D to open it in the Canvas Editor, where the Coverage overview stays beside the 3D view. Or turn the shot into an image with Sketch with AI.

In the Example scene guide (on the New user guides shelf) the suggested shots are blocked in 3D for you — characters placed, cameras framed, and any props stood in by labeled crates — so you can see the whole flow end to end. In your own projects, Create makes the shots and you do the staging.

Lining the script

A lined script shows which shot covers which part of the scene. Previs Pro draws it in the Coverage overview’s script pane: each shot’s coverage is a colored vertical line over the script, with a bubble carrying the shot number (for example “1A”) above the first line it covers and a small tick under the last. Coverage can skip lines — the line simply stops and starts again.

Editing the lining

  1. Select a shot: tap its # in the shot list, or its line in the script pane. Selecting a shot starts editing its coverage straight away: a color swatch and Done appear under the script.
  2. Tap lines in the script to cycle that shot’s coverage: none → straight → wavy → none. Tap the swatch to pick a different color if you like.
  3. Tap Done (or press Escape) to stop editing.

Up to four shots can cover one line; a fifth is refused with “Up to 4 shots can cover one line.” In the board’s Coverage overview nothing is saved until you press Apply or Create. In the Canvas Editor’s Coverage overview every change saves the moment you make it.

View changes

View changes (on the Breakdown tab, beside the version chip) compares your project with the most recent import — the left column is headed with that import’s version (“v2 Import”), the right column Current Project. It shows scenes, cast or locations depending on which sub-tab you were on. Use it to see what you’ve edited since the import, or to check a project before sharing it. The back arrow at the top left returns to the Breakdown tab.

Scene, cast and location cards

On the Script view, lines between the two columns connect each scene to its match, in the same colors. On the Cast view a character with no dialogue left shows NO LINES.

Line-by-line view

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

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

In the line-by-line view, changed lines highlight the exact words: added words on a green background, removed words struck through in red. On the list view, the summary line counts modified, added, deleted and unchanged items, Show only changes hides unchanged cards, and the First / Previous / Next / Last arrows jump between changes.

Import revision

If your script changes after the project is built — new scenes, cut scenes, dialogue rewrites — bring the revised draft in with Import revision (formerly Import New Version) instead of starting over. Scenes that match keep their shots and blocking, and new characters are cast automatically.

  1. Open the Breakdown tab and tap Import revision (to the right of the version chip). You can also drag the new file anywhere onto the Breakdown tab.
  2. Pick the revised script. While the file picker is open and the file is read, the app shows “Waiting for screenplay file…”; after 10 seconds a Dismiss button appears if you need the app back.
  3. Previs Pro compares the new draft with your project and opens the review, side by side: Current (your project) on the left, Incoming (the new draft) on the right.

Reviewing the revision

The review uses the same cards, colors and line-by-line view as View changes. Switch between Script, Cast and Locations with the icons at the top left, narrow the list with Filter (All, Matched, Added, Omitted, Conflicts) or Show only changes, and shape what gets merged:

Removed scenes are deleted. A scene marked REMOVED that is still ticked is deleted with its shots when you apply. Untick it to keep it. The same applies the first time you import a script into a project that already has scenes: every existing scene is shown REMOVED and is replaced unless you untick it. Scenes you added yourself since the last import are kept.

The Cast and Locations views have no Approved boxes: characters and locations follow their scenes. A character with no lines in the new draft shows NO LINES and stays in your cast — remove it from the Cast sub-tab if you no longer need it. A revision read from a PDF shows a note asking you to check the scenes and cast.

While the review is open, the Breakdown, Boards and Timeline tabs and the ? and menu buttons are unavailable; the home button, the Escape key and Cancel all ask Discard this import? first.

Applying the revision

When the review shows what you want, tap Apply. “Importing screenplay…” covers the app until the merge finishes — a minute or more for a long script — and a “Script revision imported” message confirms it. Cancel asks Discard this import? first: Discard Import throws away your review choices and leaves the project unchanged; Keep Reviewing goes back.

Afterwards the Script Import Checklist appears with Review changes from prior revision at the top.

Long scripts: Import revision, and a first import done on the Breakdown tab, send the whole merge to the app in one go, and that is capped at about 281,000 characters of script — roughly 100 pages, and only about half that for a heavily rewritten draft. A longer script is refused with “This screenplay is too large to apply in one go.” Your review choices stay on screen; Cancel discards the import. For a feature-length script, start the project with New Project from Script on the Projects home, which imports the script a different way and does not go through this review.

If an import fails

Problems before the review opens show in an Import failed banner with a Dismiss button; a failed Apply shows a Couldn’t apply this import banner inside the review instead. Canceling the file picker is not an error.

MessageWhat to do
“That file type can’t be imported.”Choose a Final Draft, Fountain, PDF (Mac) or plain-text script. On iPhone and iPad the picker can’t hide other files, so this is easy to hit.
“That file couldn’t be opened.”The file may have been moved or renamed, or the app may not have permission to read it. Pick it again.
“That screenplay couldn’t be read.”Open it in your writing app, re-save it, and try again.
“This screenplay file’s version isn’t supported.”Re-save it from your writing app and try again.
“PDF import requires a Mac.”Import the PDF on a Mac, or use another format on iPhone and iPad.
“This PDF is a scan with no selectable text.”Export a PDF from your writing app, or use another format.
“That file is too big to import. Screenplays must be under 15 MB.”Shown for a file dropped onto the Breakdown tab.
“That file couldn’t be transferred.”Drop it again, or use the import button.
“Couldn’t apply this import”Your review choices are still there. Press Apply to try again, or Cancel to discard the import.
“The import couldn’t be completed.” with a codeTry again; if it keeps happening, contact support and quote the code.
Tip: After a successful import revision, View changes compares against the new draft, not the original script. To keep a copy of the project as it was, use Duplicate on the project’s menu on the Projects home before you apply.

Script panel (Timeline)

Where to find it

Script panel

Displays the script for the current scene beside the viewer, following playback. Supports:

With no script in the project the panel says “No script imported”. In a read-only review session the bottom buttons are hidden.

Script panel UI elements

ElementLocationTarget ID
Info barTop of panel. “Last Modified: [date]” (when the project was last saved); “Temp. Shot Script” once the scene’s text has been edited here; “Revisions for Quick Share. Unsaved.” in Punch Up.scriptPanel.headerDate
HelpTop-right of panel (?). Opens the Final Draft tutorial page on previspro.com in your browser.scriptPanel.helpButton
Close panelTop-right of panel (X)scriptPanel.closeButton
Revert to original scriptInfo bar, in Punch Up once you’ve edited. Asks Revert Punch Up? and restores the original text.scriptPanel.revertPunchUp
Scene headingFirst bold line of the body (e.g. “EXT. NEW YORK STREET — DAY”)scriptPanel.sceneHeading
Script bodyThe formatted script below the heading. Scrolls along during playback.scriptPanel.body
Clear Annotations (trash)Bottom of panel, far left, when the scene has drawings. Asks Clear All Annotations? first; it can be undone.scriptPanel.clearAnnotations
ScriptBottom of panel, left. The formatted script (the default view).scriptPanel.tab.script
Punch UpBottom of panel, center. Switches to the editable text copy.scriptPanel.tab.punchUp
Draw on script (pencil)Bottom of panel, right. Opens the pen / highlighter / eraser tools. Unavailable during playback and in Punch Up.scriptPanel.annotateButton

Lining the script

Script lining — colored lines showing which shot covers which part of the scene — lives in the Coverage overview on the Boards tab and in the Canvas Editor. See Lining the script.

Sharing & Review · Updated

Send your timeline to collaborators as a password-protected review link they open in any browser. Reviewers can play it, comment on shots, draw doodles and set approval statuses, and their feedback flows back into your project.

Two different “Share” actions. Share in the in-project menu (☰) — “Save or send a copy of this project” — packages the .previs file itself and hands it to the system so you can save it or send it on (see Project actions). While it packages, a Preparing project… screen shows, with a Dismiss button after about 10 seconds; on the Mac a Save or Share? chooser follows. A review link is different: it comes from the Share button on the Timeline tab, described below.

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

  1. On the Timeline tab, tap Share at the right end of the transport bar. (Share has no keyboard shortcut.)
  2. Under Link expiration, choose 7 days, 30 days or 90 days (7 days is preselected), then tap Create Review Link.
  3. When the upload finishes (“Review link created!”), the dialog shows the Link and a generated Password, each with a Copy button, plus Copy Link + Password to copy both at once. Reviewers need both.
  4. Send the link and password to your reviewers. The link looks like https://share.previspro.com?session=SESSION_ID.

The review link carries your shot images, shot videos (including animatic and AI videos), transition videos, audio clips, comments, doodles and approvals, all uploaded to the cloud; from the app it also carries your cast headshots. In the app, sharing first re-renders any shot images that are out of date; a full-screen Sharing project… screen shows the upload’s progress (for example “Uploading thumbnails (3/20)...”) on whichever tab you’re on until it finishes. In 3.6.0 sharing is faster on large projects, and the app stays on screen with this progress instead of going dark during the upload.

Joining a review

What your reviewers see when they open the link:

Comments

Where to find it

Comment Panel UI elements

ElementLocationTarget ID
Scene titleTop of panel, left (“Scene 1”, “Scene 2”, etc., bold). The panel lists every comment in the selected shot’s scene; opening it with nothing selected selects the shot under the playhead.commentPanel.sceneTitle
Comments labelTop of panel, next to Scene titlecommentPanel.title
Copy all commentsTop of panel, right group (duplicate-pages icon; appears once the scene has comments). Copies the scene’s comments as text, each line tagged with its author and shot.commentPanel.copyAllButton
Delete all comments for this sceneTop of panel, trash icon next to Copy (in the app only; appears once the scene has comments). Removes every comment and doodle in the scene.commentPanel.deleteButton
Your reviewer nameTop-right of the panel. Shows the name your comments are posted under (your account name when you’re signed in).commentPanel.reviewerName
Comment rowEach entry in the scrollable thread: colored avatar initial, author name, a Creator badge on your own comments when you’re the project creator, shot tag (“Shot 1A”), a pencil icon when the comment carries a doodle, timecode, age (e.g. “51d ago”), body text, and Reply / Delete actions. Replies are indented under the comment they answer.commentPanel.commentRow
Comment — ReplyAction link under each row, opens a reply inputcommentPanel.commentRow.reply
Comment — DeleteAction link under each row. Shown on your own comments; the project creator can delete any comment. Deleting a comment also deletes its replies.commentPanel.commentRow.delete
Add comment inputBottom of panel (“Add a comment...”)commentPanel.addInput
SendBottom-right of panel (disabled until the input has content)commentPanel.sendButton

Reviewer Colors

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

Blue Red Green Amber Purple Cyan Deep Orange Pink

Doodle Annotations

Draw directly on the shot viewer to provide visual feedback.

Where to find it

Approvals

Each shot has an approval status visible in the timeline:

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

Change the current shot’s status with the status pill at the right of the Timeline header, next to the comment icon (tooltip “Change approval status”); anyone in a review can set it. Posting a comment (not a reply) or doodle on a Pending or Approved shot sets it to Notes automatically. Shots with comments show a marker on their bar in the shot lane, colored by status, and the scene pill turns green when every shot in the scene is approved. Each change is kept as a new revision and the newest one wins.

Publish to Web

Publish a permanent web page of your timeline, separate from the time-limited review link. Publish to Web is a tab of the export hub in the browser version of the Timeline only; it isn’t offered in the iPhone, iPad or Mac app, and it needs you to be signed in.

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

Animatics · Updated

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.

Where to find it

Entering Animatics Mode

In the Canvas Editor, tap the Animatics button (the tab beside the shot list; its coach mark reads “Turn this shot into an entire animatic sequence”). The title bar switches to the animatics title bar (scene and shot name, Done, Undo, Redo), and a horizontal continuing shot list holds the sequence. To leave, tap the tab right under CAM to return to the standard canvas, or tap Done, which also returns to the canvas, or to the Boards tab when you opened the animatic from there. Either way, if the animatic changed, the app first renders its video (see Animatic videos).

Keyframing

Camera and actor moves in 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. In free mode a project can hold one animatic (“You’ve reached the maximum number of animatics allowed in a project.”).

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

Workflow:

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

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

Two object actions help keep a sequence consistent: Reset returns an object’s position and animatable properties to the prior continuing shot, and Propagate copies them to every later continuing shot. Both ask for confirmation and can’t be undone.

Two different “keyframes” in Previs Pro. Animatics Mode (this section) lets you set as many keyframes per shot as you want for camera and actor moves. A separate feature, the First/Last Shot Video task on AI Studio’s Enhance tab, makes an AI video between exactly two images: the current shot is the start frame and the next shot is the end frame. If you want more than two keyframes, use Animatics Mode.

Playback

Motion Paths

In the 2D overhead view, each moving object’s path is drawn as a smooth curve through its keyframe positions, with a marker at each keyframe showing position and facing. On the selected object’s path, a small tick marks every second of movement: closely spaced ticks mean slow movement, wide spacing means fast.

Animatic videos

Each animatic has a rendered video, which is what plays for that shot outside the Canvas Editor.

Editing or reverting an animatic

Limits:

Animatic Export

The export button in Animatics Mode steps out of Animatics Mode, opens the export panel for this shot (see PDF Storyboard & Images) and brings you back into Animatics Mode when you close the panel. Choose MP4 for a video of the move; a regular project MP4 export also plays every animatic shot in full. For stills, the Animatics Frames layout writes a frame every 2 seconds. Animatic videos also travel in the HTML export (with Include video shots), in review links and in NLE export.

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 · Updated

There are two export surfaces. The native export panel makes PDF storyboards, PNG/JPEG images and MP4 video: open it from Export in the in-project menu (☰) or the Boards panel’s project actions, from Export Scene in a scene’s menu or Export in a shot’s menu on the board, or from Export in the Canvas Editor’s menu. The export hub (the Export button in the Timeline tab’s transport bar) handles the HTML player, NLE handoff and, in the browser version only, Publish to Web.

The export hub

A tabbed dialog for the exports that come from the Timeline.

Where to find it

UI elements at a glance

ElementLocationTarget ID
Export buttonTimeline tab, transport bar, right group. Hidden in review sessions; disabled until a project is loaded.timeline.exportButton
Download HTMLFirst tab, selected when the hub opens. See HTML Player.exportHub.downloadHtmlTab
Publish to WebSecond tab, in the browser version only (not in the iPhone, iPad or Mac app). See Publish to Web.exportHub.publishTab
Export for NLELast tab. See NLE Export.exportHub.nleTab
CloseTop-right ×exportHub.closeButton

PDF Storyboard & Images

Choose PDF in the export panel for a printable storyboard; JPEG or PNG writes the same pages as image files. The same panel makes MP4 video.

Where to find it

MP4 Video

Choose MP4 in the export panel to render your storyboard as a video with the Timeline’s audio, at the project’s Animatic Frame Rate. Layouts are Simple or Annotated. Force 1s shots (shown when the project has no animatics) holds every shot for one second; Omit titles (shown when it has animatics) leaves out the project and scene title cards. An MP4 can hold up to 999 shots. MP4 export is available to everyone, including in free mode (the free-mode limits are the ones listed there).

If the MP4 doesn’t look how you expected

HTML Player

On the Timeline tab, tap Export in the transport bar and choose the Download HTML tab 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. In the app, Export hands the file to the Mac’s save panel or the iPhone/iPad share sheet; in a browser it downloads. The file is named after the project with a timestamp.

New in 3.6.0: the HTML export now includes animatic videos (with Include video shots) and audio you recorded in the app, both of which were missing before.

NLE Export (FCP7 XML)

Hand off the editorial timeline to a non-linear editor for finishing. On the Timeline tab, tap Export in the transport bar and choose the Export for 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). Cmd+E on the Timeline tab opens the export hub straight on this tab.

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

Markup & Annotations

Freehand drawings on your shots in the Canvas Editor (from older projects; Draw Mode has been retired) appear in still exports while Show markup is on in the export panel (it is by default). Reviewer doodles from the Timeline travel with review links, and with HTML exports when Include doodles is ticked (see Doodle Annotations).

See also: Storyboards articles on the support site.

Keyboard Shortcuts · Updated

Keyboard shortcuts work on a Mac, and on an iPad with a hardware keyboard. Each place in the app has its own set: the Boards tab, the Timeline tab and the Canvas Editor. On the Timeline tab, press ? to open the in-app Keyboard Shortcuts list. Single-key shortcuts don’t fire while you’re typing in a text field.

Key symbols: ⌘ Command, ⌥ Option, ⇧ Shift.

Boards tab

ActionShortcut
Copy the selected shot (in Select mode, the ticked shots)⌘+C
Paste the copied shot(s) after the selected shot, or after the last shot when none is selected⌘+V
Next / previous shot⌥+⌘+→ / ⌥+⌘+←
Step back one levelEsc

Timeline tab

ActionShortcut
Play / pauseSpace
Shuttle reverse / stop / forward (press J or L again to go faster, up to 8×)J / K / L
Seek back / forward 1 second← / →
Jump to start / endHome / End
Next / previous shot (selects it and moves the playhead to its start)⌥+⌘+→ / ⌥+⌘+←
Pause at each shot boundary (step mode) on / offR
Zoom the timeline in / out+ / −
Fullscreen viewer on / off (Esc also exits)F
Comments panel on / offC
Generation History panel on / offH
Doodle on the shot (draw mode) on / offD
Undo / redo (also works while typing)⌘+Z / ⇧+⌘+Z
Delete the selected audio clip (asks first)Delete or Backspace
Open the export hub on Export for NLE⌘+E
Show the Keyboard Shortcuts list?
Step back one level (see Escape on the Timeline)Esc

AI & Audio (Timeline tab)

ActionShortcut
Open AI Studio on the Enhance tab (press again to close)⌥+I
Open AI Studio on the Enhance tab with the Video task (press again to close)⌥+V
Open the Audio workspace on the TTS tab⌥+S
Audio workspace on / off⌥+A

These aren’t available in a shared review.

Canvas Editor (3D and 2D)

In the Canvas Editor most keys act on the selected object. With nothing selected, the arrow keys and Q / E move the view instead. Hold ⇧ with a move, nudge or rotate key, or with ⌘+↑ / ⌘+↓, for a bigger step.

ActionShortcut
Switch between 2D and 3DSpace
Move the selected object forward / left / back / right (in 2D: up / left / down / right)W A S D
Nudge the selected object: in 3D, ↑ / ↓ raise and lower it; in 2D they move it up and down. ← / → move it left and right. With a rotation tool active the arrows rotate the object instead; with the camera or spotlight angle tool active, ↑ / ↓ narrow and widen the angle↑ ↓ ← →
Rotate the selected objectQ / E, or ⌘+← / ⌘+→
Cycle the editing tools for the selected object (3D)Tab / ⇧+Tab
Duplicate the selected object⌘+D
Delete the selected objectDelete or Backspace
Copy the selected objects (with their group); with nothing selected, copy the current shot⌘+C
Paste copied objects into the current shot, or a copied shot after the current one⌘+V
Undo / redo⌘+Z / ⇧+⌘+Z
With nothing selected: move the view (3D: forward / back / left / right; 2D: pan the canvas)↑ ↓ ← →
With nothing selected: rotate the viewQ / E, or ⌘+← / ⌘+→
Zoom the view in / out (⌘+↑ / ⌘+↓ zoom only when nothing is selected)+ / −, or ⌘+↑ / ⌘+↓
Tilt the 3D view down / up⌥+↑ / ⌥+↓
In 2D, narrow / widen the selected camera’s or spotlight’s angle⌘+↑ / ⌘+↓
Open the Pose menu for the selected character⌘+P
Pose the selected custom character by hand (opens the pose editor)⌥+⌘+P
Next / previous shot⌥+⌘+→ / ⌥+⌘+←
Back to the Boards tab (inside a mode it leaves that mode instead: it stops picking a Look at point or closes a finished orbit)Esc

Director’s View (CAM)

While you’re framing a shot in CAM, these keys move the camera. Hold ⇧ for a bigger step.

ActionShortcut
Move the camera forward / left / back / rightW A S D
Raise / lower the camera⌥+↑ / ⌥+↓
Pan left / right← / →
Tilt up / down↑ / ↓
Roll (Dutch angle) left / rightQ / E, or ⌘+← / ⌘+→
Zoom in / out⌘+↑ / ⌘+↓
Zoom to the next prime focal length (on a full-frame sensor; otherwise a big step)⇧+⌘+↑ / ⇧+⌘+↓
Keep the camera changesReturn
Cancel and discard the camera changesEsc (or Delete / Backspace)
Next / previous shot, keeping your camera changes and staying in CAM⌥+⌘+→ / ⌥+⌘+←

In AR (iPhone and iPad), Space switches between tabletop and life-size, and Esc closes the AR options, then returns to the canvas.

Discontinued & Replaced Features · Updated

The following features from earlier versions of Previs Pro have been replaced or removed, including the changes in 3.6.0. If you’re looking for one of them, here’s where to find the equivalent.

Former FeatureStatusReplacement
Post Mode Removed Post Mode’s image tools now live in AI Studio on the Timeline tab: Create (text to image), Enhance (restyle a shot, or turn it into video) and Touch Up (prompt-based fixes). On the Boards tab, Sketch with AI makes a quick image without leaving the board. Drawing over a shot is now Doodle.
Light Grade Replaced Describe the lighting and mood in the prompt on AI Studio’s Enhance tab (for example “Film Noir, high contrast”) — see AI Lighting & Atmosphere. To change the 3D scene itself, use the scene’s lighting and the project’s Tone Mapping.
Set Pieces Replaced The “Set Piece” toggle (which made individual objects global across all shots) has been replaced by sets. Save a whole room layout with Save as Set in Scene info, then use Add existing set in another scene’s Scene info to apply it from the Set Library. See Sets.
AI Transitions (Pre-Timeline) Replaced Now the Continuous transition: open the transition menu between two shots on the Timeline and choose Continuous. It opens AI Studio with the First/Last Shot Video task, which generates an AI video that blends the two shots. See Transitions and AI video.
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. The built-in Character Creator is the way to build a custom person now (pick a body and customize their look), with ActorGen for generating characters from a text description. Existing RPM characters in older projects continue to work; only the old in-app builder is gone.
Wan, Veo, Kling and Seedance video models Replaced The video model list is now MiniMax H3 Max and MiniMax H3 (2K), priced per second of video (5–15 seconds). See AI video and credit costs.
Scene Manager Replaced The Boards tab — one of the three tabs in every project (Breakdown | Boards | Timeline). Every scene is a row of shot tiles, with a side panel for Shot info, Scene info and Project info.
Screenplay Manager Replaced The Breakdown tab, with Script, Cast and Locations sub-tabs.
Paywall on first launch Replaced A first-launch landing page with Sign In with Apple and View purchase options. Once you’re signed in, Let’s get started takes you in. Signing in is required first, even if you already have a subscription. See Sign-in required.
Polish & Share dialog (the G key) Removed The New user guides on the Projects home — start with Getting started, which walks you from script import to a rendered, played-back scene.
Help item in the ☰ menu Removed Tap ? in the top bar to open Previs Assist (it can open this wiki even offline), or choose Contact Us in the ☰ menu to reach a person. The support site is linked at the bottom of this page.

System Requirements · Updated

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

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

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

Minimum OS

RAM by Device

Every iPhone and iPad released in 2022 or later has at least 4 GB of RAM. Older models are listed below by memory.

RAMDevicesExperience
8+ GB iPhone 15 Pro and Pro Max, every iPhone 16 and iPhone 17 model (including iPhone 16e and iPhone Air); iPad Pro with M1 (2021) or later; iPad Air with M1 (2022) or later; iPad mini (A17 Pro, 2024); Macs with Apple silicon Excellent — Large projects, many imported assets, complex scenes.
6 GB iPhone 12 Pro and Pro Max, iPhone 13 Pro and Pro Max, every iPhone 14 model, iPhone 15 and 15 Plus; iPad Pro 11-inch and 12.9-inch (2020); iPad (A16, 2025) Good — Comfortable for most projects.
4 GB iPhone XS and XS Max, every iPhone 11 model, iPhone 12 and 12 mini, iPhone 13 and 13 mini, iPhone SE (3rd generation); iPad Pro 10.5-inch and 12.9-inch (2017), iPad Pro (2018); iPad Air (2020); iPad mini (2021); iPad (10th generation) 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 (for example iPhone XR, iPhone SE 2nd generation, iPad 6th–9th generation, iPad mini 5th generation and iPad Air 3rd generation) can install the app on iOS 17 but are not supported: expect crashes on anything but small projects.

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:

On iPads with less than about 3.5 GB of RAM, and on the 2017 iPad Pro models (10.5-inch and 12.9-inch 2nd generation, which can’t update past iPadOS 17), Previs Pro automatically keeps fewer shot thumbnails in memory and uses lighter textures in the Character Creator to avoid running out of memory. iPhones and Macs are unaffected.

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 hello@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 · Updated

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 hello@previspro.com with your device model and what you were doing when it happened.

Blank, Black or Frozen Screen

The Projects home, the Breakdown, Boards and Timeline tabs, and Previs Assist are drawn by a web view built into the app. If one of them misbehaves, Previs Pro tries to fix it for you and gives you a button when it can’t:

Previs Pro saves your work as you go; there’s no Save button to press before you reload.

Two messages that look similar aren’t errors. On an iPhone, “Rotate your device to continue” means the screen you’re on needs landscape. On an iPad in a narrow Split View window, “Increase window size to continue” means the window is too narrow. While the Canvas Editor is open, Return to board takes you back to the Boards tab.

Still stuck? Force-quit Previs Pro and reopen it. If the problem keeps coming back, email hello@previspro.com with your device model and what you were doing.

Working Offline

Your projects live on your device and the app’s screens are built into it, so you can open and edit projects without a connection.

These need a connection:

Help offline. If you ask Previs Assist a question with no connection, it shows “No network connection, load local wiki?”. Tap Load wiki to open the copy of this wiki that’s built into the app, already searching for what you asked.

The App Store can’t be reached. On the purchase screen, the price area shows “You’re offline.” or “Can’t reach the App Store right now.” with Try again (it reads Checking… while it retries). If no App Store account is signed in on the device, it says “Sign in to the App Store to see plans.” While prices are unknown, the plan buttons show the plan name (Monthly, Annual, Lifetime) instead of a price, and “Checking prices…” shows while the app waits for the store.

If you already subscribe and the App Store can’t confirm it, you’ll see We couldn’t reach the App Store. “Your subscription couldn’t be checked right now.” Tap Try again, or Continue for now to carry on into the app. You keep your access either way.

Signing in offline. Previs Pro asks you to sign in (see Sign-in required). If you’ve paid — a subscription or Lifetime purchase on this device — and sign-in can’t reach the server, the sign-in screen offers Continue without signing in. The app asks again at the next launch. The free mode always needs a signed-in account, even offline.

Missing Textures on 3D Import

Import the single-file .glb, which carries its textures inside it. If your model is a multi-file glTF with separate texture files, see Tips for clean imports.

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. AR is available on iPhone and iPad only.

Audio Not Playing

Credit Balance Not Updating

Your credit balance refreshes after you sign in, after a purchase, after you earn credits, and whenever you switch back to Previs Pro. If it still looks wrong, sign 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 interface is translated into 11 languages (English, Italian, Swedish, Spanish, French, German, Portuguese, Japanese, Simplified Chinese, Traditional Chinese and Korean). Workarounds and reporting tips:

After an Update, Something Doesn’t Look Right

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

Recovering a Project That Won’t Open

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