Repository navigation
Home
Outpace is a modern, open-source alternative to the Ace Stream engine, written from scratch in Rust. It joins public, unencrypted Ace Stream (AceStream) peer-to-peer swarms, verifies the live media, and serves it to your players over HTTP:
- as a continuous MPEG-TS stream;
- as HLS;
- through an optional Ace Stream-compatible HTTP API that existing apps and add-ons already understand.
It's a single self-contained, headless binary (or container image) for Linux, macOS, Windows and FreeBSD, with an Android app for phones and TV boxes. Performance and efficiency are core goals: Outpace aims to start quickly, play smoothly and stay light on CPU and memory, and the project treats performance regressions as bugs. It never downloads or runs the proprietary Ace Stream engine. Ace Stream is the network it supports today. Outpace is an independent project, not affiliated with or endorsed by Ace Stream.
New here? Start with the FAQ or Getting Started.
- 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.
- Casts to TVs. It can find DLNA/UPnP renderers on your network and tell one to play a live stream, with no app on the TV.
- 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, EPG or general channel catalogues. The compatibility API is a documented subset.
- Stream-name search is a separate, default-off external services adapter. It needs no operator API key and uses external HTTP services; it does not bundle a UI or catalog.
- It is not a recorder or DVR. The optional Timeshift buffer lives in memory and disappears on restart.
| If you want to... | Read |
|---|---|
| Get quick answers | FAQ |
| Play a stream in five minutes | Getting Started |
| Pick a binary, container or source build | Installation |
| Look up a setting | Configuration (by topic) · Environment Variables (A–Z) |
Use outpace play, broadcast or other commands |
Command Line |
| Point a player or app at Outpace | Playing Streams |
| Send a live stream to a smart TV or other DLNA renderer | Casting |
| 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 |
| Present the official engine's identity on the network | Engine Camouflage |
| Open your peer port through a router | NAT and Port Mapping |
| Restrict peers to an allowlist | Private Peer Mode |
| Get peers on a network that blocks peer-to-peer | Outbound Proxy |
| Run it as a service, in Docker or behind a proxy | Deployment |
| Run it on a router, NAS or Raspberry Pi | Routers and Small Devices |
| 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 |
| Run it on an Android phone, tablet or TV box | Android App |
| Run the Android app on a television | Android TV |
| See where others run Outpace, or share your setup | Success Stories |
The latest release is v1.2.1. Outpace 1.0.0 was the first stable release, and everything in this wiki applies to 1.0.0 and later unless a page names a newer version. The earlier 0.x tags were development builds and aren't supported. Optional SRT ingest still requires a feature build. The Configuration reference records which settings need a newer release; see Releases and Versions for release contents and remaining limits.
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.
The Android app has its own repository and release schedule.
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