xKOR_3RR0R

██╗  ██╗██╗  ██╗ ██████╗ ██████╗
╚██╗██╔╝██║ ██╔╝██╔═══██╗██╔══██╗
 ╚███╔╝ █████╔╝ ██║   ██║██████╔╝
 ██╔██╗ ██╔═██╗ ██║   ██║██╔══██╗
██╔╝ ██╗██║  ██╗╚██████╔╝██║  ██║
╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝

A cyberpunk OS interface for Linux · Real terminals · Live system data · Full OS replacement

[ SYS ] initializing xKOR_3RR0R...

[ OK ] Tauri v2 runtime loaded

[ OK ] Rust backend initialized

[ OK ] PTY sessions ready

[ WARN ] standard desktop not found

[ OK ] that's intentional

GET STARTED VIEW SOURCE

-- SCROLL DOWN --

// 01

OPERATING MODES

APP MODE

Run on top of your existing Linux desktop as a regular Tauri window. Quick to try, no system changes.

LAUNCHbash run.sh

LOGINbuilt-in UI

REPLACES DE--

BOOT SCREEN--

systemd--

OS MODE

Completely replaces your desktop. Custom Plymouth boot, PAM login on TTY, glitch animation, dedicated Xorg session.

LAUNCHauto on boot

LOGINPAM on TTY1

REPLACES DEYES

BOOT SCREENPlymouth xkor

systemdxkor-login.service

// 02

FEATURES

MODULE_01

TERMINALS

Multiple real PTY shell instances via Rust PTY manager. Three simultaneous terminals. Actual bash, not emulated.

MODULE_02

SYSTEM GRAPHS

Live CPU, RAM, network, and temperature monitoring. Canvas rendering at 200ms refresh. Neon color-coded per metric.

MODULE_03

AI PANEL

Toggle with F2. Connects to any OpenAI-compatible API. Default: local Ollama with llama3. No cloud required.

MODULE_04

FILE MANAGER

Browse, rename, delete, copy and paste files. Right-click context menu. Opens files in the active terminal.

MODULE_05

3D GLOBE

Rotating world map with threat zone markers. 60fps canvas animation. No WebGL dependency.

MODULE_06

KEYBOARD VIZ

Full on-screen keyboard visualizer. Lights up physical keys as you type. Click to input directly.

// 03

INSTALLATION

$ git clone https://github.com/krko2n/xKOR_3RR0R
$ cd xKOR_3RR0R
$ bash run.sh
 
[  OK   ] npm install complete
[  OK   ] Rust backend built for xKOR_3RR0R
[  OK   ] launching xKOR_3RR0R...

run.sh installs Rust, builds the Tauri backend (cargo build --release), and starts the app via npm run dev.

# Arch / Manjaro / EndeavourOS only
 
$ git clone https://github.com/krko2n/xKOR_3RR0R
$ cd xKOR_3RR0R/os
$ sudo bash install.sh
$ sudo reboot
 
# On next boot xKOR_3RR0R will take over automatically

Installs to /opt/xkor_3rr0r · Enables xkor-login.service · Installs Plymouth theme

$ npm install
$ npm start
 
# if terminals show blank (rebuild Rust PTY)
$ bash os/rebuild.sh
$ npm start

F12 opens DevTools · F2 toggles AI panel · config/ holds credentials and AI endpoint

// 04

BOOT SEQUENCE

POWER ONsystem initialized

GRUBbootloader

KERNELlinux loads

PLYMOUTHxKOR boot animation plays

systemdxkor-login.service starts on TTY1

Conflicts=getty@tty1 · replaces normal login prompt

PAM authentication via pamtester

FAILprocess.exit(1) → service restarts → prompt again

OKloading.sh glitch animation ~4s

startxxkor-session.sh → Tauri fullscreen

READYACCESS GRANTED

// 05

TECH STACK

LAYER	TECHNOLOGY
App shell	Tauri v2 (Rust)
Real terminals	Rust PTY (nix crate)
Backend server	Express + WebSocket (ws) — port 3001
System monitoring	/proc/ + /sys/ direct reads
Terminal renderer	@xterm/xterm (integration in progress)
Frontend	Vanilla JS + custom CSS
PAM auth	pamtester (system binary — no native compilation)
Boot animation	Plymouth theme
Build	cargo build --release (Rust)
Language split	69% JS · 14% Shell · 12% CSS · 6% HTML

// 06

EMERGENCY RECOVERY

BLACK SCREEN AFTER INSTALL?

# switch to a working TTY
Ctrl + Alt + F2

# log in, then disable the service and restore your DM
sudo systemctl disable xkor-login.service
sudo systemctl enable --now sddm   # or gdm / lightdm
sudo reboot

# project files remain at /opt/xkor_3rr0r
# re-run sudo bash install.sh after fixing the issue