Repository navigation
v1.2.0
Outpace 1.2.0
For publication status and downloads, see the
GitHub Release.
These notes accompany the reviewed release commit; source documentation can precede publication.
Outpace 1.2.0 is a minor release. It adds opt-in casting to DLNA/UPnP renderers and an opt-in
SOCKS5 outbound proxy, reports why a stream start is slow or failed, refuses VOD downloads that
would fill the disk, and paces DHT lookups by replies. Both new features are off by default. The
native start routes now return a JSON error body; their status codes are unchanged.
Features
- Casting to DLNA/UPnP renderers
(#488, closes #484). With
OUTPACE_ENABLE_CAST=1,GET /cast/targetsdiscovers media renderers on the LAN with one SSDP
search (cached for 60 s), andPOST /cast/targets/{target}/playstarts a live stream and points
the renderer at a per-cast URL that serves the shared session.stopandstatuscomplete the
API. Live streams only.OUTPACE_BINDmust be reachable from the renderer; a loopback bind
answers409 loopback_bind. A renderer that refusesvideo/mp2tis offeredvideo/mpegonce.
At most 16 renderers and 16 concurrent casts; a new cast at capacity is refused rather than
evicting one. Control routes reject cross-site browser requests. See
Casting. - Optional SOCKS5 outbound proxy
(#492, closes #486).
OUTPACE_PROXY=socks5://[user:password@]host:portwithOUTPACE_PROXY_MODE=off|on|fallback
(defaultoff). Outgoing peer connections and catalog/search requests useCONNECT; UDP
trackers useUDP ASSOCIATEor are disabled, never sent direct; DHT is off while the proxy is
active.onturns inbound serving and port mapping off (an explicit1for either is a startup
error) andoutpace broadcastrefuses to run.fallbackconnects directly and switches
engine-wide, until restart, the first time a live start finds no peers or none connects within
10 seconds. Credentials never reach logs, errors or status. Stream status reports
network_path, andGET /network-policygains aproxyobject. See
Outbound Proxy. - Stream start phase and typed failure codes
(#487,
#493, closes #483).
GET /streams/{network}/{id}/statusaddsphase(resolving,connecting,buffering,
playing,failed) anderror, and answers200for a start that is still resolving or
failed in the last 60 seconds. Codes arenot_found,no_peers,network,unresolvable,
protected,capacity,no_spaceandinternal. - VOD free-space check (#489,
closes #485). WithOUTPACE_CACHE_TYPE=disk, a VOD start that would not fit on the cache
filesystem is refused with507 Insufficient Storageand codeno_space. The new
OUTPACE_VOD_DISK_RESERVE_BYTES(default 256 MiB) sets the space to leave free. A download that
hitsENOSPCorEDQUOTmid-way stops and answers507on later range requests.
Changes
- Native start errors are JSON.
/streams/{network}/{id},.tsand.m3u8return
application/json{"error":{"code","message"}}instead of a bodiless404or a plain-text
422, as do/vod/...errors and native audio-normalization start failures. Status codes are
unchanged. The compatibility/ace/*and/server/apisurfaces are unchanged. Clients that
parsed the old plain-text body should readerror.messageinstead. - Faster DHT lookups (#490). A
DHT walk keeps up to 8 queries in flight and sends the next one as soon as a reply, a BEP-5
error or a 1.5 s slot timeout frees a slot, instead of waiting out a fixed 1.5 s round. A
four-hop offline fixture fell from 4.5 s to under a millisecond; a silent frontier keeps the
old pace. Thetimeoutsfield of the[dht] walk done:log line now counts silent queries,
not silent rounds. - A cancelled start whose provider then fails is no longer reported as
failedby the status
route (#493).
Distribution
Targets, packages, images and signer identity are unchanged from
1.0.2.
Images are published to ghcr.io/outpace-stream/outpace-engine (1.2.0, 1.2.0-minimal,
latest, minimal). The Compose file does not forward OUTPACE_ENABLE_CAST or the proxy
variables; casting from a container also needs --network host.
Upgrade and rollback
Upgrading from 1.1.0 needs no configuration change. Restart, then check /healthz and playback.
Update clients that read the plain-text body of a native start error. Keep the 1.1.0 binary or
image for rollback; 1.2.0 writes no new state to the data directory.
Validation and limits
The new features are covered by unit and HTTP tests: SSDP, device-description, SOAP and URL
parsing and the cast lifecycle; SOCKS5 negotiation, credential redaction and the fallback window;
start-phase transitions and error mapping; the free-space fit and the mid-download ENOSPC path;
and DHT slot pacing on loopback fixtures. Casting was exercised against a software renderer during
review. The DHT pacing was compared on live public channels during review (#490). No hardware TV
matrix, no proxy soak, no multi-hour playback soak and no hardware qualification was performed for
this release.
What's Changed
- docs(release): publish 1.1.0 pins by @jamezrin in #482
- Report stream start phase and typed failure codes by @jamezrin in #487
- perf(ace-swarm): pace DHT walk by responses by @jamezrin in #490
- fix(ace-engine): start-error follow-ups by @jamezrin in #493
- feat: cast live streams to DLNA/UPnP renderers by @jamezrin in #488
- feat: optional SOCKS5 proxy for peer and tracker connections by @jamezrin in #492
- chore(release): prepare 1.2.0 by @jamezrin in #495
Full Changelog: v1.1.0...v1.2.0