vpn-monitor 0.6.0

Monitors Windows App and enforces VPN usage.

VPN Monitor

A Windows background application that monitors specific "Windows App" processes (e.g., msrdc.exe, Windows365.exe) and enforces VPN usage by checking the current region.

Features

• Process Monitoring: Detects if msrdc.exe or Windows365.exe has a visible window.
• Region Check: Verifies if the current public IP is in the allowed country (default: HU).
• Allowed IPs: Supports an optional list of allowed external IPs that bypass the country check.
• Warning System: Displays a custom, topmost warning window if the region is incorrect while the target app is running.
• System Tray:
  • Snooze functionality (5m, 15m, 1h, 8h).
  • Set Allowed Country.
  • Exit.
• Startup Integration: Can register itself to run at Windows startup.

Installation

1. Prerequisites: Python 3.8+
2. Install Dependencies:

   pip install -r requirements.txt
   

   (Or pip install psutil requests pystray Pillow)

Usage

Running from Source

python run.py

Command Line Arguments

• --install-startup: Registers the app to run on Windows startup.
• --remove-startup: Removes the app from Windows startup.

Configuration

Allowed Country

The default allowed country is HU (Hungary). You can change this via the System Tray menu ("Set Country...") or by setting the ALLOWED_COUNTRY environment variable.

Allowed IPs (Bypass)

You can create a file named allowed_ips.txt in the same directory as the executable (or run.py). Add one IP address per line. If your current external IP matches any IP in this list, the warning will be suppressed regardless of your country.

Example allowed_ips.txt:

203.0.113.1
198.51.100.2

Building Executable

To build a standalone .exe:

pyinstaller --noconsole --onefile --name vpn-monitor run.py

The output will be in the dist folder.

Development

Releasing a New Version

This project uses setuptools-scm — the version is automatically derived from git tags. No version is stored in pyproject.toml.

To release a new version:

git tag v1.0.0
git push --tags

Pushing the tag triggers the release workflow, which builds the executable and creates a GitHub release. The package version is automatically set based on the tag (e.g., tag v1.0.0 → version 1.0.0).