Installation

Download Binary from GitHub

you can donwload binary from here

./live777

Diagnostics bundle

Diagnostics bundle support starts with v0.11.0; earlier releases do not include these assets. Always check the selected published release's asset list, since availability can differ by release and target. Supported releases publish live777-diagnostics-<version>-<target> archives with whipsynth, whepprobe and livewrk, all built with rsmpeg. On GNU/Linux, macOS and Windows, the bundle includes the dynamic FFmpeg runtime and its codec dependencies; a separate FFmpeg installation is not required. The licenses/ directory contains the third-party license texts and dependency notices.

The dynamically linked GNU/Linux packages remain available. Releases whose asset lists include musl packages additionally provide fully static Linux musl variants for Alpine and other musl-based systems. These binaries have no dynamic FFmpeg or codec dependencies. Diagnostics support in a release does not imply that its musl assets are present, so check for the musl target explicitly.

Each diagnostics binary archive has a matching source archive in the same release: live777-diagnostics-sources-<version>-<target>.tar.gz on Linux/macOS or .zip on Windows. It contains the Live777 source snapshot, exact FFmpeg source, dependency source downloads and build recipes. Its MANIFEST.tsv records the binary archive name, SHA-256, target and version; REBUILD.md explains how to use the sources. Release packaging fails if the required sources are missing.

Set TAG ($env:TAG in PowerShell) to a published release whose diagnostics assets you have verified. The examples require this variable rather than falling back to an older release without the assets.

To download and inspect the corresponding sources on Linux or macOS:

: "${TAG:?Set TAG to a published release with diagnostics assets}"
TARGET=x86_64-unknown-linux-gnu
curl -LO "https://github.com/binbat/live777/releases/download/${TAG}/live777-diagnostics-sources-${TAG}-${TARGET}.tar.gz"
tar xzf "live777-diagnostics-sources-${TAG}-${TARGET}.tar.gz"
cat "live777-diagnostics-sources-${TAG}-${TARGET}/MANIFEST.tsv"
cat "live777-diagnostics-sources-${TAG}-${TARGET}/REBUILD.md"

Platform	Target
Linux x86_64 (GNU, dynamic)	x86_64-unknown-linux-gnu
Linux ARM64 (GNU, dynamic)	aarch64-unknown-linux-gnu
Linux x86_64 (musl, static)	x86_64-unknown-linux-musl
Linux ARM64 (musl, static)	aarch64-unknown-linux-musl
macOS Intel	x86_64-apple-darwin
macOS Apple silicon	aarch64-apple-darwin
Windows x86_64	x86_64-pc-windows-msvc

For dynamically linked GNU/Linux and macOS packages, extract the .tar.gz and run the launchers in bin/. They locate the bundled lib/ relative to the extracted directory, so the whole directory can be moved. Do not invoke the .real binaries directly.

: "${TAG:?Set TAG to a published release with diagnostics assets}"
TARGET=x86_64-unknown-linux-gnu
curl -LO "https://github.com/binbat/live777/releases/download/${TAG}/live777-diagnostics-${TAG}-${TARGET}.tar.gz"
tar xzf "live777-diagnostics-${TAG}-${TARGET}.tar.gz"
cd "live777-diagnostics-${TAG}-${TARGET}"
./bin/whipsynth --version
./bin/whepprobe --version
./bin/livewrk --version

For a static musl package, run the binaries in bin/ directly; no dynamic launcher or .real binary is involved. The extracted directory can be moved, but keep livewrk and whepprobe together for decode verification.

: "${TAG:?Set TAG to a published release with the selected musl diagnostics asset}"
TARGET=x86_64-unknown-linux-musl
curl -LO "https://github.com/binbat/live777/releases/download/${TAG}/live777-diagnostics-${TAG}-${TARGET}.tar.gz"
tar xzf "live777-diagnostics-${TAG}-${TARGET}.tar.gz"
cd "live777-diagnostics-${TAG}-${TARGET}"
./bin/whipsynth --version
./bin/whepprobe --version
./bin/livewrk --version

On Windows, extract the .zip; the tools, FFmpeg/codec DLLs and x64 MSVC runtime DLLs (vcruntime140*, msvcp140*, concrt140* and, when present, vccorlib140*) are together in bin/. No separate Visual C++ Redistributable installation is required:

if (-not $env:TAG) {
    throw "Set TAG to a published release with diagnostics assets"
}
$Bundle = "live777-diagnostics-${env:TAG}-x86_64-pc-windows-msvc"
Expand-Archive -Path ".\$Bundle.zip" -DestinationPath .
cd ".\$Bundle"
.\bin\whipsynth.exe --version
.\bin\whepprobe.exe --version
.\bin\livewrk.exe --version

Configuration

cp conf/live777.toml live777.toml

live777 --config live777.toml

Docker

For a quick start, use the all-in-one image — it bundles live777, liveman, FFmpeg, the WHIP/WHEP tools and a smoke-test self-check:

docker run -d --name live777 --rm --network host ghcr.io/binbat/live777-all:latest
docker exec live777 smoke-test

See Getting Started for the full verification flow.

For production deployments, pick a slimmer image per role:

Image	Contents
ghcr.io/binbat/live777-server	live777 + liveman
ghcr.io/binbat/liveion	live777 only
ghcr.io/binbat/liveman	liveman only
ghcr.io/binbat/live777-client	FFmpeg + whipinto + whepfrom client tools
ghcr.io/binbat/whipinto / whepfrom / net4mqtt	Single-tool images

docker run --name live777-server --rm --network host ghcr.io/binbat/live777-server:latest live777

ARM Boards (Raspberry Pi / RK3588 / RDK X5)

Releases from v0.10.0 onward publish native builds with the hardware capture + encoder pipeline (see livehal) baked in — a camera streams without ffmpeg or any other helper process:

Board	Release asset
Raspberry Pi (64-bit OS)	live777-<version>-aarch64-unknown-linux-gnu-rpi.tar.gz
Rockchip RK3588 / RV1126B	live777-<version>-aarch64-unknown-linux-gnu-rkmpp.tar.gz

TAG=v0.10.0   # the first release with native builds; or any newer one
wget https://github.com/binbat/live777/releases/download/${TAG}/live777-${TAG}-aarch64-unknown-linux-gnu-rpi.tar.gz
tar xzf live777-${TAG}-aarch64-unknown-linux-gnu-rpi.tar.gz
cd live777-${TAG}-aarch64-unknown-linux-gnu-rpi
./live777 --config live777.toml

See the Raspberry Pi deployment guide for the full camera setup. For RDK X5, build from source with the native-rdk preset (requires RDK_SYSROOT).

WARNING

These boards software-encode poorly — do not use the generic ffmpeg -> whipinto path with libx264 on them; use the native builds above.

Cargo

cargo install --git http://github.com/binbat/live777 live777 --bin=whipinto
cargo install --git http://github.com/binbat/live777 live777 --bin=whepfrom

Debian / Ubuntu

wget https://github.com/binbat/live777/releases/download/latest/live777_<X>.<Y>.<Z>_amd64.deb
dpkg -I live777_<X>.<Y>.<Z>_amd64.deb
systemctl start live777

Centos / Fedora

wget https://github.com/binbat/live777/releases/download/latest/live777-<X>.<Y>.<Z>.x86_64.rpm
rpm -i live777-<X>.<Y>.<Z>.x86_64.rpm
systemctl start live777

Archlinux

wget https://github.com/binbat/live777/releases/download/latest/live777-<X>.<Y>.<Z>-x86_64.pkg.tar.zst
pacman -U live777-<X>.<Y>.<Z>-x86_64.pkg.tar.zst
systemctl start live777

Windows

Winget

winget install live777
winget install whipinto
winget install whepfrom