CoalMine

KO | EN

gitlite — search

#javascript #python #react #typescript #go #android #rust #macos #nodejs #windows #awesome #cli #kubernetes #awesome-list

(★ 24)

Be alerted to changes to your VPN/ service providers canary notice

CoalMine 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Coal Mine
![Canary Image](https://i.imgur.com/JRsJ8Q1.png)

Coal Mine is a tool that checks various VPN/ service providers [Canary notices](https://en.wikipedia.org/wiki/Warrant_canary) and reports any changes that have been found back to the user.

---

**Supported Platforms**:
- Linux
- Windows
- Mac

---

**Supported VPNs/ service providers**:
- [Ace](https://www.acevpn.com/)
- [Anonine](https://anonine.com/)
- [Azire](https://www.azirevpn.com/)
- [Cloudflare](https://www.cloudflare.com/)
- [IVPN](https://www.ivpn.net/)
- [Liquid](https://www.liquidvpn.com/)
- [Nord](https://nordvpn.com/)
- [Proton](https://protonvpn.com/)
- [Proxy.sh](https://proxy.sh/)
- [SlickVPN](https://www.slickvpn.com/)
- [Spyoff](https://www.spyoff.com/)
- [VPNHT](https://vpn.ht/)
- [VPNSecure](https://www.vpnsecure.me/)

---

**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**:

![Linux Alert](https://i.imgur.com/FVpYt66.png)

**Windows**:

![Windows Alert](https://i.imgur.com/12P3WGv.png)

**Mac**:

![Mac Alert](https://i.imgur.com/DGNhLVh.png)

---

**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](https://askubuntu.com/questions/978382/how-can-i-show-notify-send-messages-triggered-by-crontab) so that cron can display the notifications properly.

For a list of supported environments, [click here](https://github.com/pa4080/cron-gui-launcher#supportedtested-desktop-environments).

---

**Potential Enhancements**:
- Multi-flag support
- PGP signature support

---

[![paypal](https://i.imgur.com/wsX84nD.png)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=W2FJJJAM7EESC&item_name=Development+efforts/+coffee+fund&currency_code=USD&source=url)

CoalMine

CoalMine 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

CoalMine

CoalMine 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README