Prebuilt Binaries (No Python Required)

Run the ONVIF CLI without installing Python or additional dependencies. Download a prebuilt binary for your platform from the GitHub Releases page.

Each release provides ZIP archives for supported operating systems and architectures. Choose the appropriate binary from the table below.

Installation

Linux

1. Download the ZIP 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.zip -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.zip 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 ZIP 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.zip -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.zip 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.

The LICENSE and NOTICE files provide licensing and attribution information for the distribution.

Verify the Installation

After completing the platform-specific setup, run:

onvif --help

To see the available commands and options, consult the ONVIF CLI documentation.

These prebuilt binaries do not require a separate Python installation or a separate installation of the ONVIF Python package.

Comments