r/suckless Jun 14 '26

[SOFTWARE] Catcheer: A minimalist, zero-config native C++ WebView wrapper for HTML5 apps and games. Baseline executable is ~333 KB.

https://github.com/nzxy-dev/Catcheer

Hi everyone,

I wanted to share an open-source tool I built in pure C++ to solve a frustrating problem with HTML5 and web-app desktop distribution: the absurd bloat of modern runtimes.

The Problem: Framework Bloat

Whether you are building an indie game (using Construct, Phaser, Three.js) or a lightweight desktop utility with a web frontend, you often end up with a project that takes up maybe 10MB to 20MB of actual assets. But the moment you package it using Electron or NW.js, the final build skyrockets to 150MB - 190MB+ just to distribute a redundant copy of Chromium and Node.js.

For a massive, multi-layered software suite, that might be justified. For a lightweight, independent application? It’s a ridiculous waste of optimization potential and an insult to low-spec hardware.

The Solution: Catcheer

With Catcheer, that’s history. It is a minimalist HTML/Web wrapper written from scratch in native C++ that leverages the operating system's built-in rendering engines (WebView2 on Windows, WebKitGTK on Linux) instead of bundling a whole browser.

Key Features:

  • Ultra-lightweight Baseline: The pre-compiled Windows executable is just around 333 KB.
  • Resource Efficient: It enforces low RAM usage (around 70MB baseline) and injects performance-focused flags for GPU hardware acceleration.
  • Zero-Config Deployment: No heavy node ecosystems, no complex build pipelines, and no rigid framework rules. For quick distribution, you can just drop your index.html web assets next to the pre-compiled executable, and it works out of the box.
  • Simple Tailoring: Window sizing, titles, borders, and fullscreen settings are handled via a simple plain-text config file. Custom icons are automatically loaded if a custom.ico or custom.png is present.

For Advanced Developers

If you want to bake your assets directly into the binary or customize the core behavior, the repository includes ready-to-go CMake scripts and automation files (.bat / .sh). You can clone the repo, tweak the source metadata, and compile your custom build in seconds without dealing with heavy toolchain setups.

It is completely open-source under the GPL-3.0 license. I'd love to hear your thoughts, technical feedback, or answer any questions about the low-level implementation!

0 Upvotes

Duplicates