Skip to main content

icon

Real-Time Upscaler for Linux

PyPI version Python versions License: GPLv3

A real-time SRCNN upscaler for any X-Window (X11 or XWayland) on GNU/Linux. It uses CuNNy neural networks to perform 2x (or 4x) upscaling to full screen while preserving aspect ratio. Mouse clicks and motion are automatically forwarded to the original window.

Results at 400% magnification

Features

  • Neural-Network upscaling using SRCNNs trained for high-quality upscaling of visual novels and illustrations.
  • Model selection from 9 variants with variable quality/performance trade-offs.
  • Hardware accelerated using Vulkan compute.
  • Tile-Based processing that upscales only the frame regions that change, reducing GPU load for mostly static content.
  • Customizable output geometry: scaling mode (fit, stretch, cover), offset, crop and zoom.
  • Input forwarding as if interacting directly with the original window.

Requirements

  • OS: GNU/Linux
  • Display server: X11, or Wayland with XWayland
  • GPU: Vulkan-capable (NVIDIA, AMD, Intel)
  • Python: 3.10 or newer
  • Qt dependencies: see Dependencies

Installation

Install with pipx:

pipx install linux-rt-upscaler

For detailed installation instructions, including how to install pipx, see the Installation Guide.

After installation, the upscale and upscale-gui commands will be available globally. You can also create a desktop entry of the GUI for easy access.

Guides and Docs

Future plans

  • Broader model support. The upscaler currently uses CuNNy models. Alternative SRCNN architectures are welcome if one offers a clear quality/performance advantage.
  • Native Wayland upscaling (not planned: see Architecture Limitations)

Acknowledgments

This project stands on the shoulders of several open-source works, mantained by amazing people:

  • L65536, for the original RealTimeSuperResolutionScreenUpscalerforLinux, which demonstrated the feasibility of real-time SRCNN upscaling on Linux and served as a proof-of-concept for this project.
  • funnyplanter, for the incredible CuNNy neural network upscaling models.
  • Compushady, which served as an invaluable Vulkan foundation during early development.
  • PySide6, the Qt binding that powers the entire graphical interface and overlay window.
  • xcffib, the XCB binding used for window management, monitor querying and event forwarding.
  • Pillow, the Python Imaging Library, used for saving screenshots and rendering OSD messages.
  • PyYAML, the YAML parser used for configuration file operations.

Metadata

Release files for linux-rt-upscaler 1.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for linux-rt-upscaler 1.1.6
File Actions
linux_rt_upscaler-1.1.6-cp315-cp315-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl CPython 3.15 CPython 3.15 Linux glibc 2.28+ x86-64, Linux glibc 2.24+ x86-64 Details for linux_rt_upscaler-1.1.6-cp315-cp315-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
linux_rt_upscaler-1.1.6-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl CPython 3.14 CPython 3.14 Linux glibc 2.28+ x86-64, Linux glibc 2.24+ x86-64 Details for linux_rt_upscaler-1.1.6-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
linux_rt_upscaler-1.1.6-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.24+ x86-64, Linux glibc 2.28+ x86-64 Details for linux_rt_upscaler-1.1.6-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
linux_rt_upscaler-1.1.6-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.28+ x86-64, Linux glibc 2.24+ x86-64 Details for linux_rt_upscaler-1.1.6-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
linux_rt_upscaler-1.1.6-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.28+ x86-64, Linux glibc 2.24+ x86-64 Details for linux_rt_upscaler-1.1.6-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
linux_rt_upscaler-1.1.6-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl CPython 3.10 CPython 3.10 Linux glibc 2.28+ x86-64, Linux glibc 2.24+ x86-64 Details for linux_rt_upscaler-1.1.6-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl

Total release size: 29.1 MB

Release files / linux_rt_upscaler-1.1.6-cp315-cp315-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl

Download URL linux_rt_upscaler-1.1.6-cp315-cp315-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Size 4.9 MB
Tags CPython 3.15 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
8fa22414efbae76c8f90923d762d16fb588cb963a398bf616de336d7784ba145
BLAKE2b-256 checksum
How to use checksums
61ec84121107f1c7dfbf6d8d3a24e1dd934556251e7ba41d314b1489a4858984
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / linux_rt_upscaler-1.1.6-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl

Download URL linux_rt_upscaler-1.1.6-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Size 4.9 MB
Tags CPython 3.14 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
bb7330d684cfc0c2c44f7a7f3b0681618329822c40a5329cf1ae775c7db1d91b
BLAKE2b-256 checksum
How to use checksums
69841e6aa0aad0f95bbfeea846b27299df09195772a62252070e4ca70c6a8fb8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / linux_rt_upscaler-1.1.6-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl

Download URL linux_rt_upscaler-1.1.6-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Size 4.9 MB
Tags CPython 3.13 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
0faca2fcf06e2fee72593c9a5e65abb1a41db2c35e9a3196e5244542fa6976f1
BLAKE2b-256 checksum
How to use checksums
c53a890db40b53e12ef169f8bcc6590205abdd0bbcc8ac0ff5a3c6607161f23a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / linux_rt_upscaler-1.1.6-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl

Download URL linux_rt_upscaler-1.1.6-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Size 4.9 MB
Tags CPython 3.12 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
fb7906e4fc3bf7544486b9e69279dce6a553f7e20e500681f6b41348993fd99c
BLAKE2b-256 checksum
How to use checksums
c197d607d365dfbf50635e7e2e0f5f83b41300b5856a30733d3543083fbeaedd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / linux_rt_upscaler-1.1.6-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl

Download URL linux_rt_upscaler-1.1.6-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Size 4.9 MB
Tags CPython 3.11 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
7b1ce06799e35dc1aac8ed7d440aaeeb0a86e2adba1103b187c37fa282d2dd0b
BLAKE2b-256 checksum
How to use checksums
4ce0d3cbc60878c93d2eea43ce626aada6acdcaad6722f11bfaded0c2fbfd64f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / linux_rt_upscaler-1.1.6-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl

Download URL linux_rt_upscaler-1.1.6-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Size 4.9 MB
Tags CPython 3.10 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
262869d43005a2cfaffff71725ef02df566bfc8df668f992469e08a13123e3ce
BLAKE2b-256 checksum
How to use checksums
d1eda009cf4d408e87860aad3f5b39c84969a40b82e7f2aa76857e7665df26ba
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for linux-rt-upscaler 1.1.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for linux_rt_upscaler-1.1.6-cp315-cp315-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.1.6 This release

6 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page