linux-rt-upscaler 0.1.0

Real-time AI upscaler for any Linux window using CuNNy

Real‑Time Upscaler for Linux

A real‑time AI upscaler for any application window on GNU/Linux. Uses CuNNy‑veryfast neural networks to perform 2× upscaling, with full‑screen stretching and optional click/motion forwarding.

Based on

Based on RealTimeSuperResolutionScreenUpscalerforLinux by L65536, with the following differences:

• Full‑screen scaling – The upscaled image now fills the monitor, applying a second scaling layer while preserving aspect ratio.
• Click/motion forwarding – With the -m flag, mouse clicks and motion are forwarded to the original window with proper coordinate transformation.

Features

• AI‑Powered Upscaling – Uses CuNNy‑veryfast (4‑pass) neural network for high‑quality 2× upscaling.
• Any Window – Attach to an existing window or launch a new program.
• Full‑Screen Output – Stretch the upscaled image to fill your monitor (aspect‑ratio preserved, black bars).
• Click/Motion Forwarding (-m) – Click and move the mouse on the upscaled image as if it were the real window.
• Opacity Control – Overlay dims when mouse leaves the source window (optional, disabled with -m).
• Hardware Accelerated – GPU‑based compute via Compushady (Vulkan/Direct3D 12).
• Low Overhead – Minimal performance impact; scaling pass uses hardware bilinear filtering.

Requirements

• GNU/Linux with X11 (Wayland not supported)
• Vulkan-capable GPU from any vendor (NVIDIA, AMD, Intel)
• Vulkan drivers (libvulkan-dev on Debian/Ubuntu)
• X11 development libraries (libx11-dev)
• Python 3.8 or newer

Installation

1. Clone the repository

   git clone https://github.com/baronsmv/linux-rt-upscaler.git
   cd linux-rt-upscaler
   

2. Install system dependencies (Debian/Ubuntu)

   sudo apt install libvulkan-dev libx11-dev
   

3. Install Python packages

   pip install -r requirements.txt
   

Usage

# Upscale the currently active window
python main.py

# Enable click/motion forwarding (mouse interacts with upscaled window)
python main.py -m

Acknowledgments

• L65536 – For the RealTimeSuperResolutionScreenUpscalerforLinux project, which provided the foundational scripts and CuNNy integration that this project builds upon
• CuNNy – Neural network upscaling models
• Compushady – Python GPU compute library
• PySide6 – Qt bindings for the overlay
• python‑xlib – X11 client library