Prebuilt Binaries (No Python Required)

To use the ONVIF CLI without installing Python or additional dependencies, download a prebuilt binary distribution for your platform from the GitHub Releases page.

Each release includes platform-specific archives containing the ONVIF CLI executable and its required runtime files. Alternatively, download the latest archive for your platform and architecture from the table below.

Installation

Linux

1. Download the TAR.GZ archive matching your Linux architecture.
2. Extract the archive into a permanent location.
3. Create a symbolic link in ~/.local/bin so the executable can be invoked from any directory.

For example, for Linux AMD64, assuming the archive is in ~/Downloads:

mkdir -p ~/.local/opt ~/.local/bin
unzip ~/Downloads/onvif-linux-amd64.tar.gz -d ~/.local/opt
chmod +x ~/.local/opt/onvif/onvif
ln -sf ~/.local/opt/onvif/onvif ~/.local/bin/onvif

Ensure ~/.local/bin is included in your PATH. If necessary, add the following to ~/.bashrc or ~/.zshrc:

export PATH="$HOME/.local/bin:$PATH"

Reload your shell configuration or open a new terminal, then verify:

onvif --help

Replace onvif-linux-amd64.tar.gz with the archive matching your system.

Windows

1. Download the ZIP archive matching your Windows architecture.
2. Extract the archive. It contains an onvif directory with the executable and its bundled dependencies.
3. Move the extracted onvif directory to a permanent location, such as %LOCALAPPDATA%\Programs\ONVIF.
4. Add that directory to your user PATH environment variable.

To configure PATH, open Edit environment variables for your account, select Path, click New, and enter:

%LOCALAPPDATA%\Programs\ONVIF

Open a new terminal and verify the installation:

onvif --help

You can now invoke onvif from any working directory in PowerShell or Command Prompt.

macOS

1. Download the TAR.GZ archive matching your Mac's processor: Intel or Apple Silicon.
2. Extract the archive into a permanent location.
3. Create a symbolic link in ~/.local/bin.

For example, for Apple Silicon:

mkdir -p ~/.local/opt ~/.local/bin
unzip ~/Downloads/onvif-macos-arm64.tar.gz -d ~/.local/opt
chmod +x ~/.local/opt/onvif/onvif
ln -sf ~/.local/opt/onvif/onvif ~/.local/bin/onvif

Ensure ~/.local/bin is included in your PATH. If necessary, add this line to ~/.zshrc:

export PATH="$HOME/.local/bin:$PATH"

Open a new terminal and verify:

onvif --help

For Intel Macs, use onvif-macos-amd64.tar.gz instead.

Understanding the Distribution

The prebuilt binaries use PyInstaller's --onedir mode. Each archive contains the executable, bundled runtime dependencies, and project license documents.

The extracted directory has the following structure:

onvif/
├── onvif          # Linux and macOS
├── onvif.exe      # Windows only
├── LICENSE
├── NOTICE
└── _internal/
    └── ...        # Bundled runtime and dependencies

The _internal directory contains the Python runtime components, third-party dependencies, and bundled resources required by the executable.

Keep the executable and _internal directory together. Do not delete, rename, or move _internal independently. The application may fail to start or operate correctly if its bundled files are missing.

Comments