Repository navigation
Running from Source
IB_U_Z_Z_A_R_Dl edited this page Nov 20, 2026
·
5 revisions
Use this method if you want to run the application directly from Python source code on Windows, Linux, or macOS.
-
Python: Python 3.14 (see
pyproject.toml) -
Packet Capture Driver / Library:
- Windows: Install Npcap
-
Linux (Ubuntu 22.04+ / Debian 12+ x64): Install
libpcapandpython3-venv:sudo apt update && sudo apt install libpcap0.8 python3-venv -
macOS: Built-in
libpcap(pre-installed at/usr/lib/libpcap.A.dylib)
git clone https://github.com/BUZZARDGTA/Session-Sniffer.git
cd Session-Snifferuv is the recommended dependency and virtual-environment manager for development. It automatically manages .venv, locks dependencies via uv.lock, and installs development tools.
From the repository root:
uv sync --extra devNote
-
Linux: Grant raw capture capabilities to Python in
.venv:sudo setcap cap_net_raw,cap_net_admin,cap_sys_ptrace=eip $(readlink -f .venv/bin/python) -
macOS: Grant read and write permissions to BPF packet capture devices:
(Tip: Alternatively, install Wireshark's ChmodBPF package to retain BPF permissions across reboots).
sudo chmod 666 /dev/bpf*
Launch the application:
uv run python -m session_snifferIf you prefer not to use uv, you can manually create a virtual environment and install dependencies:
python -m venv --upgrade-deps .venv
.venv\Scripts\pip install -e .
.venv\Scripts\python -m session_snifferpython3 -m venv --upgrade-deps .venv
.venv/bin/pip install -e .
sudo setcap cap_net_raw,cap_net_admin,cap_sys_ptrace=eip $(readlink -f .venv/bin/python)
.venv/bin/python -m session_snifferpython3 -m venv --upgrade-deps .venv
.venv/bin/pip install -e .
sudo chmod 666 /dev/bpf*
.venv/bin/python -m session_snifferTip
Looking to compile a standalone executable instead? See the Building from Source page.
๐ฉ Need Help? Check out our Contact Support.
ยฉ 2026 IB_U_Z_Z_A_R_Dl. All rights reserved.