v0.8.155

heygen-com/hyperframesv0.8.155Oct 13, 2026by github-actions[bot]

Upgrading?

AI Summary

This release fixes a black strip rendering issue on specific MP4 widths for newer FFmpeg versions and introduces configurable encoder settings (CRF, videoBitrate, frame format) for both Studio and Producer render routes.

Key Highlights

  • Fixed black strip rendering on widths like 1000, 1080, and 1112 with newer FFmpeg versions.
  • Added `crf`, `videoBitrate`, and `videoFrameFormat` parameters to Producer render endpoints.
  • Studio Server now supports `hdrMode` and validates input parameters with 400 errors.
  • Distributed renders now correctly preserve the requested CRF setting.

New Features

  • Support for configurable encoder settings (CRF, videoBitrate, videoFrameFormat) in Producer render server.
  • Support for HDR mode (`hdrMode`) in Studio Server render route.
  • Validation improvements returning 400 for invalid `videoFrameFormat` or out-of-range values.
  • Distributed renders now maintain the specified CRF quality setting.

Full Release Notes

# HyperFrames v0.8.155

Released on 2026-10-13.

MP4 renders at widths like 1000, 1080 or 1112 no longer get a black strip down the right edge on newer FFmpeg. Both the Studio render route and the producer render server now take encoder settings such as CRF, and distributed renders keep the CRF you ask for.

## Features

- **Producer:** The render server's `/render` and `/render/stream` accept `crf`, `videoBitrate` and `videoFrameFormat` ([5de2712ad5](https://github.com/heygen-com/hyperframes/commit/5de2712ad587ae3fe06e4087e30650fdbe34c909), [#5550](https://github.com/heygen-com/hyperframes/pull/5550)). A bad `videoFrameFormat` now returns a 400 instead of being ignored.
- **Studio Server:** Accept `crf`, `videoBitrate`, `videoFrameFormat` and `hdrMode` on the render route ([ab8a4da53f](https://github.com/heygen-com/hyperframes/commit/ab8a4da53f31653350632980fa63cb07e957f0f6), [#5549](https://github.com/heygen-com/hyperframes/pull/5549)). Out-of-range values return a 400, and `crf` with `videoBitrate` together is rejected.

## Fixes

- **Engine:** Keep the rightmost 8 columns of SDR MP4 at widths like 1080 ([401354cd8f](https://github.com/heygen-com/hyperframes/commit/401354cd8f685d9ec9011b41d2c4269289d29598), [#5559](https://github.com/heygen-com/hyperframes/pull/5559)). FFmpeg 7.1 and 8.0 dropped the last 8 pixel columns to black when the width was 8 more than a multiple of 16.
- **Producer:** Keep the requested CRF in the distributed constant-frame-rate re-encode ([bf4cf860fb](https://github.com/heygen-com/hyperframes/commit/bf4cf860fbd26a7d51938c5f11987c335d4e848a), [#5557](https://github.com/heygen-com/hyperframes/pull/5557)). It used to fall back to the quality preset.

## Full changelog

https://github.com/heygen-com/hyperframes/compare/v0.8.154...v0.8.155

Related Repositories