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:

• Ace
• Anonine
• Azire
• Cloudflare
• IVPN
• Liquid
• Nord
• Proton
• Proxy.sh
• SlickVPN
• Spyoff
• VPNHT
• VPNSecure

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