======================================================================
  PrivacyVPN for macOS (Apple Silicon M1/M2/M3/M4 & Intel 64-bit)
======================================================================

HOW TO RUN:
-------------------------
1. Double-click "PrivacyVPN.app" (or drag it to your Applications folder).
2. On first launch, PrivacyVPN will automatically prepare its isolated 
   environment and open the window.
3. Log in with your PrivacyVPN username and password, then click "QUICK CONNECT".

FIRST RUN SECURITY PROMPT (macOS Gatekeeper):
--------------------------------------------
Because PrivacyVPN is distributed directly outside the Mac App Store:
1. The first time you open "PrivacyVPN.app", Right-click (or hold Control and click) on it.
2. Select "Open" from the context menu.
3. Click "Open" on the confirmation prompt.
macOS will permanently remember your approval and let you open it with a normal double-click thereafter!

ALTERNATIVE LAUNCHER (Terminal / Debug):
----------------------------------------
If you prefer running from Terminal or checking logs:
- Double-click "PrivacyVPN.command", or run:
  bash run_mac.sh

SYSTEM PROXY ON MACOS:
----------------------
When connected, PrivacyVPN automatically routes your Mac's web traffic
through the secure encrypted residential gateway using native macOS
network settings (networksetup). When you click Disconnect or close the
app, system proxy routing is automatically restored to your default direct network.
======================================================================
