git404hub

what is compressor fr?

sonnylazuardi/compressor — explained in plain English

Analysis updated 2026-05-18

10ZigAudience · developerComplexity · 3/5Setup · moderate

tl;dr

Compressor is a fully native macOS and Windows desktop app, built with Zig and a Native SDK instead of a WebView or browser UI, that converts images to WebP with an adjustable quality slider.

vibe map

mindmap
  root((compressor))
    What it does
      Convert images to WebP
      Quality slider
      Compression presets
      Native desktop UI
    Tech stack
      Zig
      Bun
      Native SDK
    Use cases
      Shrink photos for web
      Batch image compression
      Native app example
    Platforms
      macOS
      Windows
      No Linux or WSL support

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Shrink photo file sizes by converting them to WebP before uploading them to a website or sharing them.

VIBE 2

Batch-reduce image sizes for a project using preset compression levels instead of manually tuning quality each time.

VIBE 3

Study a real example of building a genuinely native desktop app in Zig without a WebView or browser-based UI.

what's the stack?

ZigBunNative SDK

how it stacks up fr

sonnylazuardi/compressoral3rez/zehnata-sesli/zova
Stars10154
LanguageZigZigZig
Setup difficultymoderatemoderatehard
Complexity3/52/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Zig 0.16, Bun 1.4+, Node.js, and the Native SDK CLI, must be built from a native shell, not WSL.

No license information found in the README.

in plain english

Compressor is a desktop app for shrinking image file sizes by converting them to the WebP format. What sets it apart from most desktop apps is how it is built: there is no WebView, no React, and no browser-based interface underneath. The whole app is written using a native UI toolkit and the Zig programming language, so it runs as a genuinely native window on macOS and Windows rather than a web page wrapped in a desktop shell. Using the app is simple. A person browses for an image through the platform's normal file dialog, or drags one onto the window, and the app converts it to WebP. A quality slider in settings controls the compression level, defaulting to 80 percent, with quick presets for light, medium, and heavy compression. Keyboard shortcuts are provided for opening settings, browsing for a file, and running the compression, and they follow each platform's own conventions. Under the hood, the actual image encoding is handled by Bun, a JavaScript runtime, which converts the image to WebP at the chosen quality. The rest of the app, including its window, UI, and application logic, is built with a tool called the Native SDK, which lets developers write native desktop apps declaratively instead of hand-coding platform-specific interface code. Building the project from source requires Zig version 0.16, Bun 1.4 or newer, Node.js, and the Native SDK's command line tool, and it must be run from a native shell on each platform: Terminal on macOS or PowerShell on Windows, not a Linux-style shell like WSL, since the Linux build path expects different graphics libraries that this project does not target. Prebuilt releases for macOS and Windows are published through GitHub Releases, built automatically by a continuous integration workflow whenever a new version is tagged.

prompts (copy fr)

prompt 1
Walk me through setting up the Compressor app's build environment on Windows using PowerShell.
prompt 2
Explain how Compressor uses Bun to encode images to WebP instead of doing it in Zig directly.
prompt 3
Show me how to run the Compressor project's headless unit tests with the native CLI.
prompt 4
How does the release workflow build and publish macOS and Windows packages when a version tag is pushed?

Frequently asked questions

what is compressor fr?

Compressor is a fully native macOS and Windows desktop app, built with Zig and a Native SDK instead of a WebView or browser UI, that converts images to WebP with an adjustable quality slider.

What language is compressor written in?

Mainly Zig. The stack also includes Zig, Bun, Native SDK.

What license does compressor use?

No license information found in the README.

How hard is compressor to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is compressor for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.