Skip to main content

picosnitch

  • See which processes make remote network connections
  • Logs and config are stored in ~/.config/picosnitch/snitch.json and updated every 10 minutes or on SIGTERM
  • Polls connections and processes at 0.2s intervals by default
  • Optionally sniff all traffic for new connections using Scapy for improved reliability
  • Inspired by programs such as:
    • GlassWire
    • Little Snitch
    • OpenSnitch
    • simplewall
    • tinysnitch
  • picosnitch only provides monitoring and notification capabilities, see the above programs for features such as a GUI, bandwidth tracking, firewall configuration, or filtering

getting started

linux

  • install from PyPI with
    pip3 install picosnitch --upgrade --user
  • optionally install Scapy
  • run daemon with
    picosnitch
  • or run daemon as root to use Scapy
    sudo -E python3 -m picosnitch

windows

building from source

  • install from source using python 3 with
    python setup.py install --user
  • required dependencies (installed automatically from PyPI on setup if not already present)
    filelock plyer psutil python-daemon
  • optional dependency (requires manual installation)
    scapy
  • picosnitch.py can also be run directly

configuration

  • stored in ~/.config/picosnitch/snitch.json
  • terminate picosnitch if it is currently running before making any edits otherwise your changes will be lost
{
  "Config": {
    "Polling interval": 0.2, # float in seconds
    "Remote address unlog": [80, "firefox"], # list of process names (str) or ports (int) to omit addresses
    "Use pcap": false, # bool, requires Scapy to be installed
    "Write interval": 600 # how often to write this file in seconds
  },
  "Errors": [], # Log of errors by time
  "Latest Entries": [], # Log of entries by time
  "Names": {}, # Log of process names and respective executable(s)
  "Processes": {}, # Log of processes by executable
  "Remote Addresses": {} # Log of remote addresses
}

Release files for picosnitch 0.2.0

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.2.0
File Size Uploaded
picosnitch-0.2.0.tar.gz 6.5 kB Details

Release files / picosnitch-0.2.0.tar.gz

Download URL picosnitch-0.2.0.tar.gz
Size 6.5 kB
Tags Source
SHA-256 checksum
How to use checksums
c14aed7a8312cfc543750a248e63ec9c2ef1163e6cfe9e941d7867bfab1ea37e
BLAKE2b-256 checksum
How to use checksums
e52f52eb52de14eab151b32cb6e5c2a0e52512cca72b2c241a89ca3e1f750374
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.8.2

Release history Release notifications | RSS feed

2.2.1

3 release files

2.2.0

3 release files

2.1.2

3 release files

2.1.1

3 release files

2.1.0

3 release files

2.0.3

3 release files

2.0.2

3 release files

2.0.1

3 release files

2.0.0

3 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.14.1

2 release files

0.13.2

2 release files

0.13.1

2 release files

0.12.0

2 release files

0.11.7

2 release files

0.11.5

2 release files

0.11.4

2 release files

0.11.3

2 release files

0.11.2

2 release files

0.11.1

2 release files

0.11.0

2 release files

0.10.1

2 release files

0.10.0

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.2

2 release files

0.8.1

2 release files

0.8.0

2 release files

0.7.3

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.5.0

2 release files

0.4.7

2 release files

0.4.6

2 release files

0.4.4

2 release files

0.4.2

2 release files

0.4.0

2 release files

0.3.8

2 release files

0.3.6

2 release files

0.3.4

2 release files

0.3.2

2 release files

0.3.0

2 release files

0.2.4

1 release file

0.2.2

1 release file

This release

0.2.0 This release

1 release file

0.1.0

1 release file

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