Skip to content

Installation Guide

netflix-narc is available both as a standalone single-file executable (no Python installation required) and as a standard Python package. Choose the method that best fits your workflow.

Standalone pre-compiled release binaries are available for macOS, Linux, and Windows. They require no Python environment setup and run out of the box.

1. Download Release Archive

Navigate to the latest release on GitHub Releases and download the archive matching your operating system and architecture:

Operating System Architecture Release Archive Name
macOS Apple Silicon (M1/M2/M3/M4) netflix-narc-aarch64-apple-darwin.tar.gz
macOS Intel netflix-narc-x86_64-apple-darwin.tar.gz
Linux x86_64 netflix-narc-x86_64-unknown-linux-gnu.tar.gz
Windows x86_64 netflix-narc-x86_64-pc-windows-msvc.zip

2. Extraction & Platform Notes

  1. Extract the downloaded archive: 
    tar -xzf netflix-narc-aarch64-apple-darwin.tar.gz
  2. Clear Apple Quarantine Attribute: Because release binaries are not signed with an Apple Developer Certificate, macOS Gatekeeper blocks unnotarized browser downloads with "netflix-narc Not Opened: Apple could not verify..." and terminates execution with killed. Run: 
    xattr -d com.apple.quarantine netflix-narc
  3. Run the binary directly: 
    ./netflix-narc
  4. (Optional) Move to system path: 
    sudo mv netflix-narc /usr/local/bin/
  1. Extract the archive and grant execution permissions: 
    tar -xzf netflix-narc-x86_64-unknown-linux-gnu.tar.gz
chmod +x netflix-narc
  2. Run or move to local path: 
    mv netflix-narc ~/.local/bin/
  1. Extract netflix-narc-x86_64-pc-windows-msvc.zip (or the raw .exe).
  2. Launch from Command Prompt or PowerShell: 
    .\netflix-narc.exe

3. Verifying Download Integrity (SHA256)

Each release includes an official SHA256SUMS manifest file. You can verify checksums before executing:

# macOS
shasum -a 256 -c SHA256SUMS

# Linux
sha256sum -c SHA256SUMS

Option B: Python Package (uv, pipx, pip, or Source)

If you have Python (≥ 3.13) installed on your system, you can install netflix-narc into an isolated Python environment.

uv installs netflix-narc into an isolated tool environment:

uv tool install netflix-narc

pipx install netflix-narc

pip install netflix-narc

Install the cutting-edge main branch directly from GitHub:

uv tool install git+https://github.com/Kilo59/netflix-narc

Verifying Installation

Verify that netflix-narc is installed correctly by checking the CLI help flags:

netflix-narc --help