What is Unseen

Unseen is a command-line tool that routes your internet traffic through the Tor network, providing anonymity directly from your terminal. Unlike a traditional VPN, it uses onion routing to hide your identity and location.

Features

• Tor integration – Automatically starts and manages a Tor process.
• Exit node selection – Choose a specific country for your exit node or let Tor decide automatically.
• Smart validation – Detects when Tor ignores your selected country and lets you retry or switch.
• System-wide routing – Routes all macOS traffic through 127.0.0.1:9050 (SOCKS5 proxy).
• Live connection info – Displays your anonymous IP, country, region, and city after connection.
• Automatic cleanup – On exit (CTRL+C), stops Tor and restores original network settings.

Installation

git clone https://github.com/vladkotov92/unseen.git
cd unseen
bash install.sh

Usage

bash unseen.sh

On startup, you can choose an exit node country (e.g. US, DE, NL) or press ENTER to let Tor decide.

How it works

• Stops existing Tor instances
• Starts Tor and waits for full bootstrap
• Enables SOCKS5 proxy on macOS network interfaces
• Fetches anonymous IP and location
• Validates exit node country
• Restores system settings on exit

Notes

• Tor exit IP may change between sessions
• Some countries have limited or no exit nodes
• Some websites may block Tor traffic

Release notes