Skip to main content

GitHub release PyPI release GitHub commits since latest release GitHub contributors File size PyPI monthly downloads (without mirrors) PyPI total downloads

picosnitch

  • An extremely simple, reliable, and lightweight program for linux to help protect your privacy
    • It monitors your system and notifies you whenever it sees a new program that connects to the network
    • Or when the sha256 changes for one of those programs (can also check VirusTotal)
    • And features a curses based UI for browsing past connections
  • For advanced users who know what should be running on their system and when they should be making network connections
    • Only you can decide which programs to trust, so picosnitch leaves this decision up to you and just focusses on doing one thing well
    • A program you can't trust to make network connections also can't be trusted not to negate any firewall rules, so blocking or sandboxing these programs is out of scope for picosnitch (also beware of programs running as root that may try to stop/modify picosnitch)
  • Inspired by programs such as GlassWire, Little Snitch, and OpenSnitch

getting started

installation

  • install from the PPA for ubuntu and derivatives
    • sudo add-apt-repository ppa:elesiuta/picosnitch
    • sudo apt update
    • sudo apt install picosnitch
  • install using the PKGBUILD for arch and derivatives (will add to AUR soon)
    • git clone https://github.com/elesiuta/picosnitch.git
    • cd picosnitch/arch
    • makepkg
    • sudo pacman -U picosnitch-*.pkg.tar.zst
  • install from PyPI for any linux distribution with python >= 3.8
    • install the BPF Compiler Collection python package for your distribution
      • it should be called python-bcc or python-bpfcc
    • install picosnitch using pip
      • pip3 install "picosnitch[full]" --upgrade --user
    • create a service file for systemd to run picosnitch (recommended)
      • picosnitch systemd
    • optional dependencies (should already be installed or install automatically)
      • for notifications: dbus-python, python-dbus, or python3-dbus (name depends on your distro)
      • for VirusTotal: python-requests

usage

  • running picosnitch
    • enable/disable autostart on reboot with systemctl enable|disable picosnitch
    • start/stop/restart with systemctl start|stop|restart picosnitch
    • or if you don't use systemd picosnitch start|stop|restart
  • user interface for browsing past connections
    • start with picosnitch view
    • space/enter: filter on entry backspace: remove filter h/H: cycle through history t/T: cycle time range r: refresh view q: quit
  • show usage with picosnitch help

configuration

  • config is stored in ~/.config/picosnitch/config.json
    • restart picosnitch if it is currently running for any changes to take effect
{
  "DB retention (days)": 365, # How many days to keep connection logs
  "DB write limit (seconds)": 1, # Minimum time between writing logs to snitch.db
  # increasing it decreases disk writes by grouping connections into larger time windows
  # reducing time precision, decreasing database size, and increasing hash latency
  "Desktop notifications": True, # Try connecting to dbus for creating system notifications
  "Log addresses": True, # Log remote addresses for each executable
  "Log commands": True, # Log command line args for each executable
  "Log ignore": [], # List of process names (str) or ports (int)
  # will omit connections that match any of these from the connection log (snitch.db)
  # the process and executable will still be recorded in summary.json
  "Set RLIMIT_NOFILE": None, # Set the maximum number of open file descriptors (int)
  # increasing it allows more processes to be cached (typical system default is 1024)
  # this is good enough for most people since only one copy of each executable is cached
  "VT API key": "", # API key for VirusTotal, leave blank to disable (str)
  "VT file upload": False, # Upload file if hash not found, only hashes are used by default
  "VT request limit (seconds)": 15 # Number of seconds between requests (free tier quota)
}

logging

  • a short summary of seen processes is stored in ~/.config/picosnitch/summary.json
    • this is used for determining whether to create a notification
{
  "Latest Entries": [], # Log of entries by time
  "Names": {}, # Log of processes by name containing respective executable(s)
  "Processes": {}, # Log of processes by executable containing respective name(s)
  "SHA256": {} # Log of processes by executable containing sha256 hash(es) and VirusTotal results
}
  • the full connection log is stored in ~/.config/picosnitch/snitch.db
    • this is used for picosnitch view
  • the error log is stored in ~/.config/picosnitch/error.log
    • errors will also trigger a notification and are usually caused by far too many processes/connections
    • for most people in most cases, this should raise suspicion that some other program may be misbehaving

building from source

  • install dependencies listed under installation
  • install python-setuptools
  • install picosnitch with python setup.py install --user
  • see other commands with python setup.py [build|install] --help

Metadata

Release files for picosnitch 0.7.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for picosnitch 0.7.1
File Size Uploaded Provenance Actions
picosnitch-0.7.1.tar.gz 33.4 kB Without provenance Details for picosnitch-0.7.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for picosnitch 0.7.1
File Interpreter ABI Platform Actions
picosnitch-0.7.1-py3-none-any.whl Python 3 none any Details for picosnitch-0.7.1-py3-none-any.whl

Total release size: 67.1 kB

Release files / picosnitch-0.7.1.tar.gz

Download URL picosnitch-0.7.1.tar.gz
Size 33.4 kB
Tags Source
SHA-256 checksum
How to use checksums
e9c461789704cb8af021a7c157119098a8bc429645d36c6221dac20088957816
BLAKE2b-256 checksum
How to use checksums
f534da0d28cc1422be5586f28942dc012e31852029b94cf9613e108abe82423e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.7.1 importlib_metadata/4.8.2 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.9

Release files / picosnitch-0.7.1-py3-none-any.whl

Download URL picosnitch-0.7.1-py3-none-any.whl
Size 33.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3e133ae9c867419684666aefab984207a51d3f4780d90d8aeb4ae0b12bba5720
BLAKE2b-256 checksum
How to use checksums
1b9d827ea35b177eaf3713f081e530c3c18319dd1723d4b9fcb471ee9f79c828
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.7.1 importlib_metadata/4.8.2 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.9

Security for picosnitch 0.7.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.7.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page