Aceplay is Linux only . For macOS and Windows, use the official Ace Stream applications. System requirements Before installing Aceplay, ensure your system meets these requirements:
Operating system - Linux (any distribution)Video player - At least one of: mpv, vlc, or ffplayacestream-engine - Will be auto-started if not running
For building from source
Go - Version 1.22 or higher (tested with 1.24.2)make - GNU Make for build automation
Installation methods Choose the installation method that works best for your system:
AUR (Arch Linux)
Debian/Ubuntu
Fedora/RHEL
From source
Pre-compiled binaries
Install from AUR The easiest way to install on Arch Linux and derivatives is via the AUR: This installs the latest release and all dependencies automatically. Install .deb package Download the latest .deb package from the releases page and install: sudo dpkg -i aceplay_ * .deb
If you encounter dependency errors, run: Install .rpm package Download the latest .rpm package from the releases page and install: sudo rpm -i aceplay- * .rpm
On Fedora, you can also use dnf: sudo dnf install aceplay- * .rpm
Build from source Building from source gives you the latest features and allows you to customize the build:
Clone the repository
git clone https://github.com/crstian19/aceplay.git cd aceplay
Build the binary
This compiles the binary to build/aceplay with version information from git.
Install to system
This copies the binary to /usr/local/bin/aceplay. Build requirements The build process requires:
Go 1.22 or higher
make
git (for version information)
Build options # Build for current platform make build # Build for all platforms make build-all # Build with custom output directory go build -o /custom/path/aceplay ./cmd
Download pre-compiled binary Download the latest binary for your platform from the releases page .
Download the binary
Choose the appropriate binary for your system:
aceplay-linux-amd64 - For 64-bit x86 systemsaceplay-linux-arm64 - For ARM64 systems
Make it executable
chmod +x aceplay-linux-amd64
Move to PATH
sudo mv aceplay-linux-amd64 /usr/local/bin/aceplay
Verify installation After installation, verify that Aceplay is working:
You should see output similar to:
Aceplay Version: v1.0.0 Commit: abc1234 Date: 2024-03-15 Platform: linux/amd64
Install dependencies Video player Aceplay requires a video player. Install at least one of these:
mpv (recommended)
VLC
ffplay
# Debian/Ubuntu sudo apt install mpv # Fedora sudo dnf install mpv # Arch Linux sudo pacman -S mpv
acestream-engine Aceplay requires acestream-engine to function. The engine will be automatically started when needed, but you need to have it installed.
Refer to the Ace Stream documentation for installation instructions specific to your distribution.
Set up browser integration To open acestream:// links directly from your browser, register the protocol handler:
aceplay register-protocol
Or use the shorter version:
This creates a desktop entry at ~/.local/share/applications/aceplay.desktop and registers the acestream:// protocol using xdg-utils.
Browser integration requires xdg-utils to be installed on your system.
Next steps
Quick start guide Learn how to play your first stream with Aceplay