Serial OS

Serial OS is a custom, high-contrast operating system environment built on Kali Linux. Inspired by the efficiency of Blender's tiling system and the aesthetic of sci-fi terminal interfaces, it provides a modular, recursive workspace optimized for multi-terminal workflows, touch interaction, and persistent penetration testing data management.

🚀 Key Features

🔲 Blender-Style Modular Tiling

• Recursive Splitting: Split any area horizontally or vertically into infinite sub-panes.
• Dynamic Resizing: Drag borders to customize your layout on the fly.
• Modular Content: Every tile can be swapped between a Terminal, System Monitor, File Matrix, Network Radar, or Hacker Vault.

🔐 The Hacker Vault (Persistent Database)

• Asset Tracking: Automatically logs every host discovered during network scans.
• Credential Management: Integrated database to store usernames, passwords, and SSIDs found during engagements.
• Persistence: Data is stored in a structured JSON vault (~/.serial_os/vault.json), surviving reboots and app restarts.

🌐 Advanced Tiled Browser

• Header-Stripping Proxy: Uses a custom Rust-based proxy protocol (proxy://) to strip X-Frame-Options and CSP headers, allowing you to tile restricted sites (Google, GitHub, exploit-db) directly alongside your terminal.
• External Handoff: A dedicated POP_OUT feature to instantly transition research from a tile to a full Firefox instance.

📡 Radar Matrix (Node Discovery)

• Cumulative Mapping: A force-directed SVG graph that grows as you scan more of the network.
• Custom Range Scanning: Integrated Nmap controls allowing for specific IP range discovery directly from the UI.

⌨️ Touch-Optimized Input

• Modular Keyboard Pane: A fully integrated virtual QWERTY keyboard that can be tiled anywhere in the workspace.
• Smart Routing: Automatically tracks the last active terminal session to route input without losing focus.

---

🛠 Architecture

• Frontend: React 19, Tailwind CSS 4, Lucide Icons.
• Backend: Tauri 2.0 (Rust).
• Terminal: xterm.js with portable-pty for high-performance terminal emulation.
• OS Base: Kali Linux Rolling (Debian-based).
• Window Manager: Matchbox WM (No-decoration mode).

---

📦 Build Instructions

Prerequisites

• Rust & Cargo
• Node.js & npm
• Debian Live-Build (lb)

Building the Interface

cd interface
npm install
npm run tauri build

Generating the Bootable ISO

cd live-build
sudo lb config --distribution kali-rolling 
               --iso-application "Serial OS" 
               --iso-volume "Serial OS v1.0"
sudo lb build

---

🎨 Customization

Serial OS features a dynamic theme engine with several high-contrast modes:

• Matrix: Classic terminal green on black.
• Amber: High-visibility orange.
• Cyber: Neon blue.
• Mono Light: Stark white on black.
• Mono Dark: Clean black on white.

Themes can be hot-swapped via the global settings menu without restarting the interface.

---

🗺 Roadmap

• Multi-workspace support (Virtual Desktops).
• Native Metasploit RPC integration for the Vault.
• Touch gestures for window joining/merging.
• Integrated packet capture visualization pane.

📄 License

MIT License - Developed by Serial Scientist