Repository navigation
Releases
VidChopper 1.2.0
VidChopper 1.2.0 is the first supported Apple Silicon macOS release and remains a cumulative Windows release.
Downloads
- Windows 10/11 x64: download
VidChopper-1.2.0-windows-x64.zip, verify its adjacent checksum, extract it, and runVidChopper.exeorVidChopperCLI.exe. - macOS 15 or newer on Apple Silicon: download
VidChopper-1.2.0-macos-arm64.dmg, verify its adjacent checksum, and dragVidChopper.appto Applications. - Standalone Mac CLI: download
VidChopper-1.2.0-macos-arm64-cli.tar.gz, verify its adjacent checksum, extract it, and runInstall CLI.commandfor a no-sudouser-local install.
FFmpeg and ffprobe remain external dependencies on both platforms and are never bundled or downloaded by VidChopper.
macOS trust model
The macOS app and CLI are ad-hoc signed. They are not Developer ID signed or notarized. A browser download may therefore be quarantined on first launch. Use the documented per-app approval flow in System Settings; do not disable Gatekeeper globally and do not remove quarantine metadata as an installation shortcut.
Highlights
- Native Apple Silicon GUI and standalone CLI packages for macOS 15 and newer.
- HEVC VideoToolbox capability detection and automatic selection on supported Apple Silicon Macs, with x264 fallback when automatic hardware probing fails.
- Native macOS settings under
~/Library/Application Support/VidChopper/, with explicit and portable overrides. - Exact-candidate checksum, signature, dependency, relocated-launch, dry-run, export, manifest, and physical-Mac gates.
- Requalified Windows 10/11 x64 GUI and CLI from the same source commit.
Linux remains source- and CI-compatible, but 1.2.0 does not publish or support an end-user Linux package. Linux packaging is planned for 1.3.0.
See the repository support matrix and macOS installation guide for the supported boundary and first-launch steps.
VidChopper 1.1.0
VidChopper 1.1.0 is the shared Unix foundation release. The Windows desktop app and command-line tool
are the only end-user binaries; the shared core, CLI, process, path, configuration, tool-discovery,
encoder, and Qt boundaries are qualified across the source/CI platforms.
Published boundary
The published Windows 10/11 x64 portable ZIP contains:
VidChopper.exeandVidChopperCLI.exe;- the Qt runtime, Microsoft Visual C++ runtime, and
yaml-cpp.dll; - the license, third-party notices, and offline CLI agent skill.
FFmpeg and ffprobe remain external dependencies and are never bundled. macOS and Linux are source/CI
evidence only in 1.1.0: no public Unix package or end-user support claim is made until 1.2.0 and 1.3.0.
Qualification evidence
The exact published candidate passed the core, slow FFmpeg, Qt, clean extracted-archive,
Unicode/spaced-path, settings-compatibility, tool-validation, encoder, manifest, and cancellation checks.
The adjacent VidChopper-1.1.0-windows-x64.zip.sha256 file is the authoritative checksum for the
published package. The source commit, hash, dependency versions, and lane outcomes are recorded in
docs/1.1.0-foundation-evidence.md.
Known limitations
- Exports remain sequential.
- macOS and Linux GUI builds are compile/launch evidence, not published support.
- FFmpeg/ffprobe installation and trust decisions remain the user's responsibility.
VidChopper 1.0.0
VidChopper 1.0.0 is the first stable release. It puts the Windows desktop app and command-line tool on one shared Qt-free probe, planning, export, progress, verification, and manifest engine.
Highlights
- Keeps the existing Qt desktop workflow while removing UI-thread waits during GPU and ffmpeg detection.
- Uses the same process, probe, planning, and export behavior in
VidChopper.exeandVidChopperCLI.exe. - Preserves JSON/YAML ChapterFiles, embedded chapters, dry-run planning, deterministic output naming, and JSON/CSV manifests.
- Bounds in-memory desktop logs and keeps curated and advanced output responsive during long exports.
- Includes the first-party VidChopper CLI agent skill and its integrity manifest for offline use.
- Verifies the portable archive on a clean Windows runner before publication.
Supported Boundary
VidChopper 1.0.0 supports Windows 10 and Windows 11 on x64. The release archive contains the GUI, CLI, Qt runtime, Microsoft Visual C++ runtime, yaml-cpp.dll, license, notices, and the offline CLI skill.
ffmpeg and ffprobe are required but intentionally not bundled. The clean release evidence uses FFmpeg 7.1.1. Install the tools separately and keep them on PATH, or configure their locations in the desktop Advanced Settings.
Known Limitations
- Exports run sequentially.
- The desktop chapter editor displays frame timestamps using the probed rate rounded to a whole-number display FPS.
- Embedded metadata import is intentionally conservative.
- The CLI normally uses overwrite mode and has no dedicated safe-overwrite flag; use dry-run output inspection and a fresh destination when files already exist.
- macOS, Linux, self-patching, and automatic update checks are not part of the 1.0.0 support promise.
Deferred Work
Manual and opt-in update checks (VID-10) and broader test-architecture expansion (VID-43) were explicitly canceled as 1.0.0 requirements. They are not hidden release gates. Broader presentation polish for vidchopper.app/docs is also post-1.0 work.
The adjacent .sha256 asset is the authoritative checksum for VidChopper-1.0.0-windows-x64.zip.
VidChopper 0.3.0-beta
VidChopper 0.3.0-beta is the first beta release and the first portable package to include the complete Qt-free command-line workflow beside the Qt desktop application.
Highlights
- Adds
VidChopperCLI.exewith direct andchopinvocation modes. - Accepts explicit JSON or YAML ChapterFiles and explicitly selected embedded chapters.
- Adds safe dry-run planning, batch resolution, deterministic output naming, and settings precedence.
- Exports clips through ffmpeg with progress summaries and JSON/CSV manifests.
- Preserves actionable probing, process, export, and manifest failures.
- Verifies a game-neutral ChapterBuilder export from the public TNS 2XKO #36 fixture.
- Adds repository-owned Quick, Full, and Release verification tiers plus clean Windows archive smoke testing.
Package
The Windows x64 ZIP contains both VidChopper.exe and VidChopperCLI.exe, the Qt runtime required by the GUI, the Microsoft Visual C++ runtime, yaml-cpp.dll, notices, and the project license.
ffmpeg and ffprobe are intentionally not bundled. Install them separately and keep them on PATH, or configure their locations in the desktop application's Advanced Settings.
This is a beta prerelease. Please report reproducible problems through the GitHub repository.
v0.2.0-alpha
VidChopper v0.2.0-alpha adds the desktop feature round (chapter-list UX, explicit INI config, logging overhaul, zoom controls) and enables GitHub Pages deployment.
v0.1.1-alpha
Alpha milestone: full C++20 modernization of the core + tooling enforcement, plus the app icon and Qt agent-skills.
Highlights
Core modernization (byte-identical, golden-test locked)
- Formatting/parsing (#7):
std::formatreplacesostringstream+setw/setfillin timecode + zero-padded indexing;std::from_charsreplaces the hand-rolledparse_unsignedloop. - FFmpeg command builder (#8):
append(cmd, {...})helper + centralizedffmpeg_arg::constexpr constants so flags can't drift on a typo; widerstd::ranges. - Settings + Qt cleanup (#10): shared concept-constrained
clamp_to_enum(dedupesclamp_enum/safe_enum_cast), table-drivenapp_settingsload/save,std::erase_if,std::ranges::sort. - const-correctness + concepts (#11):
constexpr/noexceptFrameRate, defaultedoperator<=>/operator==on value structs, concept-constrained settings loader.
Tooling (#12)
.clang-format(120-col, tuned to the codebase's hand-wrapped designated-init style) +.clang-tidy(bugprone/performance/modernize/readability/cppcoreguidelines, Qt-aware suppressions,WarningsAsErrorson core).- New CI
lintjob (pinned clang 18.1.8 + gcc-13) runningclang-format --dry-runover src+tests andclang-tidyoversrc/core. - Whole tree reformatted; CI ffmpeg install hardened with retry/backoff against transient chocolatey.org outages.
App polish
- App icon (#9): multi-resolution
.ico(16–256px) wired to the window title bar, taskbar, and the.exeresource. - Qt agent-skills (#6):
qt-cpp-review,qt-cpp-docs,qt-projectunder.devin/skills/.
No behavioral changes to the core: all 13 fast tests + the ffmpeg integration test pass; GUI builds clean on Qt 6.9.
Full changelog: v0.1.0-alpha...v0.1.1-alpha
v0.1.0-alpha
Highlights
- Adds a portable Windows release workflow that packages
VidChopper.exeplus the Qt and VC++ runtimes intoVidChopper-windows-x64.zip - Updates the README and GitHub Pages site to point users at the GitHub Releases download path
- Stops tracking the internal
tmp/andoutput/folders and ignores them going forward
Notes
- This is an alpha prerelease for Windows 10/11 x64
ffmpegandffprobeare still external dependencies and are not bundled in the release zip