Skip to content

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

docs: drop CHANGELOG.md, and a release's notes are its commits

Jareer1d22c125a876
diff --git a/.github/release-notes.sh b/.github/release-notes.sh
index 46ca5bf4..12074bd3 100755
--- a/.github/release-notes.sh
+++ b/.github/release-notes.sh
@@ -6,13 +6,8 @@
# Writes markdown to stdout: what changed, then how to download each bundle
# and the checksum file.
#
-# What changed is the release's section of CHANGELOG.md - the lines under
-# `## <version>` (the heading may carry a date after it), up to the next
-# `## ` - written by hand when the release is cut, so the notes say what a
-# person will notice, grouped by where they will notice it, rather than
-# listing the commits. A release with no section - a nightly, or an alpha
-# cut in a hurry - gets the subjects of the commits between the two refs
-# instead, filtered as follows.
+# What changed is the subjects of the commits between the two refs,
+# filtered as follows.
#
# What a release note is for is what somebody running the app can notice, so
# three kinds of subject are dropped on the way past. Housekeeping, by its
@@ -34,67 +29,44 @@ until="$2"
version="$3"
title="Concat $version"
-here=$(cd "$(dirname "$0")" && pwd)
-changelog="$here/../CHANGELOG.md"
+# A conventional-commit type, with its optional (scope) and breaking `!`.
+type='^[a-z]+(\([^)]*\))?!?: '
-# The section for this version, with the blank lines either end trimmed.
-section=""
-if [ -f "$changelog" ]; then
- section=$(awk -v v="$version" '
- /^## / { if (found) exit; found = ($2 == v); next }
- found { lines[n++] = $0 }
- END {
- s = 0; while (s < n && lines[s] ~ /^[[:space:]]*$/) s++
- e = n; while (e > s && lines[e - 1] ~ /^[[:space:]]*$/) e--
- for (i = s; i < e; i++) print lines[i]
- }' "$changelog")
-fi
-
-# The fallback: the commits, filtered and dressed.
-changes=""
-if [ -z "$section" ]; then
- # A conventional-commit type, with its optional (scope) and breaking `!`.
- type='^[a-z]+(\([^)]*\))?!?: '
-
- # Each line opens with one mark for what it touches, from the commit's
- # scope where it has one and its type where it has not - a fix reads as a
- # fix at a glance, and the text rows stand apart from the timeline's. A
- # subject with neither carries no mark rather than a wrong one.
- marks='text=πŸ“ speech=πŸ—£οΈ enhance=πŸ—£οΈ keyframes=🎞️ effects=✨ render=✨ colour=✨ color=✨ timeline=βœ‚οΈ media=πŸ“ export=πŸ“€ settings=βš™οΈ i18n=🌍 locales=🌍 api=πŸ€– server=πŸ€– android=πŸ“± ios=πŸ“± models=πŸ“¦ inspector=πŸ–₯️ window=πŸ–₯️ workspace=πŸ–₯️ ui=πŸ–₯️ start=πŸ–₯️ feat=✨ fix=πŸ› perf=⚑'
- changes=$(git log "$since..$until" --no-merges --format='%s' 2>/dev/null \
- | grep -Ev '^(Update [^ ]+\.[a-z]+|Version [0-9]|Lock the flake|Format the workspace|Changelog for|Merge )' \
- | grep -Ev 'in the (export|pool) tests$' \
- | grep -Eiv '^(test|chore|ci|build|refactor|style|docs)(\([^)]*\))?!?: ' \
- | grep -Eiv "${type}.*(clippy|lint|rustfmt|(unused|duplicate|missing) [A-Za-z]* ?import|non-existent|does not compile|before test module|green again)" \
- | grep -Eiv '^(updates?|wip|fixes?|cleanup)\.?$' \
- | awk -v marks="$marks" '
- BEGIN {
- n = split(marks, pairs, " ")
- for (i = 1; i <= n; i++) { split(pairs[i], kv, "="); mark[kv[1]] = kv[2] }
+# Each line opens with one mark for what it touches, from the commit's
+# scope where it has one and its type where it has not - a fix reads as a
+# fix at a glance, and the text rows stand apart from the timeline's. A
+# subject with neither carries no mark rather than a wrong one.
+marks='text=πŸ“ speech=πŸ—£οΈ enhance=πŸ—£οΈ keyframes=🎞️ effects=✨ render=✨ colour=✨ color=✨ timeline=βœ‚οΈ media=πŸ“ export=πŸ“€ settings=βš™οΈ i18n=🌍 locales=🌍 api=πŸ€– server=πŸ€– android=πŸ“± ios=πŸ“± models=πŸ“¦ inspector=πŸ–₯️ window=πŸ–₯️ workspace=πŸ–₯️ ui=πŸ–₯️ start=πŸ–₯️ feat=✨ fix=πŸ› perf=⚑'
+changes=$(git log "$since..$until" --no-merges --format='%s' 2>/dev/null \
+ | grep -Ev '^((Create|Update) [^ ]+\.[a-z]+|Version [0-9]|Lock the flake|Format the workspace|Changelog for|Merge )' \
+ | grep -Ev 'in the (export|pool) tests$' \
+ | grep -Eiv '^(test|chore|ci|build|refactor|style|docs)(\([^)]*\))?!?: ' \
+ | grep -Eiv "${type}.*(clippy|lint|rustfmt|(unused|duplicate|missing) [A-Za-z]* ?import|non-existent|does not compile|before test module|green again)" \
+ | grep -Eiv '^(updates?|wip|fixes?|cleanup)\.?$' \
+ | awk -v marks="$marks" '
+ BEGIN {
+ n = split(marks, pairs, " ")
+ for (i = 1; i <= n; i++) { split(pairs[i], kv, "="); mark[kv[1]] = kv[2] }
+ }
+ {
+ prefix = ""
+ if (match($0, /^[a-z]+(\([^)]*\))?!?: /)) {
+ head = substr($0, 1, RLENGTH)
+ $0 = substr($0, RLENGTH + 1)
+ kind = head; sub(/[(!:].*/, "", kind)
+ scope = ""
+ if (match(head, /\([^)]*\)/)) scope = substr(head, RSTART + 1, RLENGTH - 2)
+ if (scope in mark) prefix = mark[scope] " "
+ else if (kind in mark) prefix = mark[kind] " "
}
- {
- prefix = ""
- if (match($0, /^[a-z]+(\([^)]*\))?!?: /)) {
- head = substr($0, 1, RLENGTH)
- $0 = substr($0, RLENGTH + 1)
- kind = head; sub(/[(!:].*/, "", kind)
- scope = ""
- if (match(head, /\([^)]*\)/)) scope = substr(head, RSTART + 1, RLENGTH - 2)
- if (scope in mark) prefix = mark[scope] " "
- else if (kind in mark) prefix = mark[kind] " "
- }
- print prefix toupper(substr($0, 1, 1)) substr($0, 2)
- }' \
- | awk '!seen[$0]++' \
- | sed 's/^/- /')
-fi
+ print prefix toupper(substr($0, 1, 1)) substr($0, 2)
+ }' \
+ | awk '!seen[$0]++' \
+ | sed 's/^/- /')
echo "## $title"
echo
-if [ -n "$section" ]; then
- echo "$section"
- echo
-elif [ -n "$changes" ]; then
+if [ -n "$changes" ]; then
echo "### What changed"
echo
echo "$changes"
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index e38f5d4d..91655b27 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -553,7 +553,7 @@ flowchart LR
gate["ci.yml on the tag"]
build["build-app.yml ref: tag<br/>mac arm + x64 (dmg, notarised), linux x64 + arm<br/>(deb, rpm, AppImage, Arch), win x64 + arm (msi, msix, zip)"]
phones["mobile.yml ref: tag, sign: true<br/>APK signed in its own step; iOS ipa ad-hoc"]
- publish["GitHub release: assets, checksums,<br/>manifest.json for self-update,<br/>notes from CHANGELOG's section"]
+ publish["GitHub release: assets, checksums,<br/>manifest.json for self-update,<br/>notes from the commits"]
store["MS Store, when not a pre-release"]
check --> gate --> build --> publish --> store
gate --> phones --> publish
@@ -679,8 +679,7 @@ with a test that fails without it.
ducking, beat detection, a crop tool with free aspect, a command
palette, a Shortcuts tab (PR #300), an activity panel for long jobs,
Flatpak, and the Chatterbox DirectML failure (#291).
-- *Docs.* `CHANGELOG.md` has no section for the 71 commits since 0.2.6.
- `src/README.md`'s crate table omits concat-text, concat-vision and
+- *Docs.* `src/README.md`'s crate table omits concat-text, concat-vision and
concat-perf. A few comments still describe the CPU compositor fallback
that no longer exists (`concat-export/src/lib.rs`, `concat-host/
Cargo.toml`, two sites in `gpu.rs`), and `src/Cargo.toml` says wgpu is
diff --git a/CHANGELOG.md b/CHANGELOG.md
deleted file mode 100644
index af015453..00000000
--- a/CHANGELOG.md
+++ /dev/null
@@ -1,307 +0,0 @@
-# Changelog
-
-What changed in each release, written for the person using the app and
-grouped by where they will notice it. A release's notes on GitHub are its
-section here: `.github/release-notes.sh` takes the `## <version>` section
-for the tag being released, and falls back to the commit subjects for a
-release that has none. Releases before 0.2.5 have their notes on the
-releases page only: https://github.com/jub0t/Concat/releases
-
-## 0.2.6 β€” 2026-10-04
-
-A release for the hands. The timeline gains a razor, a scrollbar and a
-volume line you can drag; titles can be styled many at a time; the
-library has a Stickers page of shapes; the export sheet shows the picture
-and follows the timeline's own size and rate. Windows and Linux get
-menus that work from the keyboard, shortcuts labelled for their own keys,
-hardware encoders, and on Windows a GPU for Chatterbox. An export now
-survives its GPU device dying under it.
-
-### Editing
-
-- B turns on the razor: a click on a clip cuts it on the frame under the
- pointer, and a hairline shows where. Ctrl+B (⌘B on a Mac) still splits
- every clip under the playhead (#241).
-- Every sound on the lanes wears a volume line at the clip's level. Drag
- it to set the volume; it snaps at 100%, and a drag is one undo step.
-- A scrollbar under the lanes shows which part of the cut is in view and
- drags the view along it (#237).
-- Select two clips that meet and click a transition to put it on the cut
- between them, in either order.
-- A Stickers page in the library, with a Shapes shelf: square, circle,
- triangle, parallelogram, trapezoid, line and arrow, placed with a click
- or dragged onto a lane.
-- Deleting a track asks first, whether it holds clips or not, and says how
- many go with it.
-- One Delete in the menus. Whether it closes the gap is the tray's
- magnetic switch; Shift+Delete still ripples once.
-- Dragging a keyed position or scale on the monitor keeps the key instead
- of springing back on release (#228).
-- Ctrl-click adds to the selection on the monitor, as on the lanes; Alt
- drag pans it.
-
-### Text
-
-- Select several titles and the Text tab styles them all at once: font,
- size, colours, stroke, shadow, background, box and alignment, one undo
- step. Position, turn and scale move them together and keep their
- spacing (#224).
-- "Use for new titles" keeps a title's look for every new title and every
- generated caption, so a CJK face set once is used from then on.
-- A title with no box wraps at the frame's edge instead of running off it.
-- A title's plate has round ends when it is pill-shaped.
-
-### Monitor and playback
-
-- Save Video Frame As, from a right-click on the picture: the frame at
- the playhead at full output size, as a PNG, placed in the bin (#238).
-- Full quality plays the files themselves; Half and Quarter play the
- proxies.
-- On MPEG-TS and the MTS files cameras write, the preview's sound no
- longer runs up to 1.4 s ahead of the picture, and captions land where
- the words are. Exports were already right.
-
-### Transitions and effects
-
-- A dissolve into a clip with nothing before its in-point holds the
- clip's first frame over the cut instead of starting the clip early and
- running off its end into black (#236).
-- Spins, Swirl, Iris and the shape and clock wipes keep their shapes on a
- wide frame. RGB Split and Glitch keep a title's transparency. Glows and
- halation light past white. A hue turn of nothing changes nothing, so
- Clean, Fair and Peach read truer.
-- A package of your own can no longer claim to replace a built-in that is
- still installed; one that tries is refused at load with the reason. A
- retired effect that opens as its stand-in keeps its keyframes, and the
- project says which effects were replaced.
-- A package whose shader hangs at install no longer takes the monitor's
- picture with it, and the install trial now runs every knob at its least
- and its most as well as at its default.
-
-### Export
-
-- The resolution is the timeline's own, and the other sizes on the ladder
- read as this project would come out at each: 1080 Γ— 1920 on a 9:16 edit
- (#109).
-- The frame rate starts at the timeline's own. A 25 fps or 23.976 cut
- used to export at 30 unless you changed it.
-- The sheet shows the picture with a strip that scrubs the playhead, and
- its bitrate and colour groups open outright on a wide window.
-- An export whose GPU device dies goes on, on a fresh device or then the
- software adapter, and the frame that came back black is drawn again
- (#223).
-- NVENC, Quick Sync and AMF encode HEVC and AV1 on Windows and Linux,
- ahead of the software encoders, when the machine has the chip.
-
-### Windows and Linux
-
-- F10, Alt+F, Alt+E and Alt+V open the menus, and the arrows, Return and
- Escape work in them.
-- Shortcut labels name each platform's keys: Ctrl+Shift+Z, not β‡§βŒ˜Z.
- Shortcuts no longer stop working with Caps Lock on. Ctrl+Y redoes, and
- Ctrl+O and Ctrl+W open and close a project.
-- File ends in Exit (Alt+F4) on Windows and Quit (Ctrl+Q) on Linux.
-- Chatterbox runs on the GPU on Windows through DirectML, falling back to
- the CPU.
-- On Windows: the window and the .exe carry Concat's icon, Settings β€Ί
- About no longer flashes a console, the setup speaks eight more
- languages, an .msi install updates from the .msi, and releases also go
- to the Microsoft Store.
-- On Linux: files dropped on the window import on native Wayland
- (#158, #196); the frameless window resizes from its edges; the running
- window belongs to its desktop entry in docks; the AppImage is named
- Concat-<version>-<arch>.AppImage.
-- New projects default to the desktop the system names, including one
- OneDrive has moved or one named in the session's language.
-- The x86_64 builds launch on CPUs without AVX2, such as Ivy Bridge
- (#193).
-
-### Phone
-
-- A sheet closes on a swipe down (#221).
-- The Android app stays upright, and its launch screen drops Open project
- and Choose location, which could not work there (#222).
-
-### Settings and logs
-
-- A Log level row on Settings' first page, from errors only to everything.
- It applies to Concat's own lines; the libraries underneath stay at
- warnings.
-- The log is a trail of what you did - sheets opened, edits by kind,
- imports, exports and their results - without quoting anything typed.
- A burst of zooms or keystrokes is one line and a count.
-- When a GPU device dies, the log says why, on which frame, and what the
- export went on with.
-- Lime is the default accent; the blue is off the list. A colour already
- picked is kept.
-- Settings has one door, the gear on the title strip (#206).
-
-### Changes to note
-
-- On Windows, models, caches and logs move from %APPDATA% to
- %LOCALAPPDATA% on first launch, so a roaming profile no longer carries
- gigabytes of models. Settings, recents, templates and looks stay where
- they were.
-- Projects with shapes do not open correctly in 0.2.5 or earlier.
-- A project naming a retired effect that a newer one stands in for says
- so as it opens; saving keeps the change.
-- The playback sound cache is rebuilt once, as projects are opened.
-- The README is in twenty more languages (#38).
-
-## 0.2.5 β€” 2026-09-28
-
-The release where the picture pipeline moves onto the GPU end to end.
-Every picture effect, transition and colour tool is now a shader drawn in
-linear light; HDR footage keeps its light from the file through to an HDR
-export; a Scopes pane reads the picture; and a phone gets an editor of its
-own instead of a shrunken desktop. It is also the first release the app can
-update itself from: Settings β€Ί Version lists every release from this one
-on and installs the one you pick.
-
-### Colour and HDR
-
-- A timeline has a colour: SDR (Rec. 709), HDR (HLG) or HDR (PQ), set in
- the Modify sheet. The first HDR clip dropped on an SDR timeline turns it
- HLG in the same undo step, and a notice says where to set it back.
-- HDR clips - an iPhone's HLG, HDR10's PQ - are decoded at ten bits and
- converted on the GPU. 4K iPhone HLG previews about five times faster
- than in 0.2.4, where the CPU tone-mapped every frame.
-- On an HDR timeline the clips keep their light above white. The monitor
- shows it tone-mapped for now; a true HDR preview is next.
-- An HDR timeline exports as HDR - HEVC or AV1, ten bits, BT.2020 with HLG
- or PQ, a PQ file carrying its mastering-display, MaxCLL and MaxFALL
- metadata - or as tone-mapped SDR, chosen on a Colour row of the export
- sheet. The API takes `hdr` too.
-- A proxy of an HDR file stays HDR (HEVC, ten bits), so a paused HDR
- timeline matches the original. The tone-mapped proxies earlier builds
- wrote of HDR files are made again.
-- A Scopes pane: waveform, RGB parade, vectorscope and histogram, counted
- on the GPU from the picture before anything is clipped. It is in the
- pane switcher and docks like the others, scaled in percent on an SDR
- timeline and in nits on an HDR one.
-- Adjust works in light. Exposure is in true stops, contrast is in stops
- about middle grey, white balance is a proper chromatic adaptation, and a
- highlight past white is carried on rather than clipped.
-- Colour wheels (lift, gamma, gain) and RGB and luma curves, as sections
- of the Adjust tab and as Color Wheels and Curves effects for an
- adjustment layer. A wheel can be keyframed.
-- Contrast, Saturation and White Balance as effects of their own.
-- Import LUT reads a .cube saved with a byte-order mark and DaVinci
- Resolve's `LUT_3D_INPUT_RANGE` (#208, by theworker02). Tables are kept
- in float, and one named for ACEScct is read in log, so a graded sky does
- not band.
-
-### Effects
-
-- Every picture effect and transition is drawn by its own shader on the
- GPU, in linear light. The FFmpeg chains for pictures are gone, and so is
- the CPU compositor: a machine without a GPU draws the same picture on a
- software adapter. Sound effects keep their FFmpeg chains.
-- New: Chroma Key with spill suppression, Luma Key, Zoom Blur, Motion Blur
- with an angle, Color Wheels, Curves, Contrast, Saturation, White Balance
- and Exposure.
-- Gaussian Blur is two to four times faster and no longer bleeds colour out
- of transparent pixels; glows and blooms draw at a quarter of the layer;
- Fisheye no longer leaves black holes at the edges.
-- The effect cards in the library are drawn by each effect's own shader,
- so a card shows what the effect does. Before, nine effects had no
- preview and sixteen showed another effect's.
-- Grain and glitch effects are the same on every GPU and in an export.
-- Green Screen and Blue Screen open as Chroma Key keyed to that colour,
- and Box Blur as a Gaussian Blur of the same spread. The other old-format
- effects are retired; see Changes to note.
-
-### Compositing and playback
-
-- The compositor blends in linear light at half-float precision: opacity,
- dissolves, fades, Screen and Add behave as light does, as in Resolve and
- Final Cut. A picture with nothing on it comes out exactly as it went in.
-- Fades to black or white and wipes are drawn in the monitor as the export
- draws them. Before, the monitor showed a dissolve for a wipe and nothing
- for a fade.
-- A packaged transition is drawn whole on the GPU, with no round trip
- through memory, and the GPU keeps the frames it uploaded, so a scrub
- back finds them there.
-- Each stream is decoded by whichever of the CPU and the chip is faster
- for it: 8-bit H.264 on the CPU, everything else on the device. Hardware
- decode is on by default on Windows and Android now.
-
-### Phone
-
-- Android and iOS get an editor shell of their own: the monitor over lanes
- that slide under a centred playhead, Play under the thumb, and a bar of
- tools that opens the inspector and the library as sheets over the lanes.
-- The start screen keeps its heading clear of the top edge, and New
- project is a row in the accent colour.
-- The Settings page column starts narrow on a phone, scrolls under a
- finger and drops the Remote page; on a desk it can be dragged to size.
-- A ProMotion iPhone animates at 120 Hz.
-
-### Editing
-
-- The playhead can follow a trimmed edge, so the monitor shows the frame
- the cut lands on: a toggle on the tray beside the hand tool, off by
- default (#194, by Raphael Bernardo).
-- Reverse writes the clip's span backwards into the project's cache, sound
- included, so a reversed clip plays like any other. Freeze, Reverse,
- Mirror and a new Rotate - a quarter turn clockwise, keyable - sit behind
- one mark on the tray.
-- A title can be set in any font on the machine, or in one of your own,
- imported from the Text inspector and kept for every project.
-- Eleven frame rates to pick from on the launch sheet and the project
- sheet alike, 10 to 60 with the NTSC rates as exact fractions, plus a
- typed rate and a typed frame size up to 8192 (#199). A 23.976 project
- no longer opens the project sheet on 30 fps.
-- "Render the sound as a file" is Export Audio: a save dialog asks where
- the file goes, and it comes into Media, selected.
-
-### Export
-
-- A constant-bitrate export gets its bitrate: H.264 holds it, and a CBR
- HEVC export through libx265 no longer fails to open (#104).
-- The export draws on the window's GPU device. On Windows laptops with
- NVIDIA chips, pressing Export could take the app down at the first frame
- (#202). The log names the adapter and API an export drew on.
-
-### Settings and updates
-
-- Settings β€Ί Version says which release this is, checks GitHub for a newer
- one, and lists every stable release from 0.2.5 on. Install downloads the
- package for this machine, checks its SHA-256 and puts it in place: the
- installer runs on Windows, the app bundle is replaced on macOS, an
- AppImage is written over itself, and a .deb, .rpm or pacman package
- opens in the desktop's installer. Flatpaks and phones are told why the
- button is off.
-- Speech voices run on CoreML on every Mac and fall back to the CPU on
- their own; the Engine switch is gone. Chatterbox's first load takes
- about eleven seconds longer per run while CoreML compiles it.
-- The Timeline shortcuts section is gone: J no longer flips a clip.
- Flipping is on the inspector and the clip menu's Mirror.
-
-### Fixes
-
-- Delete on a right-click menu over several selected clips left an empty
- menu standing (#160).
-- The Captions and Speech sheets lose the stray note in their header's
- corner (#152).
-- On Windows the launch sheet's Location came up empty, and a folder
- chosen with Choose... did not show (#203).
-- The Traditional Chinese locale is revised (by Peter Dave Hello).
-
-### Changes to note
-
-- Old-format effects are retired. Fifty-six built-in picture effects with
- no GPU twin are gone; a project that used one opens with a notice naming
- them and keeps the link, marked not installed. A picture effect package
- of your own written for format 1, or as an FFmpeg chain, is refused at
- load with a message saying why. Sound packages are unaffected.
-- Exposure is in true stops. A project that pushed Exposure in an earlier
- release looks less pushed in this one.
-- Dissolves, and the mixes inside spins, zooms and glitches, are brighter
- at the middle, as light is.
-- Hardware decode is on by default on Windows and Android, and the
- Decoding switch is gone from Settings.
-- The new Concat mark replaces the cat in every icon.
-- Under the hood: Slint 1.18, wgpu 30, and locales keyed by ids rather
- than by the English (see TRANSLATING.md). The developer docs and the
- roadmap now live at https://concatenate.pages.dev.