Skip to content

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

4.5 KB
Raw Blame

The Concat sound library

The Library's Audio page has a Concat shelf of built-in sounds and music (#60). Nothing ships inside the app: the shelf reads a manifest from the concatapp/assets repository the first time someone asks for it (a "Load Concat sounds" button, never at startup), and each sound is downloaded the first time it is played or used, then checked against its SHA-256 and kept in the app's cache.

This page is what the asset curator produces for that to work.

Layout in concatapp/assets

audio/
  manifest.json
  whoosh-air-short.ogg
  impact-low-thud.ogg
  ...

The files sit flat in audio/. The app fetches the manifest from:

https://raw.githubusercontent.com/concatapp/assets/main/audio/manifest.json

and each sound from, in order:

  1. the release mirror: https://github.com/concatapp/assets/releases/download/audio-v1/<file>
  2. the repository itself: https://raw.githubusercontent.com/concatapp/assets/main/audio/<file>

Upload every file to the audio-v1 release as well. Then a file that moves in the repository can't break the shelf. Whichever source the bytes come from, they are checked against the manifest's sha256. The URLs are constants in src/crates/concat-host/src/models.rs: SOUNDS_MANIFEST, SOUNDS_REPO and SOUNDS_RELEASE.

Until audio/manifest.json exists (the request answers 404), the shelf says "Sound library coming soon".

manifest.json

{
  "version": 1,
  "sounds": [
    {
      "id": "whoosh-air-short",
      "name": "Air whoosh, short",
      "category": "Whoosh",
      "file": "whoosh-air-short.ogg",
      "duration": 0.84,
      "bytes": 18234,
      "license": "CC0-1.0",
      "source": "https://freesound.org/s/123456/",
      "author": "someone",
      "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
    }
  ]
}
Field Required What it is
version yes The manifest format: 1.
sounds[].id yes Stable for ever, unique, [a-z0-9-] only. Projects don't store it, but the app's cache does.
name yes What the row shows. English. Keep it short and descriptive.
category yes One of Whoosh, Impact, Riser, Ambience, Music. These five are translated in the app. Any other value shows only under "All".
file yes The file name in audio/: a plain name, no folders. .ogg (Vorbis/Opus), .mp3, .m4a, .flac or .wav.
duration yes Seconds, as a number. The row shows it before the file is downloaded.
bytes recommended The file's size. It drives the progress bar.
license yes CC0-1.0. Only CC0 is accepted. An entry with any other licence is left off the shelf.
source yes Where the file was found (Freesound, Kenney, OpenGameArt…): the page a reviewer can check the licence on.
author no Who made it, when known. CC0 owes no attribution, but it is kind to keep.
sha256 yes The SHA-256 of the file's bytes, lowercase hex, 64 characters. An entry without a valid digest is left off the shelf, and a download that doesn't match it is deleted.

Compute a digest with shasum -a 256 <file> (macOS/Linux) or Get-FileHash -Algorithm SHA256 <file> (Windows; lowercase the result).

Rules for the selection

  • CC0 only, so the sounds can be redistributed as a collection and used by anyone without owing attribution. Pixabay's and Mixkit's licences forbid passing their files on as a collection, so nothing from either.
  • Good sources: Freesound (filtered to CC0), Kenney and OpenGameArt CC0 packs.
  • Keep files small. Effects should be a few seconds long. Music beds should be compressed (Ogg Vorbis around q5, or AAC around 160 kb/s) and ideally under a few megabytes each.
  • Trim silence at the head, so a sound placed at the playhead starts there. Normalise peaks to about −1 dBFS.
  • No recognisable voices, no trademarks, nothing that imitates a known character or product sound.

How the app treats it

  • The manifest is cached at <app data>/sounds/manifest.json. Later sessions show the shelf from that cache without going online. The shelf's Refresh fetches it again.
  • A sound is cached at <app data>/sounds/<first 12 characters of sha256>-<file>. It stays there until the cache is cleared. When a manifest changes a file's bytes, the new digest gets a new file name.
  • Placing a sound copies it into the project's own audio/ folder and imports it into the bin, the same as the user's own sounds. Projects never point into the cache.