HAL 9000
WINDOWS WORKSTATION REMOTE CONTROLLER

"Good afternoon, Dave.
All systems in your PC are running perfectly."

A secure Windows Remote Management Bot built in Python 3.13. Operate your desktop securely from your smartphone over Telegram messages: browse files, schedule sleep timers, switch multi-monitor setups, start web servers, capture webcam frames, and synchronize clipboards—from anywhere.

<20ms
DISPATCH LATENCY
5 ROOTS
SANDBOXED STORAGE
35+
TELEGRAM COMMANDS
100%
ADMIN ISOLATION
⚡ TEST LIVE TERMINAL EXPLORE 10 SUBSYSTEMS ↓
REAL-TIME SIMULATION CONSOLE

INTERACTIVE TELEGRAM BOT TERMINAL

Tap a preset command below or type directly into the terminal to test bot responses.

HAL_CORE // TELEGRAM_ADMIN [PID: 9000]
TLS 1.3 / BOT API
QUICK ROUTINES:
HAL9000> HEURISTIC BOOT COMPLETE. MEMORY BANKS VERIFIED.
HAL9000> SECURE LINK ACTIVE. TAP A QUICK ROUTINE ABOVE OR TYPE /help.
ADMIN>
CAPABILITIES OVERVIEW

INTEGRATED CONTROL SUBSYSTEMS

Ten modular operational units engineered for complete control over your Windows workstation.

MOD-01 ● ACTIVE
🗂️

Sandboxed File Explorer

/browse • /explorer • /folders

Visual remote directory browser restricted to designated folders for uncompromising security. Inspect file sizes, timestamps, and navigate with 6-item pagination.

  • Assigned Roots: Documents, Downloads, Books, Study, Sharing
  • Containment Check: Strict parent-folder boundary enforcement
  • 1-Tap Actions: Send to Telegram (≤50MB), Open on PC, Reveal in Explorer
  • UUID Mapping: Bypasses Telegram 64-byte callback limit
MOD-02 ● ACTIVE
📁

Telegram ⇄ PC File Transfer

/files • /getfile • /recent

Drop any document, picture, or video directly into Telegram. HAL saves it instantly to Downloads/HAL_Received with smart collision avoidance.

  • Inbound Drop: Immediate background file write with action cards
  • Outbound Upload: Automatic search across Downloads & custom paths
  • Oversized Alert: Direct Copy Party fallback recommendation for >50MB
MOD-03 ● ACTIVE
🖥️

Multi-Monitor Display Topology

/monitor • /extend • /display_off

Switch multi-monitor configurations on the fly via Windows Display Switch APIs. Toggle secondary screens, switch to laptop-only mode, or blank screens instantly.

  • Topology Modes: Extend, Internal (Laptop), External Only, Clone
  • 1-Tap Toggle: Single button toggles secondary monitor state
  • Stealth Mode: /display_off puts displays immediately into standby
MOD-04 ● ACTIVE
📸

Optical Telemetry & Webcam

/screenshot • /cam • /webcam

Inspect your desktop workspace or physical surroundings in real-time. High-resolution multi-monitor screenshot selector and silent webcam snapshot capture.

  • Display Picker: Choose Monitor 1, Monitor 2, or Combined canvas
  • Webcam Hardware: Direct DirectShow / MSMF video stream capture
  • Memory Cleanup: Temporary frames are purged immediately post-upload
MOD-05 ● ACTIVE
⚡

Unified Power Controls & Timers

/power • /sleep_in • /cancel_timer

Complete power management with failsafe guards. Sleep, Restart, or Shutdown immediately or schedule countdown timers with remaining-time banners and instant abort buttons.

  • Grace Window: 10-second cancellation window before shutdown executes
  • Precision Timers: Presets (15m, 30m, 1h, 2h) or custom minutes (/sleep_in 45)
  • Status Banner: Active countdowns displayed in real-time across menus
MOD-06 ● ACTIVE
🌐

Web Servers & Cloudflare Tunnel

/web • /web_start • /web_stop

Manage local web servers inside dedicated Windows Terminal tabs (wt.exe). Intelligent Cloudflare Tunnel lifecycle tracks active server dependencies.

  • Individual Control: Root Server (8000) & Test Server (8001)
  • Smart Tunnel: Auto-launches tunnel with servers; shuts down when offline
  • Jellyfin Awareness: Keeps tunnel online if Jellyfin is running
MOD-07 ● ACTIVE
🎉

Copy Party High-Speed File Hub

/copyparty • /start_cp • /cp_status

Dedicated control over Copy Party media and file server. Enables high-speed LAN/WAN browser-based file uploads and streaming without Telegram size restrictions.

  • Custom Config: python -m copyparty -c "copyparty.conf"
  • Status Verifier: Socket probing on port 3923 + process PID tracking
  • Clean Shutdown: Force-kills background instances and frees socket buffers
MOD-08 ● ACTIVE
📱

Process & App Controller

/apps • /start <app> • /kill <pid>

Inspect active Windows desktop processes and memory footprints. Launch registered software, stop services, or terminate rogue tasks by PID or executable name.

  • Direct Execution: Registered presets (Chrome, Jellyfin, Media players)
  • Process Killing: Win32 process handle termination with admin checks
  • Memory Auditing: Per-process RAM utilization diagnostics
MOD-09 ● ACTIVE
📋

Universal Clipboard Sync

/clip • /copy <text> • Auto-URL

Seamlessly bridge text between your mobile smartphone and PC desktop. Read current Windows clipboard contents or inject text and links with zero friction.

  • Auto-URL Interception: Send any HTTP link in chat; it is instantly copied to PC
  • Win32 Clipboard API: Direct global memory lock via user32.dll
  • Zero Logging: In-memory transfer with zero persistent logging
MOD-10 ● ACTIVE
🎬

Jellyfin Media Suite

/jellyfin_start • /jellyfin_stop

Independent lifecycle control for Jellyfin Media Server via dedicated batch runners. Decoupled from web tunnels for maximum autonomy and bandwidth efficiency.

  • Batch Automation: Triggers start-jellyfin.bat / stop-jellyfin.bat
  • Tunnel Integration: Tunnel remains persistent if Jellyfin is streaming
  • Port Probing: Real-time listening check on port 8096
DEFENSE PROTOCOLS

FORTIFIED ADMIN ARCHITECTURE

Because HAL 9000 exercises direct system control over Windows, every inbound Telegram update undergoes verification gates before execution.

🔒
STRICT TELEGRAM USER ID WHITELIST

All updates from unauthorized user IDs trigger immediate blockage and intrusion alert logs.

🛡️
STRICT FILE PATH SANDBOXING

Exploration and file deletion are mechanically constrained to designated root directories.

⏳
DESTRUCTIVE ACTION MODALS

Shutdown, restart, and file deletion require double-confirmation modals to prevent misclicks.

🔑
CREDENTIAL SEGREGATION

Protected via .env file isolation; zero token exposure in terminal logs or repo.

REMOTE TRANSMITTER TELEGRAM MOBILE CLIENT
▼ TLS 1.3 / BOT API ENCRYPTED
GATEKEEPER @ADMIN_ONLY DECORATOR & AUTH CHECK
▼ AUTHORIZED TRANSACTION
HEURISTIC CORE HAL 9000 ENGINE (PYTHON 3.13)
▼ WIN32 API / PROCESS DISPATCH
HOST OPERATING SYSTEM WINDOWS 10/11 WORKSTATION SUBSYSTEMS
COMMAND DIRECTORY

COMMAND REFERENCE & SHORTCUTS

Search or filter through all native HAL Bot commands. Tap any command code or copy button to copy.

32 COMMANDS
/browse FILES

Launch interactive File Explorer across assigned folders

/explorer FILES

Alias for interactive File Explorer

/files FILES

Open File Transfer Control Center

/getfile <path> FILES

Download file from PC to Telegram phone (≤50MB)

/recent FILES

Browse recent downloads with 1-tap fetch buttons

/downloads FILES

Alias for recent downloads list

/power POWER

Open interactive Power Menu (Sleep / Restart / Shutdown)

/sleep POWER

Immediate Sleep or select timer presets

/sleep_in <mins> POWER

Schedule PC to sleep in N minutes (e.g. /sleep_in 30)

/restart POWER

Reboot PC with 10s countdown grace window

/restart_in <mins> POWER

Schedule PC to restart in N minutes

/shutdown POWER

Shutdown PC with 10s countdown grace window

/shutdown_in <mins> POWER

Schedule PC to shutdown in N minutes

/cancel_timer POWER

Abort active scheduled power countdown

/monitor DISPLAY

Open interactive Display Topology and Screen menu

/extend DISPLAY

Extend Windows desktop across both displays

/internal DISPLAY

Use Laptop screen only (disconnect external)

/external DISPLAY

Use External screen only (turn off laptop display)

/display_off DISPLAY

Put monitors into sleep mode immediately

/screenshot DISPLAY

Capture screen with interactive monitor picker

/cam DISPLAY

Capture live snapshot from PC webcam

/web SERVERS

Open Web Servers dashboard with live port status

/web_start SERVERS

Start web servers + Cloudflare Tunnel in Windows Terminal

/web_stop SERVERS

Stop all running local web servers

/copyparty SERVERS

Copy Party file server control panel & port 3923 check

/jellyfin_start SERVERS

Start Jellyfin Media Server standalone

/jellyfin_stop SERVERS

Stop Jellyfin Media Server

/status SYSTEM

Display live CPU, RAM, Disk, Uptime & Battery metrics

/apps SYSTEM

View active running processes and memory allocation

/clip SYSTEM

Read current contents of Windows clipboard

/copy <text> SYSTEM

Inject text directly into Windows clipboard

/lock SYSTEM

Lock Windows workstation session