Skip to content

Installation

IB_U_Z_Z_A_R_Dl edited this page Nov 18, 2026 · 15 revisions

⬇️ Download & Install

Session Sniffer runs on Windows, Linux (Ubuntu 24.04+ / Debian 13+ x64 for the standalone binary, or Ubuntu 22.04+ / Debian 12+ when running from source), and macOS (14+ / Apple Silicon ARM64).

Tip

Looking to run from source? See the Running from Source page, or compile manually on the Building from Source page.


🪟 Windows

The simplest way to get Session Sniffer running on Windows is to grab the latest pre-built standalone executable — no Python or manual dependencies required.

Download Session_Sniffer.exe

Important

Requirements: Windows 10 or 11 (x64) and Npcap for network packet capture. You will be prompted to install Npcap automatically on first launch if it is not already installed.


🐧 Linux (Ubuntu / Debian)

The simplest way to get Session Sniffer running on Linux is to grab the latest pre-built standalone executable — no Python or manual dependencies required.

Download Session_Sniffer

Important

Requirements: Ubuntu 24.04+ / Debian 13+ (x64) and libpcap (sudo apt install libpcap0.8). (On Ubuntu 22.04+ / Debian 12+, see Running from Source).

Step-by-Step Setup

Because web browsers download standalone files without execute permissions, follow these steps in Terminal to set up and launch Session Sniffer:

  1. Open Terminal:

    • Press Ctrl + Alt + T or open Terminal from your applications menu.
  2. Navigate to your Downloads folder:

    cd ~/Downloads
  3. Make the binary executable and grant raw capture capabilities:

    chmod +x Session_Sniffer
    sudo setcap cap_net_raw,cap_net_admin,cap_sys_ptrace=eip Session_Sniffer

    [!NOTE]

    • chmod +x: Sets the executable bit so the binary can be run.
    • setcap: Grants network capture capabilities to the binary without requiring you to run the application with sudo.
  4. Launch Session Sniffer:

    ./Session_Sniffer

🍎 macOS (Apple Silicon)

The simplest way to get Session Sniffer running on macOS is to grab the latest pre-built standalone executable — no Python or manual dependencies required.

Download Session_Sniffer_macOS

Important

Requirements: macOS 14+ (Sonoma or later) on Apple Silicon (ARM64: M1, M2, M3, M4). macOS includes libpcap by default.

Step-by-Step Setup

Because web browsers download standalone files without execute permissions and with macOS Gatekeeper quarantine flags, follow these steps in Terminal to set up and launch Session Sniffer:

  1. Open Terminal:

    • Press Command (⌘) + Space to open Spotlight.
    • Type Terminal and press Enter.
  2. Navigate to your Downloads folder:

    cd ~/Downloads
  3. Make the binary executable and remove Gatekeeper quarantine:

    chmod +x Session_Sniffer_macOS
    xattr -d com.apple.quarantine Session_Sniffer_macOS

    [!NOTE]

    • chmod +x: Sets the executable bit. Without this, double-clicking the file in Finder will open it in TextEdit instead of running it.
    • xattr -d com.apple.quarantine: Removes the download quarantine flag so Gatekeeper permits the app to launch. Alternatively, you can bypass Gatekeeper via System Settings > Privacy & Security > Security > Open Anyway.
  4. Grant packet capture permissions and launch:

    sudo chmod 666 /dev/bpf*
    ./Session_Sniffer_macOS

    (Enter your Mac administrator password when prompted. Characters will not appear on screen as you type — this is standard Unix security behavior).

    [!TIP] Alternatively, you can launch Session Sniffer directly with root privileges:

    sudo ./Session_Sniffer_macOS

    Persistent Permissions: The sudo chmod 666 /dev/bpf* command grants capture permissions until you restart your Mac. To retain BPF capture device permissions permanently across system reboots, install Wireshark's ChmodBPF package (included in the Wireshark macOS installer).


Clone this wiki locally