Home
Softono
OpenAce

OpenAce

Open source MIT Python
GitHub
14
Stars
3
Forks
0
Issues
1
Watchers
10 months
Last Commit
Media Servers Networking & Hosting

About OpenAce

OpenAce is an all-in-one Docker container that integrates the AceStream engine with a custom HTTP proxy to enable seamless content streaming for media servers like Jellyfin and Plex. It acts as an intermediary, relaying MPEG-TS streams directly or converting them into HLS format for broader player compatibility. The solution supports both standard operation and advanced setups with optional VPN integration via Gluetun, including automatic port forwarding for enhanced reliability. Key features include a unified environment combining AceStream and the proxy, smart startup scripts that detect VPN modes, and robust error handling with logging. Users can access content through two primary endpoints: a direct stream at /play/ for MPEG-TS and a converted stream at /hls/ for HLS playlists. The system is designed for easy deployment using Docker Compose, with options for simple setups or complex configurations involving WireGuard and Gluetun. It allows media servers to ingest streams via standard .m3u playlists, lever

Platforms

Web Self-hosted Docker

Languages

Python

Links

Source Code
d
Published by
diedomin
Visit View Profile

README.md

View on GitHub

OpenAce

Logo

GitHub GitHub Repo stars GitHub last commit

OpenAce is an all-in-one Docker image. The proxy acts as an intermediary between an app and the AceStream engine. The /play/<content_id> endpoint relays the MPEG-TS stream directly. It is useful for clients that support streaming, such as Jellyfin, Plex, etc. The /hls/<content_id> endpoint transforms that stream into HLS format (playlist .m3u8 and .ts segments), allowing compatibility with players and servers such as Jellyfin, Plex, etc. Both handle retries, errors, and logging for more robust content delivery.

Designed to integrate the AceStream engine with servers such as Jellyfin or Plex.

Features

  • AceStream Engine + Proxy in a single container
  • Optional VPN support (perfect with Gluetun)
  • Automatic port forwarding support with some VPN providers such as Proton VPN (not all plans)
  • Smart startup script that detects VPN mode or falls back to default settings

Getting Started

Option 1: Simple (no VPN)

docker compose -f docker-compose_simple.yaml up -d

Option 2: With VPN (Gluetun + WireGuard + Port Forwarding)

docker compose up -d

Make sure you provide the necessary Gluetun environment variables in an .env file.

For more information, please refer to Gluetun VPN.

Usage

  • AceStream is exposed internally on port 6878, but you can access the AceStream engine directly by exposing port 6878 of the container.
  • The HTTP Proxy is exposed on port 8888 (defined in docker-compose.yaml)
  • Use the proxy like this:
# For MPEG-TS streaming
http://<your-server>:8888/play/<acestream_content_id>

# For HLS streaming
http://<your-server>:8888/hls/<acestream_content_id>

You can use this with servers such as Jellyfin via the "Live TV" function, simply by providing an .m3u file with the available streams, for example like this:

#EXTM3U

#EXTINF:-1 tvg-id="" tvg-name="NAME" group-title="Group",
http://<your-server>:8888/play/yourcontentid

#EXTINF:-1 tvg-id="" tvg-name="NAME" group-title="Group",
http://<your-server>:8888/play/yoursecondcontentid

How It Works

  • On startup, start.sh checks if a Gluetun forwarded port is available.
  • If detected, AceStream is launched using that port.
  • The proxy starts with Gunicorn + Gevent to stream content via Flask.
  • If no VPN is detected, it falls back to default port 6878.

Build the image

docker build -t open-ace .

Development tips

  • You can use the image as-is.
  • Or mount your own start.sh via volume to customize the startup behavior.
  • Logs are printed via stdout and also written to log files, so docker logs -f open-ace works perfectly, as does tail -f /your-path/proxy.log or ingesting them into a log server like OpenSearch.

Contributing

Got a cool idea? Found a bug?

  1. Fork the repo
  2. Create a feature branch
  3. Open a PR — let's make streaming better together!

License

MIT — use it freely, fork it, break it, improve it.

Like this project?

Spread the word. Star the repo and share it with others!