Repository navigation
FrameCheck 0.1.1 — 本地视频对比与质检
Pre-releaseFrameCheck 0.1.1 is an early release of a local video comparison tool with a Chinese desktop interface and bilingual offline reports.
It compares full-resolution decoded RGB frames, presentation timing, frame counts and source-file hashes. Reports include difference timelines, selected evidence images, per-frame CSV and structured JSON. No media uploads, API keys or cloud models are required.
Fixed in this release
Fixed command-line checks failing on Windows when redirected output uses a legacy character encoding. Unicode report paths remain readable after JSON parsing. Added regression tests for CP1252 dependency checks and Chinese file paths.
Downloads
- Windows x64: download
FrameCheck-0.1.1-windows-x64.zip, extract the entire folder, and runFrameCheck.exe. - Python 3.10+: install
eleven_framecheck-0.1.1-py3-none-any.whlin a virtual environment. - Source:
framecheck-0.1.1-source.zipincludes the source, documentation, tests and demo. - Verify assets against
SHA256SUMS.txt.
FFmpeg and ffprobe must be installed separately. On Windows, use winget install --id Gyan.FFmpeg --exact, or obtain a build from the links on https://ffmpeg.org/download.html. The desktop app can also select an existing ffmpeg.exe.
Validation
29 automated tests passed on Windows. A fresh Python wheel installation and a frozen Windows executable smoke test both passed. The test media is generated from synthetic patterns. CLI/engine CI passed on Windows, Linux and macOS Intel with Python 3.10 and 3.12: https://github.com/lqeleven520-code/framecheck/actions/runs/39812322088. The follow-up commit changes only the CI runner configuration; the released application code is identical. Desktop GUI smoke testing was performed on Windows.
Scope
This release targets SDR render/export checks. It does not judge creative quality, perform semantic or audio comparison, or automatically align changed edits. Partial frame ranges are explicitly labeled; a partial pass is not a whole-video acceptance. The Windows executable is unsigned.
MIT license. Dependency notices are included; FFmpeg is not redistributed. This is a new project and no established user adoption is claimed.