Skip to main content

picosnitch

  • Monitors your system to notify you whenever a program makes its first remote network connection (while picosnitch has been running)
  • Or when the sha256 changes for one of these programs
  • Connection logs and config are stored in ~/.config/picosnitch/snitch.json
  • Error log is stored in ~/.config/picosnitch/error.log
  • 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[full] --upgrade --user
  • depends on the BPF Compiler Collection
    sudo apt install python3-bpfcc
  • run daemon with
    picosnitch start
  • stop daemon with
    picosnitch stop

windows

  • no longer supported for now, use a version <= v0.2.5

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)
    plyer psutil vt-py
  • additional dependency (requires manual installation)
    bcc

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": {
    "Log command lines": True, # Log command line args for each executable
    "Log remote address": True, # Log remote addresses for each executable
    "Only log connections": True, # Only log processes that make remote network connections
    # otherwise log every new process from exec()
    "Remote address unlog": [80, "chrome", "firefox"], # List of process names (str) or ports (int)
    # will omit connections that match any of these from the log of remote addresses to avoid clutter
    # the process and executable will still be logged if it has not been already
    "VT API key": "", # API key for VirusTotal, leave blank to disable
    "VT file upload": False, # Only hashes are uploaded by default
    "VT limit request": 15 # Number of seconds between requests
  },
  "Latest Entries": [], # Log of entries by time
  "Names": {}, # Log of processes by name containing respective executable(s)
  "Processes": {}, # Log of processes by executable containing:
  # cmdlines, days seen, first seen, last seen, name, ports, remote addresses, results
  # some cmdlines are consolidated using * as a wildcard, results are obtained from VirusTotal
  "Remote Addresses": {} # Log of remote addresses containing respective executable(s)
}

Metadata

Release files for picosnitch 0.4.6

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.4.6
File Size Uploaded Provenance Actions
picosnitch-0.4.6.tar.gz 26.9 kB Without provenance Details for picosnitch-0.4.6.tar.gz

Built distribution (wheel)

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

Total release size: 54.4 kB

Release files / picosnitch-0.4.6.tar.gz

Download URL picosnitch-0.4.6.tar.gz
Size 26.9 kB
Tags Source
SHA-256 checksum
How to use checksums
5c0377201c40fdb06c3f77cfaf86b18baa2c8e80eb5ab8094eaa64fe9821f889
BLAKE2b-256 checksum
How to use checksums
8b4f18a3f6e728264e68849c0e84abc7b1d4c6f21a01da4c512945c7766f68d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.2 importlib_metadata/4.7.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.9.6

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

Download URL picosnitch-0.4.6-py3-none-any.whl
Size 27.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7602cccc184636081374cff1a1a4ca3bef1e45e0dd517c2cf8441262115bf2a7
BLAKE2b-256 checksum
How to use checksums
5e1e363075a6af6074656fe71bb94a57dff8d8ff15c6a91c0d135237639069ba
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.2 importlib_metadata/4.7.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.9.6

Security for picosnitch 0.4.6

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.4.6 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