Skip to content

The truly free, open-source, local-first, cross-platform CapCut replacement. Scriptable through a JSON-RPC API & MCP.

4.3 KB
Raw Blame

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.