Repository navigation
Home
outpace is an open-source, AceStream-compatible streaming engine. It joins public, unencrypted AceStream peer-to-peer swarms, downloads the live MPEG-TS media, verifies it, and serves it to your players over HTTP: as a continuous MPEG-TS stream, as HLS, or through an optional AceStream-style HTTP API that existing apps and add-ons already understand.
It is a single self-contained binary (or container image). It does not download or run the closed-source AceStream engine.
- Plays public AceStream content. Give it a content id, a transport-file URL, an infohash or a magnet link and it streams the result to VLC, mpv, ffmpeg, Jellyfin, Dispatcharr and similar tools.
- Serves HLS. It packages live streams into HLS itself, with optional audio normalisation for players that only handle AAC.
- Takes part in the swarm. By default it uploads to other peers and accepts inbound peer connections, as the original engine does. You can turn this off for a download-only node.
- Broadcasts. You can publish your own MPEG-TS feed into a new signed swarm over HTTP, RTMP, an HTTP pull source or (in builds that include it) encrypted SRT.
-
Replaces the engine for most clients. An optional compatibility layer serves the common
/ace/getstream,/ace/manifest.m3u8and/server/apiroutes.
- It does not play premium, encrypted or protected content. That is a permanent non-goal.
- It is not a full clone of the closed engine. There are no accounts, subscriptions, web UI, search, EPG or channel catalogues. The compatibility API is a documented subset.
- It is not a recorder or DVR. The optional Timeshift buffer lives in memory and disappears on restart.
| If you want to... | Read |
|---|---|
| Play a stream in five minutes | Getting Started |
| Pick a binary, container or source build | Installation |
| Look up a setting | Configuration |
| Point a player or app at outpace | Playing Streams |
| Tune HLS or fix audio for a player | HLS Output |
| Rewind a live stream | Timeshift |
| Play descriptors that point at an HLS origin | Managed HLS Origins |
| Publish your own stream | Broadcasting |
| Understand upload and inbound peers | Seeding and Peers |
| Open your peer port through a router | NAT and Port Mapping |
| Restrict peers to an allowlist | Private Peer Mode |
| Run it as a service, in Docker or behind a proxy | Deployment |
| Replace an existing AceStream engine | Migrating from AceStream Engine |
| Keep sources warm and monitor the daemon | Support Sources and Operations |
| Fix a problem or read the logs | Troubleshooting |
| Check what version has which feature | Releases and Versions |
The latest tagged release is v0.9.0. Several features described in this wiki were merged
after it and are only available in the edge container image and in builds from main. Pages
mark them with an Unreleased note, and the Configuration reference has an
availability column. See Releases and Versions for the full list.
Examples in this wiki use the obviously fake content id
0123456789abcdef0123456789abcdef01234567. It does not play anything. Replace it with the id of
a current public stream you are allowed to watch. When you report a problem, please don't paste
real content ids, infohashes or stream names; see
Troubleshooting.
outpace is licensed under AGPL-3.0-or-later.
This wiki is generated from docs/wiki/ in the main repository. To fix or improve a page, open a pull request there; the wiki is republished automatically when it merges, and edits made in the wiki web UI are overwritten.
Start
Watching
Publishing and peers
- Broadcasting
- Seeding and Peers
- Engine Camouflage
- NAT and Port Mapping
- Private Peer Mode
- Outbound Proxy
Running it
- Deployment
- Routers and Small Devices
- Migrating from AceStream Engine
- Support Sources and Operations
- Troubleshooting
- Releases and Versions
Success stories