👻💀 Ghost VPN - Tactical HUD Interface

Military-grade terminal interface for your OpenVPN connection. Inspired by Fast & Furious, Mission Impossible, and tactical military displays.

✨ Features

• 🎬 Cinematic Animations: Movie-style scanning effects and typewriter animations
• 🗺️ Live Geolocation: Real-time location data with ASCII world map
• 📊 Status Dashboard: Full tactical panel with connection metrics
• 🔒 Military-Grade Display: Box-drawing characters and tactical styling
• 🔔 Sound Alerts: Terminal bell for critical events
• ⚡ Fast & Responsive: Optimized for real-time updates

📦 Installation

npm (recommended)

npm install -g ghost-23
mkdir -p ~/.config/ghost
cp /path/to/ghost.ovpn ~/.config/ghost/ghost.ovpn
cp /path/to/auth.txt ~/.config/ghost/auth.txt  # user on line 1, pass on line 2

Run it:

ghost connect         # or simply `ghost`
ghost status          # tactical HUD readout
ghost kill            # extraction protocol

Flags:

ghost connect --config /path/to/ghost.ovpn --auth /path/to/auth.txt --no-sudo
ghost status --root /custom/location/of/scripts

Environment overrides: GHOST_ROOT, GHOST_OVPN_CONFIG, GHOST_AUTH_FILE, GHOST_OPENVPN_BIN, GHOST_USE_SUDO=false.

Manual install (legacy)

# Clone or download Ghost VPN to ~/vpn/ghost
cd ~/vpn/ghost

# Run installer
chmod +x install.sh
./install.sh

# Reload your shell
source ~/.zshrc  # or source ~/.bashrc

Requirements

• macOS or Linux (tested on macOS 14+; use --openvpn to point to a custom binary)
• OpenVPN (brew install openvpn or distro packages)
• curl
• jq
• Your VPN config file (ghost.ovpn preferred; ghost_💀.ovpn still supported)

🎮 Usage

Connect to VPN

ghost connect

Launches the tactical connection sequence with cinematic animations.

Check Status

ghost status

Displays full tactical status panel with:

• Connection status
• Geolocation (city, coordinates)
• IP addresses (public & tunnel)
• Encryption details
• Latency metrics
• ASCII world map
• Uptime information

Disconnect

ghost kill

Executes extraction protocol with secure channel closure.

🎨 Visual Style

The interface uses:

• Colors: Green (active), Cyan (info), Red (danger), Yellow (warning)
• Box Drawing: Unicode characters for clean borders
• Progress Bars: Animated scanning sequences
• Military Time: 24-hour UTC timestamps
• ASCII Art: Ghost logo and world map

📁 File Structure

ghost-23/
├── package.json               # npm metadata & bin mapping
├── bin/ghost.js               # Node CLI wrapper
├── ghost-hud.sh               # Core HUD functions
├── ghost-connect.sh           # Connection command
├── ghost-status-display.sh    # Status dashboard
├── ghost-kill-display.sh      # Disconnection protocol
├── ascii-art/
│   └── ghost-logo.txt         # ASCII Ghost logo
└── README.md                  # This file

⚙️ Configuration

VPN Server Settings

• Server: 136.110.57.23:1194
• Protocol: UDP
• Encryption: AES-256-GCM
• Authentication: SHA-256
• Location: Asia Southeast (Singapore)

Animation Speed

Default: 0.03s per character (cinematic mode)

Edit ghost-hud.sh to change:

CHAR_DELAY=0.03  # Adjust for faster/slower animations

Sound Effects

Minimal mode enabled (connection events only)

Disable all sounds by removing alert_sound calls in scripts.

🔧 Troubleshooting

VPN Won't Connect

# Check OpenVPN logs
tail -f /tmp/ghost_vpn.log

# Verify config file exists
ls ~/.config/ghost/ghost.ovpn

# Test OpenVPN manually
sudo openvpn --config ~/.config/ghost/ghost.ovpn

Commands Not Found

# Reload shell configuration
source ~/.zshrc  # or ~/.bashrc

# Verify installation
which ghost

Geolocation Not Working

The interface uses free APIs (ipapi.co) with rate limits. If geolocation fails:

• Data is cached for 1 hour in /tmp/ghost_geo_cache.json
• Falls back to "Unknown" if API is unavailable
• No API key required

🚀 Advanced

• Custom VPN Server: update the server IP in ghost-connect.sh and ghost-status-display.sh.
• Override paths: set GHOST_OVPN_CONFIG, GHOST_AUTH_FILE, or --config/--auth flags.
• Run without sudo: GHOST_USE_SUDO=false ghost connect (for root shells/containers).

🚢 Publish to npm

1. npm login
2. npm version patch (or minor/major)
3. npm publish --access public
4. Verify: npm info ghost-23 then npm i -g ghost-23 on a fresh machine.

📝 License

Private Use Only

This is a personal VPN configuration interface. Do not redistribute without permission.

🎯 Credits

Created for personal use. Inspired by:

• Fast & Furious franchise (tactical displays)
• Mission Impossible series (field operations UI)
• Military command center interfaces

Ghost VPN Tactical HUD v1.0 | Built with ❤️ and 💀

Setup Info (GCP Backend)

• Instance: instance-20251125-223017
• Zone: asia-southeast1-b
• Project: goodhive-1706112296263
• Firewall: allow-openvpn (UDP 1194)
• Cost: ~$3.65/month (static IP)