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.
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:
| Mark | Where | Meaning |
|---|---|---|
| Pink AdaL video tag | The project folder | This folder is an AdaL video project |
| ▦ 8 | The assets/ folder | 8 files in the project's media library |
| Pink dot | A .mp4 file | A 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:

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.

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:

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:
| Choice | Options | Default |
|---|---|---|
| Quality | Standard, High | Standard |
| Size | 1080p, 4K | the cut's own size |
| Format | MP4, WebM, MOV | MP4 |
| Frame rate | 24, 30, 60 | the 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:

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

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.