Skip to main content

Video Producer

Every AI video tool can generate clips. AdaL produces finished videos.

Video Producer is built into AdaL. There is nothing to install, no plugin to enable and no API key to add. Describe the video you want in plain words and AdaL handles the rest — planning, generating shots, editing, and rendering.

It writes a plan into your project, then generates or cuts the clips it needs: titles, voice-over, music, sound effects, or the footage you already have. It trims, sets levels, adds transitions, and measures the result (length, loudness, pacing) instead of guessing. Every change you ask for becomes a new version you can play, compare, or roll back to. Every file stays in your project folder, tagged with where it came from and the prompt that made it.

Video Producer loads when a task involves video, audio or a screen recording — making or editing one, and also watching, transcribing or analyzing one, or generating voice-over, music or sound effects. You do not have to say "video". It never appears during ordinary coding sessions. See Capabilities.

macOS 15 or later

Saving a video needs macOS 15 (Sequoia) or later. On macOS 13, AdaL can show still frames of a scene but cannot save it as an MP4. macOS 14 is untested. Windows and Linux are not affected.

1. Ask for a video​

Open a chat in a project folder and describe what you want — length, aspect ratios, and what the viewer should take away. For example:

Make a 10-second cinematic teaser for a fictional coffee brand called Ember:
a photoreal hero shot of a steaming cup at golden hour, slow push-in, the word
EMBER revealed in elegant animated type, subtle sound design, and an end card.
Deliver 16:9 and 9:16.

AdaL writes its plan, generates the clips, and renders both sizes. When it finishes it tells you where the files are.

A new project gets its own folder in ~/AdaL/Videos/, no matter which folder the chat is working in. To keep projects somewhere else, set video_projects_dir in ~/.adal/settings.json:

{
"video_projects_dir": "~/Movies/AdaL"
}

To revise, keep talking in the same chat: "make the reveal slower", "swap the hero shot", "go back to version 4". Each message creates a new version.

2. Find the video in Files​

Open the Files panel. AdaL marks video projects so you can spot them in a large folder:

The Files panel with an AdaL video project expanded

MarkWhereMeaning
Pink AdaL video tagThe project folderThis folder is an AdaL video project
▦ 8The assets/ folder8 files in the project's media library
Pink dotA .mp4 fileA rendered video. Hover to see how many versions it has

Hover the assets/ folder and click Open media to browse the media library (see step 5).

3. Watch the video and its timeline​

Click the .mp4 with the pink dot. It opens with two tabs: ▶ Video and ⑂ Canvas.

▶ Video plays the current version. Below the player is the timeline:

The video player with its timeline of picture, voice, music and effects tracks

Each row is a track — picture and overlays at the top, then source sound, music, and effects. Each block is one clip, labeled with its file name and the segment in use (0–7.5s means the first 7.5 seconds). Drag the playhead or click a clip to jump to its source file.

A picture clip shows a filmstrip: frames taken from the video the player plays, at that clip's own times on the timeline, one frame per 16:9 slot the clip is wide. So an animated title, an overlay, a color grade or a crossfade shows as it was rendered, not as its source file looks. Zoom in and a clip holds more frames, from moments closer together. Audio rows keep their waveforms.

4. Compare versions on the Canvas​

Click ⑂ Canvas. Every version appears as a card, in the order it was made. The card with the pink border and the CURRENT tag is the version the .mp4 holds right now.

The Canvas with six versions of the Ember teaser in a row

Each card shows a still and a short note about what changed, for example "remove color grade blowing out exposure".

A long branch does not draw every card. It keeps its first version and its last three; three or more versions in between collapse into one stack card — "+25 versions hidden", with the range it covers ("v13 – v37") and a Show 10 more pill. A click brings out its 10 newest versions and the stack stays put. The current version, the selected one, the one you are comparing against, and any version another branch starts from never fold. The lines into and out of a stack are dashed, because versions are skipped there.

Next to each branch's name are « and », which jump to its first and latest version, and Show all / Fold for the whole branch. Home and End do the same for the branch you are on.

Drag a card to move it. A drag does not open the card, and the move stays put while you keep the Canvas open, even when the tree is laid out again because a version was saved or a branch was unfolded. Stack cards cannot be moved.

Click a card to open it on the right:

A version opened from the Canvas, with its preview, the changes and an Export button

From here you can play that version, use Compare with… to play two versions side by side in sync, read what changed, or Export v4 to turn the card's details into the export panel for that version.

To make an older version the current one, ask in the chat: "go back to v4". Press Esc to return to the player.

Export a file to share​

Export at the right end of the ▶ Video · ⑂ Canvas row exports the current version; Export v4 on an opened card exports that version. Both open the same panel, with four choices:

ChoiceOptionsDefault
QualityStandard, HighStandard
Size1080p, 4Kthe cut's own size
FormatMP4, WebM, MOVMP4
Frame rate24, 30, 60the cut's own rate

The defaults are the fastest export: AdaL copies the file it already drew for that version, which takes seconds. High draws the video again at a slower, higher-quality setting, which takes minutes. A different size or frame rate is also a new draw; a different format alone is a conversion, in seconds.

The button follows your choices. When the file for them already exists it says Reveal in Finder (or your file manager) instead of writing it twice. Exports go to videos/<name>/exports/; the drawn .mp4 and the current version do not change.

5. See every asset the video uses​

Hover assets/ in Files and click Open media. The Media tab shows every clip, image, and sound in the project — with its duration and where it came from:

The Media tab with a grid of generated clips

Use Filter to narrow the list to one video's assets. Click any asset to see its details:

An asset open on the right: its origin, the prompt that made it, and the video that uses it

The detail panel shows the asset's Origin (yours, from a library, or generated by a specific model), the Prompt AdaL used to make it, and which Videos use it. Click Use in chat to reference the asset in your next message — for example, "use this shot as the opening".

Come back to a video later​

In the Desktop app you do not have to remember which chat made a video.

  • The Videos section in the sidebar lists your projects, newest first. Click a video to open it.
  • A video row's … menu has Edit in chat, and a reveal item that opens the project folder in Finder, Explorer, or your file manager. Edit in chat lists the chats that worked in the project's folder, newest first, each with when it last touched the project; pick one and it resumes with the project's files, so the next change stays in the same conversation. When no chat has touched the project yet, the list offers + New chat instead. The same list opens from the button in the video page's header.
  • The Video workspace button in the chat's side panel shows the projects this chat made or opened, with their assets and rendered files. A project that already sits in the chat's working folder appears there on its own.

Opening a project to look at it does not start the video tools. They load when you ask for a change.

Where the files are​

Everything lives in the project folder. Nothing is hidden in an app database, so you can copy, back up, or version-control it like any other directory.

ember-teaser/
├── project.md AdaL's plan for the project
├── assets/ every clip, image and sound the videos use
├── scenes/ animated titles and end cards
├── scripts/ small programs AdaL wrote to make assets
└── videos/
├── ember_16x9/
│ ├── ember_16x9.mp4 the current version, ready to share
│ ├── exports/ the files you exported
│ └── previews/ a small preview of each version
└── ember_9x16/
└── ember_9x16.mp4

A new project starts with assets/ only. scenes/, scripts/ and videos/ each appear when AdaL first writes a file into them, so a project you have not worked on yet shows no empty folders.

AdaL runs the programs in scripts/ itself, so you never install anything for them. A Python script runs in an environment AdaL builds on first use and shares with every project, with numpy, scipy and Pillow available; a .js or .ts script runs on the same bun that renders scenes. Any file such a script writes into assets/ shows up in the media library with the script and its arguments recorded as where it came from.

The .mp4 inside videos/<name>/ is always the current version. Files you export land next to it in exports/, which appears with your first export — see Export a file to share.

Tips​

  • Give the facts up front. Length, sizes (16:9, 9:16, 1:1), language, and the one thing the viewer should remember.
  • Bring your own material. Drop footage, screen recordings, logos, or a voice-over into the project folder and reference them in your request.
  • Change one thing at a time. One change per message means one clear version per change, which keeps the Canvas easy to read.