File formats and where files live

This page lists the file types Cutscript works with and the folders it writes to, so you know what to back up, move or delete.

Where Cutscript keeps things

Most of it lives in one folder, the app data folder: ~/Library/Application Support/Cutscript. Settings › About shows the exact path under App data folder, with Copy and Show in Finder buttons.

Beside those, the app data folder holds folders for your media library (media-library), generated music, sound effects and voices (audio-library), brand kits (brand-kits), saved graphics (graphics-library), the director's skills and chats (director-skills, director-threads), and the link downloader's programs (tools).

Warning: Do not edit or delete files inside the app data folder while Cutscript is open. To move your projects, use Settings › Storage, which copies them safely.

Inside a project folder

Each project is a folder with a few parts:

• project.json is the edit itself: cuts, transcript, graphics, captions and settings.
• assets holds generated audio, graphics assets and, for a recording, a recording-<id> folder with the screen video, the microphone and camera tracks and the cursor data.
• cache holds waveforms, thumbnails, posters and temporary files. These are disposable.
• checkpoints holds the restore points that AI chat messages and the director create.

Media you import stays where it is on disk. The project points to it. If you move or delete the original, the project shows a missing-file card in the preview with Locate… on it. Click it to open the Relink media dialog and choose where each file is now. Your edits stay as they are.

When you choose Move to Trash on a project in the home screen, it goes to the macOS Trash, where you can restore it.

Move a project to another Mac

Use a project package. It is one file, <Project name>.csproj, that holds the whole project.

1. Choose File › Export Project Package…. You can also click Export project package… in the Export panel, or use the project's menu on the home screen.
2. Choose what travels with it: Include all media, Include media, smaller copies or Leave media out. Two switches add Include AI chats and checkpoints and Include brand kit.
3. Click Export… and choose where to save it.

On the other Mac, choose File › Import Project Package…, double-click the file, or drop it on the home screen. It opens as a new project and changes nothing you already have. If you left the media out, use Locate… to relink it.

A .csproj file is a ZIP with a manifest, so Cutscript can tell it from a Visual Studio C# project, which shares the extension. A Visual Studio file gets "This .csproj is a Visual Studio C# project, not a Cutscript project." A package from a newer Cutscript asks you to update.

What Cutscript imports

The extension is only a claim. Cutscript still reads the file, so a .webm with no picture is treated as audio, and a file with no audio or video gets "This file has no audio or video streams."

Files you give to the AI are different. On the home screen and in the AI chat, Attach also takes pictures (png, jpg, jpeg, webp, gif), svg, tables (csv, tsv, xlsx, json) and documents (pdf, docx, txt, md). The AI reads up to eight at a time.

What Cutscript exports

Click Export in the editor's top bar. The tabs and their formats:

Exported video has no alpha channel, so transparent graphics are flattened into the picture. See Export a video.

Related

• Projects, files and relinking
• Settings
• What leaves your Mac