Skip to content

v1.0.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 10:08
· 154 commits to main since this release
4d95b0e

Outpace 1.0.0

For publication status and downloads, see the
GitHub Release.
These notes accompany the reviewed release commit; source documentation can precede publication.

Outpace 1.0.0 brings the features merged since 0.9.0 to release binaries and multi-architecture
images. It supports public, unencrypted live and single-file VOD playback, reciprocal seeding,
signed MPEG-TS broadcasting and the documented AceStream-compatible HTTP subset. Premium
content, accounts and a bundled player/UI remain permanent non-goals.

Features

  • In-memory live HLS timeshift (OUTPACE_HISTORY_*), with per-viewer rewind and bounded
    per-source and shared memory budgets. It is not persistent recording.
  • HLS-origin descriptors and opt-in managed relay (OUTPACE_MANAGED_HLS), including gzip
    playlists, connection reuse, X-Outpace-Upstream-Status and qualifying origin replay.
  • Shared live audio normalization (OUTPACE_LIVE_AUDIO_NORMALIZE) before TS/HLS/support
    fan-out. FFmpeg is required when enabled; it is not bundled in published images.
  • Outbound-only private peer mode, local descriptor aliases and /network-policy
    (OUTPACE_PRIVATE_PEERS, OUTPACE_PRIVATE_DESCRIPTORS).
  • Support sources kept active without viewers (OUTPACE_SUPPORT_SOURCES) and /support.
  • Optional encrypted SRT ingest in native Linux builds with --features srt and an
    encryption-enabled libsrt 1.5.7 or newer. Standard release archives and images omit SRT.
  • Separate, default-off service-backed /search (OUTPACE_COMPAT_ACESTREAM_SERVICES).
    It uses external plain-HTTP services and bounded signed-response adaptation; search data
    is not proof of a verified playback descriptor. Reverse infohash-to-content-ID lookup is
    unsupported. Client endpoint/parser integration and deployed scraper qualification are
    not established by the local adapter tests.
  • Opt-in Prometheus /metrics (OUTPACE_METRICS=1), disabled by default.

Fixes

  • Ended HLS sources close playlists with #EXT-X-ENDLIST rather than returning 503 forever.
  • Live get_media_files reports MPEG-TS MIME and a display filename.
  • The prebuffer deadline is absolute from the first media byte; source gaps cannot restart it.
  • Shutdown ends viewer responses before draining HTTP; idle cleanup remains responsive when
    another stream's cleanup is stuck.
  • CLI compatibility parsing rejects duplicate query keys and unsupported file selections;
    HTTP compatibility still accepts the Android SDK's duplicated descriptor parameters.

Distribution

  • Ten required binary targets: Linux musl x86_64, ARM64, ARMv7, ARMv6 hard-float and RISC-V 64;
    macOS Intel and Apple silicon; Windows x86_64 and ARM64; FreeBSD x86_64.
  • Debian/Ubuntu .deb and Fedora-family .rpm packages for x86_64, ARM64 and ARMv7, with a
    systemd service and configuration file. Installation does not start the service.
  • Debian-based and minimal scratch images for linux/amd64, linux/arm64 and linux/arm/v7.
    Minimal images use outpace healthcheck and have no shell, curl or package manager.
  • Signed build provenance for standard archives, packages and release images. Verify with
    gh attestation verify; use SHA256SUMS for archive/package integrity.
  • Windows service management, a macOS LaunchAgent, a FreeBSD rc.d script and an OpenWrt
    installer/procd service. Consult the wiki before installing on a router or firewall.
  • Best-effort Android ARM64 archive for Termux, uploaded separately after core publication.
    It may be absent if its build fails and uses its own .sha256, not SHA256SUMS.
  • Homebrew/Scoop definitions use the published release checksums. The active .env.example
    image pin targets 1.0.0.
  • Standard release binaries use the size-optimized dist profile; source --release and
    edge builds keep their existing profile. See the merged profile work in
    #429 for its measurements.

Upgrade and rollback

Back up the data directory (including node identity and broadcast keys), pin the release tag,
recreate the container or restart the service, then check /healthz and playback. Keep the old
binary/image and configuration for rollback. Stop active broadcasts deliberately before an
upgrade. The release preparation itself changes no listener, seeding, caching or opt-in defaults.

Timeshift, managed relay, private peers, support sources, shared normalization, external search
and metrics retain their documented opt-in settings. Private peers restrict discovery and inbound
behavior; search is rejected in that mode. Review the
wiki configuration reference
before enabling them. /healthz is liveness, not proof of media delivery.

Deferred scope

The maintainer explicitly deferred the following for 1.0.0 on 2026-11-13:

  • #79: multi-file/selected-file VOD.
    Multi-file descriptors remain rejected; verified layout/schema evidence is required before
    implementing offsets and selection. Single-file playback remains supported.
  • #269: optional broadcast discovery
    and metadata wire fields. Recovered key/accessor/conversion evidence does not prove the full
    producer-to-consumer chain, endpoint policy, persistence or advertisement semantics. No new
    metatracker/startup-node or tags/logo/description options are adopted.
  • #272: original-engine HLS transport
    origination/support parity. Native TS-to-HLS packaging and managed upstream relay are supported
    subsets, not proof of original-engine HLS peer/discovery/origination interoperability. New
    origination requires protocol evidence, URL/DNS/redirect policy, sequence/discontinuity rules,
    cancellation/cache bounds and synthetic topology tests before implementation.

#128 remains a conditional enhancement:
VOD HLS uses approximate byte-based segmentation without PCR/keyframe-aligned media-time seeking.
Schedule that work after a demonstrated player/interoperability failure. This release does not
promise a DHT keyword crawler or aggregate playlist; known-hash DHT peer discovery is supported.

Validation and limits

The #195 acceptance reconciliation
records a reviewed 7,500-second matched observation with more than 7,200 sampled active seconds
per player, plus separate recovery, integrity and resource-admission evidence. The maintainer
recorded production-replacement sign-off on 2026-11-12.
This was human acceptance, not a new passing soak of the final 1.0.0 candidate.

The historical stale-reconnect stall #246
was closed as not reproduced/inconclusive, not as causally fixed. Retain failed observations;
reopen with timestamped private diagnostics if it recurs. Reference-relative latency to live
remains unmeasured. Sampled decode progress does not prove sub-poll smoothness, identical bytes,
24/7 availability or leak-free behavior. Session admission is configurable and unlimited by
default; there is no new aggregate seed-store byte budget.

Preparation checks and final candidate CI results are recorded in
release PR #444. The
release workflow completed
successfully on 2026-11-13. All ten required archives and six packages matched SHA256SUMS,
and their attestations verified against the source tag and commit. The optional Android archive
also matched its separate checksum.

Both standard and minimal image indexes contain linux/amd64, linux/arm64 and linux/arm/v7;
latest and minimal match their respective versioned digests. Image provenance, source/version
labels, local x86_64 version output and daemon health checks passed. The downloaded Linux x86_64
binary reports outpace 1.0.0. These publication checks are not a new live comparison, multi-hour
soak or hardware qualification. They do not establish behavior on every listed operating system
or on 16 KiB-page ARM hardware. Android remains best-effort for future releases.

What's Changed

  • fix(abcompare): preserve precise observation endpoint by @jamezrin in #308
  • test(ace-swarm): verify fresh selection attempt budgets by @jamezrin in #309
  • feat(abcompare): add bounded timestamped VLC diagnostics by @jamezrin in #310
  • docs: point README roadmap at milestones by @jamezrin in #311
  • docs: add engine migration guide by @jamezrin in #312
  • feat(abcompare): add opt-in diagnostic verbosity by @jamezrin in #313
  • fix: refuse protected descriptors before playback by @jamezrin in #314
  • perf(ace-peer): avoid receive-buffer copies by @jamezrin in #315
  • perf(ace-engine): scan startup packets by slice by @jamezrin in #316
  • perf(ace-swarm): share internal serving payloads by @jamezrin in #317
  • perf(ace-swarm): borrow live chunk payloads by @jamezrin in #318
  • perf(ace-wire): remove temporary frame allocations by @jamezrin in #319
  • test(dht): qualify lookup candidates offline by @jamezrin in #320
  • test(dht): qualify cold clients and owned cancellation by @jamezrin in #321
  • test(dht): retain bounded emission accounting by @jamezrin in #322
  • test(ace-swarm): align DHT comparison deadline accounting by @jamezrin in #323
  • test(dhtcompare): witness detached descendant cleanup by @jamezrin in #324
  • refactor(dhtcompare): share the fixed lookup budget by @jamezrin in #325
  • test(ace-swarm): cover signed support-node lifecycle by @jamezrin in #326
  • feat(ace-engine): enforce outbound-only private peer policy by @jamezrin in #327
  • fix(ace-engine): own live session shutdown by @jamezrin in #328
  • feat(ace-engine): supervise declared live support sources by @jamezrin in #329
  • test(ace-engine): validate autonomous support lifecycle by @jamezrin in #330
  • test(dhtcompare): qualify beyond-budget UDP replies by @jamezrin in #331
  • test(dht): add guarded offline comparison workers by @jamezrin in #332
  • ci: unblock bounded gateway validation by @jamezrin in #333
  • refactor(audio): separate process output admission by @jamezrin in #334
  • Fix(ace-wire): split space-separated descriptor trackers (#335) by @Papela in #336
  • fix(ace-engine): reuse cached multi-chunk VOD pieces by @jamezrin in #341
  • fix(ace-engine): derive cache dir from OUTPACE_DATA_DIR by @jamezrin in #342
  • fix(ci): fall back to a non-ubuntu.com apt mirror by @jamezrin in #352
  • fix(ace-engine): apply jemalloc config on macOS by @jamezrin in #343
  • fix(ace-peer): honor directional ut_metadata ids by @jamezrin in #344
  • fix(ace-engine): canonicalize content-id hex case by @jamezrin in #346
  • fix(ace-wire): bound bencode values per parse by @jamezrin in #348
  • fix(ace-engine): publish selector output in the AAC copy path by @jamezrin in #350
  • fix(hls): keep completed media as a closed playlist at source EOF by @jamezrin in #355
  • fix(compat): live MIME and display name in get_media_files by @jamezrin in #357
  • fix(runtime): own maintenance and inbound listener tasks by @jamezrin in #359
  • fix(ace-swarm): break scheduler capacity ties by window end by @jamezrin in #361
  • fix(startup-buffer): absolute deadline, ignore empty reads by @jamezrin in #363
  • fix(compat): end pending playback on lease stop or expiry by @jamezrin in #365
  • fix(runtime): stop stream sources before graceful HTTP drain by @jamezrin in #367
  • fix(live): raise the worker request floor on cursor advance by @jamezrin in #369
  • fix(hls): compact finished segments, check the retained index by @jamezrin in #371
  • feat(audio): add optional shared live TS normalization by @jamezrin in #351
  • feat(srt): add optional encrypted broadcast ingest by @jamezrin in #376
  • test(fuzz): parser invariants and cargo-fuzz targets by @jamezrin in #375
  • fix(ace-engine): keep idle reaper sweeping past stuck cleanup by @jamezrin in #373
  • feat(ace-engine): bounded retained HLS history for timeshift by @jamezrin in #379
  • feat(ace-engine): per-viewer timeshift seek and return-to-live by @jamezrin in #380
  • docs: document retained HLS timeshift by @jamezrin in #382
  • feat: opt-in managed HLS origin relay by @jamezrin in #381
  • feat: accept bounded gzip origin playlists by @jamezrin in #386
  • feat: reuse guarded origin clients and surface upstream status by @jamezrin in #388
  • feat(ace-engine): managed origin HLS replay by @jamezrin in #390
  • test(dhtcompare): live DHT comparison through a default-deny boundary by @jamezrin in #383
  • docs: add user-facing wiki by @jamezrin in #393
  • ci: publish docs/wiki to the GitHub wiki on merge by @jamezrin in #395
  • docs: rebrand the README, add a wiki FAQ and canonical repo links by @jamezrin in #397
  • docs: add a contributing guide by @jamezrin in #405
  • chore(deps): update dependency macos to v26 by @renovate[bot] in #353
  • docs: clarify optional stream-name search scope by @jamezrin in #407
  • chore(deps): update actions/checkout action to v7 by @renovate[bot] in #158
  • fix(deps): update rust crate dirs to v7 by @renovate[bot] in #160
  • docs: recover native Ace Search protocol by @jamezrin in #409
  • ci: move runners to Ubuntu 26.04 by @jamezrin in #410
  • fix(ace-wire): upgrade rand, rsa and ed25519-dalek together by @jamezrin in #411
  • docs(agents): keep the wiki up to date by @jamezrin in #412
  • docs: make performance a core goal by @jamezrin in #413
  • feat: add native AceStream search compatibility by @jamezrin in #408
  • feat(ace-engine): opt-in Prometheus /metrics endpoint by @jamezrin in #432
  • ci: build and smoke-test every release target on PRs by @jamezrin in #428
  • feat(release): ARMv6 and RISC-V 64 musl Linux binaries by @jamezrin in #431
  • build: size-optimised dist profile for release binaries by @jamezrin in #429
  • ci(release): build provenance attestations for archives and images by @jamezrin in #430
  • feat(release): FreeBSD x86_64 binary by @jamezrin in #433
  • feat(container): minimal scratch image and outpace healthcheck by @jamezrin in #435
  • feat(packaging): deb and rpm packages with a systemd unit by @jamezrin in #436
  • feat(packaging): OpenWrt procd service and router guide by @jamezrin in #438
  • feat(packaging): Homebrew formula and Scoop manifest by @jamezrin in #439
  • feat(release): best-effort Android aarch64 binary for Termux by @jamezrin in #440
  • feat(packaging): Windows service and macOS LaunchAgent by @jamezrin in #437
  • docs: use the Outpace name consistently in docs/ by @SolMhub in #443
  • chore(release): prepare 1.0.0 by @jamezrin in #444

New Contributors

Full Changelog: v0.9.0...v1.0.0