Repository navigation
v1.0.3
Outpace 1.0.3
For publication status and downloads, see the
GitHub Release.
These notes accompany the reviewed release commit; source documentation can precede publication.
Outpace 1.0.3 is a patch release. Live streams whose peers hold less history than the startup
buffer target now start in a few seconds instead of waiting for the 15-second startup deadline. It
changes no defaults and needs no configuration change.
Fixes
- Short live backlogs no longer wait for the startup deadline
(#474,
#475). When the peers of a live
stream held less history thanOUTPACE_PREBUFFER_MS(30 seconds by default), Outpace downloaded
all of it in about a second and then held it untilOUTPACE_PREBUFFER_TIMEOUT_MS(15 seconds)
expired. The startup buffer now releases as soon as every piece up to the live edge has arrived,
and the[prebuffer]log line reportsreason=BacklogExhausted. In a side-by-side comparison on
such a stream, the first byte arrived after about 2 seconds instead of about 16, within a second of
the original engine. The trade-off is that such a stream starts with the lead its peers hold
rather than whatever the deadline would have accumulated; the original engine behaves the same
way. Streams whose peers hold the full target still release onTargetDurationas before, and
VOD is unchanged.
Documentation
- A new Android TV page walks
through sideloading Outpace onto an Android TV box, including wireless adb pairing and checksum
tools for verifying the download
(#472). - Troubleshooting,
Configuration and
HLS Output describe the new
release reason.
Distribution
Targets, packages, images and signer identity are unchanged from
1.0.2.
Images are published to ghcr.io/outpace-stream/outpace-engine (1.0.3, 1.0.3-minimal,
latest, minimal).
Upgrade and rollback
Upgrading from 1.0.2 needs no configuration change. Restart, then check /healthz and playback.
Keep the 1.0.2 binary or image for rollback.
Validation and limits
The new release reason is covered by unit tests for an exhausted and an outstanding backlog,
position updates that arrive after the last chunk, media still readable behind an exhausted
position, sources without live position stats, and an empty buffer. Simultaneous live comparisons
against the original engine 3.2.11 were run on two short-backlog streams and one healthy stream, as
recorded in #475. No new multi-hour
soak or hardware qualification was performed for this release.
What's Changed
- docs(release): publish 1.0.2 pins by @jamezrin in #471
- docs: add an Android TV sideload use case by @jamezrin in #472
- fix(ace-engine): release startup buffer on exhausted live backlog by @jamezrin in #475
- chore(release): prepare 1.0.3 by @jamezrin in #478
Full Changelog: v1.0.2...v1.0.3