Coal Mine is a tool that checks various VPN/ service providers Canary notices and reports any changes that have been found back to the user.
Supported Platforms:
- Linux
- Windows
- Mac
Supported VPNs/ service providers:
To run (I'll streamline this at some point):
- Clone project
- Install dependencies
- Add canary.py to a cronjob or scheduled task (notes below)
Example Usage:
python canary.py -nord
python canary.py -proton
python canary.py -proxy.sh
Notification Examples (hopefully you never see these):
Linux:
Windows:
Mac:
Notes on adding as chronjob:
Because cronjobs use a different DISPLAY variable by default, you may not see the notifications displayed.
In this case, you will need to export your current env vars using this method so that cron can display the notifications properly.
For a list of supported environments, click here.
Potential Enhancements:
- Multi-flag support
- PGP signature support
