The truly free, open-source, local-first, cross-platform CapCut replacement. Scriptable through a JSON-RPC API & MCP.
Contributing to Concat
Thanks for being here. Concat is a video editor that runs entirely on the user's machine, and it gets better mostly through people using it hard and reporting what broke.
The most valuable thing you can do
Grab a build from the Releases page and edit a real video with it. Real footage finds what no reading of the source does. A good bug report (what you did, what happened, your OS, the media you used) is worth more than most patches.
Longer-form discussion lives in the contribution discussion and on Discord.
Before you write code
Open an issue or drop into Discord first for anything beyond a small fix. Large areas are already in progress or intentionally deferred, and it is no fun to review a big PR that has to be turned down for reasons that were invisible from outside.
Setting up
You will need Rust (see rust-version in src/Cargo.toml), the FFmpeg
7+ development libraries (brew install ffmpeg; see src/README.md for
Windows and Linux), cmake and a C++ compiler. Then:
cd src && cargo run -p concat
That is the editor window. Everything - the engine, the host layer and the
Slint UI - is one Cargo workspace under src/.
Layout
| Path | What lives there |
|---|---|
src/crates/ |
The engine (core, media, render, effects, export, project), the host layer (concat-host, concat-speech), the API (concat-api, concat-server), the CLI, and concat, the Slint editor window |
src/README.md explains how the crates fit together and
where the sharp edges are. Read it before touching the engine.
Checks
Run these before opening a PR:
cd src && cargo fmt --check && cargo clippy --all-targets -- -D warnings && cargo test
If you added or changed text the interface shows, also run
python3 scripts/locales.py so the string inventory follows; CI checks it.
Translations live in one JSON file per language; see
TRANSLATING.md.
If you added or changed a downloadable model, put it in
models/manifest.toml as well as the engine table it
belongs to, and run python3 scripts/models.py --check; CI checks that too.
A maintainer then runs the Mirror models workflow, which fetches the model,
records its digest in both places and publishes it to the mirror the app
downloads from.
Write what happens through the log facade (log::info!, log::warn!,
log::error!) rather than to standard output or standard error. Every run
writes <app data>/logs/concat-<when>.log, and a packaged build has no
terminal for anything that goes anywhere else; CONCAT_LOG=debug turns the
level up. See src/crates/concat-host/src/logs.rs.
New source files need a licence header (see below). Match the style of the code around you; the engine avoids cleverness on purpose.
Licensing your contribution
Concat is AGPL-3.0-or-later (LICENSE).
Contributions are accepted under the agreement in CLA.md. You
assign the copyright in your contribution to Concat's owner, and get a
licence back to use your own work for anything, plus a promise that it always
stays open source. Copyright in one place is what makes the AGPL enforceable
against companies that take the code without honouring it.
Sign off your commits to indicate agreement:
git commit -s -m "your message"
Typo and documentation fixes do not need a sign-off.
File headers
Every source file starts with:
// SPDX-License-Identifier: AGPL-3.0-or-later
// SPDX-FileCopyrightText: 2026 Jareer Abdullah and Concat contributors
Use this header as it is, and don't add a copyright line of your own.
Third-party code
If your patch brings in code you did not write, say so in the PR: what it is, where it came from, and its licence. Anything incompatible with AGPL-3.0-or-later cannot be merged, and licence problems are much cheaper to catch before a merge than after a release.
Trademarks
The code is free to fork. The Concat name and logo are not covered by the AGPL
grant; see TRADEMARK.md. Forks are welcome; please ship them
under your own name.
Conduct
CODE_OF_CONDUCT.md applies to the repo, the Discussions
and Discord.