Omega GPU Worker & Headless CLI

English Documentation • Deutsche Dokumentation

Contents / Inhalt

English	Deutsch
English Documentation	Deutsche Dokumentation
Core Features	Hauptfunktionen
Source-Only Trust Model	Source-Only Vertrauensmodell
Tech Stack & Architecture	Technologie & Architektur
Installation & Development	Installation & Entwicklung
Configuration	Konfiguration
Support the Project	Projekt unterstützen

EN English Documentation

A high-performance, cross-platform GPU encoding client and headless worker CLI for the Omega Downloader Bot and Omega Loader Bot.

The Omega GPU Worker acts as a background processing agent that connects to your VPS backend, fetches pending video and media conversion jobs, transccodes them locally utilizing your hardware-accelerated graphics processing unit (GPU), and securely uploads the processed media back to the bot.

🌟 Core Features

1. Dual Mode Operation

Desktop App: Premium user interface built with Tauri 2 and HTML/CSS/JS, featuring a native system tray, real-time status cards, manual hardware encoder selection, and live terminal logs.
Headless CLI: A minimalist, low-footprint Rust daemon (omega-worker-cli) tailored for background servers, headless environments, or headless system startup.

2. Auto-Detecting Hardware Acceleration

Optimized for ultra-fast transcode speeds with modern video codecs:

NVIDIA: h264_nvenc (NVENC)
AMD: h264_amf (AMF)
Apple Silicon: h264_videotoolbox
CPU Fallback: libx264 (standard software encoding)

3. Smart Stream Processing & Fragmented Uploads

Real-time Streaming: Directly streams, downsamples, and encodes media on-the-fly, returning progress metrics to the VPS.
Multipart Chunked Uploads: Automatically handles chunked file uploads directly to the VPS backend with dynamic manifest generation for extreme network stability.

🔒 Source-Only Trust Model (Security)

Since the worker receives and processes highly sensitive session cookies for protected media sites (like YouTube, Instagram, and X/Twitter) in real time:

Absolute Transparency: No pre-compiled binaries are provided for third-party operators. Every GPU host is explicitly encouraged to review the code and compile it locally.
RAM-Only Cookie Life: Received cookie payloads are held strictly in transient process memory (RAM). They are temporarily written to a highly restricted, protected file only during a yt-dlp execution and are permanently shredded immediately after the job completes.
Log Sanitization: The log engine automatically filters and redacts all auth headers, session cookies, and credentials from any debug log output.
Tailscale Encryption: All network traffic between the local GPU Worker and the VPS is securely routed over a private Tailscale network (Tailnet) using end-to-end encryption.

🛠️ Tech Stack & Architecture

graph TD
    A[Tauri App / CLI Daemon] -->|Secure Tailnet HTTPS| B[VPS Backend Bot]
    A -->|Hardware Auto-Detect| C[Local GPU / NVENC / AMF]
    A -->|Local System APIs| D[yt-dlp & FFmpeg Transcoder]
    D -->|RAM-Only Sessions| E[Temporary Secure Cookies]
    A -->|Chunked Multipart| F[ VPS File Storage ]

Frontend: Vanilla HTML, CSS, JavaScript (lightweight, zero-bloat).
Backend: Tauri 2, Rust (native OS bindings, system tray, daemon core).
Processing Engines: yt-dlp (stream capturing), FFmpeg (hardware-accelerated transcoding).

🚀 Installation & Development

Prerequisites

Node.js (v20 or higher)
Rust & Cargo compilation environment

1. Build the Desktop App (Tauri)

# Install dependencies
npm install

# Run in development mode
npm run tauri dev

# Compile production package (EXE / MSI)
npm run tauri build

2. Build the Headless CLI

cd src-tauri

# Compile the standalone daemon
cargo build --bin omega-worker-cli --release

The compiled binary will be located at src-tauri/target/release/omega-worker-cli.

⚙️ Configuration

Desktop App (Pairing)

Launch the Desktop App.
Navigate to the "GPU Worker" tab in your Bot's Admin Web Interface.
Click "Pair New Worker" and copy the VPS URL and the generated Pairing Token into the app.
Once paired, the app securely persists the authorization token locally and reconnects automatically.

Headless CLI (Environment Variables)

The CLI daemon is controlled exclusively through environment variables:

OMEGA_WORKER_TOKEN (Required): Your permanent worker authentication token.
OMEGA_VPS_URL (Optional): The base URL of your VPS (Default: http://localhost:5000).
OMEGA_POLL_INTERVAL (Optional): Job polling interval in seconds (Default: 10).

Example startup:

OMEGA_WORKER_TOKEN="your_secure_auth_token" OMEGA_VPS_URL="https://vps.yourserver.com" ./omega-worker-cli

❤️ Support the Project

Omega GPU Worker is open-source software under the GPL-3.0 license. If you find this software helpful, feel free to support our development:

👉 Support us on PayPal

DE Deutsche Dokumentation

Ein extrem performanter, plattformübergreifender GPU-Transcodierungs-Client und Headless-Daemon CLI für den Omega Downloader Bot und Omega Loader Bot.

Der Omega GPU Worker klinkt sich als Hintergrund-Dienst ein, fragt anstehende Video- und Medienkonvertierungsjobs beim VPS-Backend ab, verarbeitet diese lokal unter voller Ausnutzung deiner Hardware-Beschleunigung (GPU) und lädt die fertigen Videodateien sicher wieder hoch.

🌟 Hauptfunktionen

1. Zwei Betriebsmodi

Desktop-App: Premium-Benutzeroberfläche (Tauri 2, HTML/CSS/JS) inklusive nativem System-Tray (Infobereich), Echtzeit-Statuskarten, manueller Encoder-Auswahl und Terminal-Logs.
Headless CLI: Ein minimalistischer, ressourcenschonender Daemon (omega-worker-cli) für Server oder Headless-Maschinen.

2. Hardware-Beschleunigung mit Auto-Detection

Maximale Transcodierungs-Geschwindigkeiten durch direkte Ansteuerung deiner Grafikkarte:

NVIDIA: h264_nvenc (NVENC)
AMD: h264_amf (AMF)
Apple Silicon: h264_videotoolbox
CPU Fallback: libx264 (Standard Software-Encoding)

3. Intelligentes Streaming & Multipart-Uploads

Echtzeit-Streaming: Direktes Herunterladen, Skalieren und Encodieren im Stream mit Live-Fortschrittsmeldung an das Backend.
Multipart-Uploads: Zuverlässige Uploads großer Mediendateien in Fragmenten direkt an das VPS-Backend mit automatischer Manifest-Generierung.

🔒 Source-Only Vertrauensmodell (Sicherheit)

Da der Worker sensible Cookie-Bundles für geschützte Medienplattformen (wie Instagram, YouTube oder X/Twitter) empfängt und temporär im RAM hält:

Vollständige Transparenz: Es werden keine vorkompilierten Binaries für Fremdnutzer bereitgestellt. Jeder GPU-Host wird explizit ermutigt, den Code zu prüfen und lokal selbst zu bauen.
RAM-only Session-Schutz: Empfangene Cookies werden ausschließlich im flüchtigen Prozessspeicher (RAM) gehalten. Sie werden nur für die Laufzeit eines yt-dlp-Aufrufs in eine geschützte temporäre Datei geschrieben und unmittelbar danach unwiderruflich gelöscht.
Log-Schutz: Das Log-System filtert automatisch alle sensiblen Authentifizierungs-Header, Passwörter und Cookies heraus, damit diese niemals in den Logs auftauchen.
Tailscale-Verschlüsselung: Die gesamte API-Kommunikation und Datenübertragung zwischen dem Worker und dem VPS erfolgt vorzugsweise über ein privates Tailscale-Netzwerk (Tailnet) via HTTPS.

🛠️ Technologie & Architektur

graph TD
    A[Tauri App / CLI Daemon] -->|Sicheres Tailnet HTTPS| B[VPS Backend Bot]
    A -->|Hardware Auto-Detect| C[Lokale GPU / NVENC / AMF]
    A -->|Lokale System-APIs| D[yt-dlp & FFmpeg Transcoder]
    D -->|RAM-only Sessions| E[Temporäre sichere Cookies]
    A -->|Chunked Multipart| F[ VPS Dateispeicher ]

Frontend: Vanilla HTML, CSS, JavaScript (minimalistisch, ohne Framework-Ballast).
Backend: Tauri 2, Rust (native System-Schnittstellen, Tray-Menü, Daemon-Kern).
Verarbeitungs-Engines: yt-dlp (Stream-Erfassung), FFmpeg (hardwarebeschleunigtes Encodieren).

🚀 Installation & Entwicklung

Voraussetzungen

Node.js (v20 oder höher)
Rust & Cargo Entwicklungsumgebung

1. Desktop-App (Tauri) bauen

# Abhängigkeiten installieren
npm install

# App im Entwicklungsmodus starten
npm run tauri dev

# Produktions-Build erzeugen (EXE / MSI)
npm run tauri build

2. Headless CLI (Server-Dienst) bauen

cd src-tauri

# CLI-Binary kompilieren
cargo build --bin omega-worker-cli --release

Das fertige CLI-Binary liegt anschließend unter src-tauri/target/release/omega-worker-cli.

⚙️ Konfiguration

Desktop-App (Kopplung)

Starte die Desktop-App.
Navigiere im Admin-Webinterface deines Bots auf den Reiter "GPU Worker" und klicke auf "Neuen Worker koppeln".
Kopiere die VPS-URL und den Pairing Code (Token) in die Einstellungen der Desktop-App.
Nach erfolgreichem Pairing speichert die App das Token lokal ab und verbindet sich beim Start automatisch wieder.

Headless CLI (Umgebungsvariablen)

Der CLI-Worker benötigt kein grafisches Interface und wird direkt über Umgebungsvariablen gesteuert:

OMEGA_WORKER_TOKEN (Erforderlich): Das generierte dauerhafte Worker-Token.
OMEGA_VPS_URL (Optional): Die Basis-URL deines VPS (Standard: http://localhost:5000).
OMEGA_POLL_INTERVAL (Optional): Abfrage-Intervall für neue Jobs in Sekunden (Standard: 10).

Beispiel-Start unter Linux:

OMEGA_WORKER_TOKEN="dein_sicheres_worker_token" OMEGA_VPS_URL="https://vps.dein-server.de" ./omega-worker-cli

❤️ Projekt unterstützen

Der Omega GPU Worker ist freie Open-Source-Software unter der GPL-3.0 Lizenz. Wenn dir die Software gefällt, freuen wir uns über einen Kaffee via PayPal:

👉 Unterstütze uns auf PayPal

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
.vscode		.vscode
docs		docs
src-cli		src-cli
src-relay		src-relay
src-tauri		src-tauri
src		src
updater		updater
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json

Latest commit

History

Folders and files

Repository files navigation