Changelog / since 2.0
What changed, cut by cut.
We follow semantic versioning for the command line and a separate spec number for the sidecar. A sheet made with any 2.x release can be read by any other.
- FixedTimecode on 23.976 fps sources drifted by one frame after roughly 01:06:00 because the frame index went through a float. It is now computed from the rational frame rate end to end.
- Fixed
--strip ignored --tile and always used 320 px.
- AddedSidecar records the source colour transfer (
bt709, pq, hlg). HDR sources are tone-mapped for the sheet and the sidecar says so.
- Changed
--doctor prints the full path of the ffmpeg it found.
- ChangedShot detection rewritten. It now compares luma histograms on a 64 px proxy instead of full frames: about twice as fast on 4K, and single-frame camera flashes no longer register as two cuts.
- Added
--min-shot to merge very short shots into the previous tile.
- AddedBatch mode prints one line per file and a total, so it reads well in a render log.
- FixedMXF OP-Atom files with a separate audio essence no longer report zero duration.
- Added
--strip layout: one row, for single takes and for dropping under a paragraph.
- ChangedVertical and square sources get tiles in their own aspect ratio rather than being pillarboxed into 16:9.
- FixedWindows: paths containing non-ASCII characters were passed to ffprobe in the wrong code page.
- FixedDrop-frame timecode printed a colon instead of a semicolon on sheets, although the sidecar was correct.
- FixedHeader line overflowed on sheets narrower than 900 px; it now drops the duration first, then the interval.
- AddedJSON sidecar, spec 3: adds
rect for every tile, so a tile can be cut back out of the sheet or made clickable on a web page.
- Added
--paper for light sheets. Label plates invert automatically.
- ChangedDefault JPEG quality raised from 85 to 90. Sheets are about 15% larger and banding in skies is gone.
- Removed
--legacy-labels, deprecated since 2.1.
- AddedLinux arm64 build.
- Added
--stdin: read raw frames from a pipe, for formats ffmpeg cannot decode.
- FixedVariable-frame-rate phone footage is conformed to its average rate before sampling instead of producing duplicate tiles.
- AddedBitmap label face. Timecode and tile numbers stay legible at 256 px tiles and after a round trip through a messaging app.
- ChangedFrames are decoded exactly rather than seeking to the nearest keyframe. Slower on long-GOP, but the label now always matches the picture.
- FixedA source ending on an incomplete GOP could hang the last tile.
- ChangedRewritten as a single static binary. The Python version and its seven dependencies are retired.
- Added
--shots: one tile per detected shot.
- AddedReads start timecode from QuickTime
tmcd tracks and MXF material packages.
- RemovedPDF output. Print the JPEG; it was always the JPEG inside a PDF anyway.