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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.