Skip to content

MatthieuClaessens/BlackMist

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BlackMist

Advanced System-Wide Anonymity Node

🛡️ Cybersecurity & Software Engineering Project | 2026

     


📖 Overview

BlackMist is a professional-grade privacy tool designed to bridge the gap between high-level anonymity networks and OS-level networking. Unlike standard browser-based solutions, BlackMist orchestrates the Tor Expert Bundle to enforce a global proxy state across the entire Windows environment.

💡 Engineering Decision: The core is built with Go to leverage low-level system calls (Win32 API) for registry manipulation, ensuring that the proxy toggle is atomic and leaves no room for IP leaks during state transitions.


📸 Technical Showcase (Frontend & State Management)

The interface, prototyped on Figma, focuses on "One-Click Security". It provides a minimalist aesthetic while maintaining real-time technical feedback (Bootstrap progress, Circuit latency). The core challenge was synchronizing the backend Tor process state with the frontend UI.

🌐 System Proxy Toggle & Real-time IP Monitoring

🔴 Mode: Offline (Exposed) 🔵 Mode: Online (Secured)
BlackMist exposed mode BlackMist secured mode
The proxy is disabled. The system IP is exposed (Status: Red). Tor is bootstrapped. System traffic is routed (Status: Blue).

Pro Tip: I implemented a Bootstrap Guard in Go. The system proxy is only engaged once the Tor circuit reaches 100% connectivity, preventing any data leaks (DNS or Traffic) during the handshake phase.


⚙️ 1. Backend & System Integration

BlackMist interacts directly with the OS Layer to ensure total traffic encapsulation:

  1. Process Orchestration: Secure spawning of the Tor child process with detached handles.
  2. Dynamic Configuration: Generation of volatile configuration files to ensure a Zero-Log footprint.
  3. Signal Communication: Implementation of the Tor Control Protocol to allow real-time identity rotation (NEWNYM).

🛠️ Tech Stack

Layer Technologies
Backend Core Go (Golang) 1.21+
Frontend Framework React / TypeScript / Tailwind CSS
Native Bridge Wails v2 (Context binding & Events)
Security Layer Tor Expert Bundle, Windows Registry API

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors