Ghost Engine v5.1 — Cross-Platform Upgrade, Better Setup, Better Docs

👻 Ghost Engine v5.1

Advanced TOR Identity Rotation & Privacy Proxy Framework

Comprehensive runtime upgrade · Cross-platform hardening ·
Documentation overhaul · Open-source release preparation

---

📌 Release Summary

38 files changed · +9,055 / −566 · 19 commits
Built on v5 with a full product-polish pass across the engine, installer,
documentation, and contributor pipeline.

---

🚀 What's New in v5.1

🔧 Ghost Engine Runtime & CLI

Command-line mode	ns-ghost start, stop, status, rotate, ip, health — full headless operation without the interactive menu. Scriptable, cron-friendly, remote-SSH ready.
Persistent configuration	~/.config/ghost-engine/ghost.conf survives restarts. Proxy ports, Tor control port, and startup behaviour are remembered.
PID‑scoped process management	PID files in ~/.cache/ghost-engine/ enable precise teardown. ns-ghost stop targets only Ghost Engine's Tor and Privoxy processes — no stray kills.
Health diagnostics	ns-ghost doctor probes Tor, Privoxy, DNS resolution, and external IP in one shot. Reports failures with actionable messages.
Cross-platform detection	Automatic WSL, Termux, Linux, and macOS identification drives platform‑specific runtime paths and behaviour.
Shutdown proxy warning	After stop, Ghost Engine prints platform‑specific instructions to disable manual proxy settings — Wi‑Fi proxy on Termux, system proxy on WSL, browser proxy on Linux/macOS. No more broken internet surprises.
Improved interactive menu	Clearer status display, better error messages, tighter process lifecycle throughout the menu-driven flow.

📦 Installer / Updater / Bootstrap Pipeline

• New bootstrap.sh entry point — POSIX sh‑compatible bootstrap that strips CRLF, sets executable permissions, and dispatches to install/update/uninstall. Works whether users run sh bootstrap.sh or ./bootstrap.sh.
• CRLF self‑heal — install.sh, update.sh, uninstall.sh detect Windows line endings on first run, clean them with tr -d '\r', and re‑execute. One‑shot fix for the most common cross‑platform install failure.
• Portable CRLF cleanup — All sed -i invocations replaced with tr -d '\r', avoiding the GNU/BSD sed incompatibility that breaks on macOS.

🌐 Platform Setup & Proxy Guidance

• Termux Wi‑Fi proxy section — Full step‑by‑step Android Wi‑Fi proxy setup with traffic flow diagram, verification walkthrough, honest app‑limitation notes, and a dedicated screenshot (ANDROID_WIFI_PROXY_SETUP.jpeg).
• WSL guide rewritten — From a 5‑line placeholder to a complete 7‑section guide covering WSL2 enable, clone, bootstrap install, start, route Windows traffic via WSL proxy IP, gotchas (dynamic IP, internet breakage, WSL1 vs WSL2), and update/remove.
• Linux proxy routing — Browser and CLI proxy configuration with endpoint reference table, curl examples, and Proxy SwitchyOmega setup.
• macOS proxy routing — curl examples and System Preferences network proxy setup guide.

📖 Documentation & README

• README restructured — Platform install guides consolidated into docs/PLATFORMS.md with a compact Quick Reference table in the README, preserving every word while cutting visual weight. Added governance and documentation section linking to all new docs.
• New documentation suite:

  docs/PLATFORMS.md	Per‑platform install guides (Termux, Linux, macOS, WSL)
  docs/ARCHITECTURE.md	Component roles, startup sequence, rotation flow, health check, process safety model, config persistence
  docs/QUICKSTART.md	Converted from quickstart.txt to Markdown with improved structure
  docs/TROUBLESHOOTING.md	Converted from troubleshooting.txt to Markdown with categorised issues
  docs/RELEASING.md	Maintainer release checklist, tagging, GitHub release notes template

• Original .txt docs preserved alongside new Markdown versions for reference continuity.

🏗️ Open‑Source Repository Hardening

• Issue templates — bug_report.yml with Tor/privacy‑tool‑specific fields, feature_request.yml with area selection, config.yml disabling blank issues and routing to docs.
• PR template — Area checklist, platform testing checkbox, shell safety guidance.
• Contributor documentation — CONTRIBUTING.md with repo structure, dev workflow, shell guidelines, cross‑platform caveats, CRLF safety, PR process.
• Governance files — SECURITY.md (security vulnerability reporting for a Tor privacy tool), SUPPORT.md (help resources, issue routing, quick recovery commands), CODE_OF_CONDUCT.md (already strong, retained as‑is).
• Repository hygiene — .gitattributes (LF enforcement for shell/config/doc files, binary asset marking), .editorconfig (LF, UTF‑8, 4‑space shell indent), .gitignore (editor droppings, runtime data, temp files).

🐛 Bug Fixes

• Issue template links: ../docs/ → docs/ (GitHub issue forms resolve from repo root, not template location)
• README: ns-gamming URLs → naborajs, Ghost Engine v4 → v5
• README: pkill tor; pkill privoxy → ns-ghost stop (contradicted v5 PID‑safe process model)
• README: assets\ → assets/ (backslash broke GitHub image rendering)
• CONTRIBUTING.md: repo tree had missing ARCHITECTURE.md, duplicate bootstrap.sh, wrong INSTALL.md
• SUPPORT.md: docs/INSTALL.md → docs/PLATFORMS.md
• docs/QUICKSTART.md: INSTALL.md → PLATFORMS.md

---

💡 Why This Release Matters

v5.1 is the largest single improvement pass since the v4→v5 engine rewrite. It takes Ghost Engine from a functional but rough terminal script to a polished, documented, contributor‑ready open‑source project.

The runtime is now safe to run headless. The installer handles Windows‑to‑Unix line‑ending corruption automatically. Every platform has a setup guide that covers install, proxy routing, gotchas, and cleanup. The repository has issue templates, a PR template, contributing guidelines, and security policies for anyone who wants to help.

But the core identity hasn't changed. Ghost Engine is still a terminal‑first, privacy‑focused Tor identity rotation tool. It just works better, is easier to get started with, and is harder to mess up.

---

⬆️ How to Update

If you already have Ghost Engine installed:

cd ~/Termux-Tor-IP-Rotator
git pull
sh bootstrap.sh update

Or for a clean install on any platform:

git clone https://github.com/naborajs/Termux-Tor-IP-Rotator.git
cd Termux-Tor-IP-Rotator
sh bootstrap.sh install
ns-ghost start

Note: If you use a manual proxy on Android, Windows (WSL), or your browser, remember to disable it after running ns-ghost stop to restore normal internet access.

---

🧪 Testing & Validation

• All shell scripts pass bash -n syntax check
• CRLF self‑heal verified by injecting CRLF and confirming clean re‑execution
• All documentation rendered locally to verify GitHub Markdown rendering
• All internal cross‑references and links verified across README, docs, and templates
• Asset paths confirmed against actual files in assets/

---

Ghost Engine v5.1 is the result of real care for the project —
not just code that runs, but code that's a pleasure to use and contribute to.

...

Ghost Engine v5 — Cross-Platform TOR Proxy & IP Rotation Toolkit

👻 Ghost Engine v5

Cross-Platform TOR Proxy & IP Rotation Toolkit

Ghost Engine v5 is a major upgrade focused on turning Ghost Engine into a more polished, cross-platform privacy toolkit for Termux, Linux, macOS, and WSL2.

This release introduces a stronger installer workflow, improved updater and uninstaller scripts, better cross-platform handling, richer documentation, preview assets, troubleshooting guidance, and a more complete user experience around TOR routing, SOCKS5 / HTTP proxy workflows, and identity rotation.

Primary themes of v5:
Better onboarding • Better maintenance flow • Better cross-platform support • Better documentation • Better overall Ghost Engine experience

---

🚀 What’s New in Ghost Engine v5

Ghost Engine v5 is not just a small patch release — it is a much larger refresh of the project aimed at making Ghost Engine feel like a more complete and maintainable release line.

• Cross-platform installer improvements for Termux, Linux, macOS, and WSL2
• Improved update workflow with repository validation and reinstall flow integration
• Safer and cleaner uninstall flow with better warnings, confirmations, and data cleanup handling
• Expanded README and onboarding flow with screenshots, architecture visuals, troubleshooting, FAQ, and guided usage notes
• Better script preparation and shell handling for Ghost Engine runtime files
• More polished project presentation for new users, testers, and contributors

---

✨ Highlights of v5

1) Cross-Platform Installer Overhaul

The Ghost Engine installer has been significantly improved to make setup smoother and more reliable across supported environments.

• Platform-aware installation flow for Termux, Linux, macOS, and WSL2
• Dependency installation for TOR, Privoxy, curl, and netcat
• Preparation of core Ghost Engine shell scripts during install
• Automatic launcher setup for the global ns-ghost command
• Cleaner onboarding and post-install guidance

2) Updater Improvements

Ghost Engine’s update workflow has been improved so users can refresh their local installation more cleanly and consistently.

• Repository validation before updating
• Safer update flow and clearer progress output
• Reinstall integration after pulling the latest build
• Cleaner structure for maintaining Ghost Engine over time

3) Uninstaller Improvements

The uninstall flow has been redesigned to feel much more complete and intentional.

• Brighter warning / confirmation flow before removal
• Improved launcher cleanup behavior
• Optional cleanup of Ghost Engine data and runtime directories
• More explicit summary output at the end of uninstall

4) Documentation & README Refresh

The README has been expanded into a much more complete guide for installation, verification, troubleshooting, and usage across supported platforms.

• New preview images and terminal screenshots
• Platform-specific setup sections for Termux, Linux, macOS, and WSL2
• Verification steps for TOR proxy routing
• Troubleshooting tables and recovery steps
• Expanded FAQ and support / contribution guidance

---

🧠 Core Ghost Engine Capabilities

Ghost Engine v5 continues to build around the project’s original purpose: making TOR-based routing, identity rotation, and proxy workflows easier to manage from the terminal.

• Manual TOR identity rotation
• Automatic IP rotation workflow
• SOCKS5 TOR proxy access
• HTTP proxy routing via Privoxy
• Health checks and diagnostic tooling
• Exit-node / routed IP verification
• Guided terminal-based privacy workflow

---

🖥️ Supported Platforms

Ghost Engine v5 is designed to work across multiple environments:

• Android / Termux
• Linux (Debian / Ubuntu / Kali / Parrot and similar apt-based systems)
• macOS (Intel + Apple Silicon)
• WSL2

While Ghost Engine originally grew out of a Termux-first workflow, v5 is the release where the project makes a much stronger push toward a polished cross-platform experience.

---

📦 Included in This Release

• Updated install.sh with stronger platform-aware setup flow
• Updated update.sh for cleaner project refresh / reinstall handling
• Updated uninstall.sh with better cleanup and confirmation flow
• Updated Ghost Engine runtime / launcher preparation flow
• Expanded project documentation and screenshots
• New support, troubleshooting, FAQ, and contribution sections
• General project cleanup and usability improvements

---

⚠️ Notes About v5

• Ghost Engine v5 is a major project refresh and should be treated as the new main Ghost Engine release line going forward.
• The older v4 release is preserved as the original Ghost Engine / Termux-era release milestone.
• If you are updating from an older Ghost Engine setup, it is recommended to re-run the new installer and review the updated README / platform notes.

---

🔍 Recommended Verification After Installing v5

After installing Ghost Engine v5, verify that traffic is actually being routed through TOR:

Check your normal IP

curl https://api64.ipify.org

Check your Ghost Engine / TOR-routed IP

curl --proxy http://127.0.0.1:8118 https://api64.ipify.org

If the two IPs are different, Ghost Engine is routing traffic through TOR successfully.

---

🛠 Updating & Uninstalling

Update Ghost Engine

bash update.sh

Uninstall Ghost Engine

bash uninstall.sh

The new maintenance flow is designed to make Ghost Engine easier to keep up to date and easier to remove cleanly when needed.

---

💡 Why This Release Matters

Ghost Engine started as a more lightweight Termux-oriented TOR rotation utility. This release is the point where the project becomes much more complete: not just a script, but a more polished privacy toolkit with a proper install / update / uninstall flow, better documentation, platform-aware setup guidance, and a clearer user journey.

In short: v5 is the strongest Ghost Engine release so far.

---

🙏 Thanks

This release took a lot of iteration across scripting, debugging, platform testing, README design, troubleshooting, and overall cleanup. Thank you to everyone who checks out the project, stars the repo, reports bugs, or contributes ideas and improvements.

---

💖 Support & Contribute

If Ghost Engine helps you, the best support is simple:

• Star the repository
• Open an issue if you find a bug
• Suggest improvements or submit a pull request
• Test Ghost Engine on your platform and share feedback

Ghost Engine is still growing, and thoughtful feedback helps a lot.

---

👻 Ghost Engine v5

Ghost Engine v5 is finally here.

This release is the result of a huge amount of work focused on making Ghost Engine feel stronger, cleaner, more complete, and far more polished than before — from the installer and maintenance flow to the docs, previews, troubleshooting, and overall user experience.

Better setup. Better docs. Better tooling. Better Ghost.

Built and maintained by Naboraj Sarkar
_{aka Nishant Sarkar • Founder of NS CODEX}

If this project helped you, taught you something, or saved you time,

consider starring the repository, opening an issue, or contributing to Ghost Engine’s future.

Stay private. Stay careful. Stay Ghost. 👻💙