Skip to content
TheHolyOneZPublic

About

Every ZSync tool, one launcher: browse, install and update every zsync.eu tool with one click. Windows, Linux, macOS. Tauri v2 + Rust + React.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

ZLauncher

Every ZSync tool. One launcher.

Browse the whole zsync.eu catalogue, install any tool with one click (the right file for your system, installed the way your system expects) and keep everything up to date. Or just ask the built-in assistant for what you need.

Homepage & downloads · All ZSync tools · Windows · Linux · macOS · GPL-3.0

ZLauncher's Discover page

What it does

  • The whole catalogue. Every tool from zsync.eu, live from the site: search, filter by system and category, favorites, promo videos.
  • Finds the right download. Each tool's homepage, release manifests, checksum lists and GitHub releases are read to find its installers, and the one for your system and processor is picked.
  • Installs properly.
    • Windows: the tool's own setup runs silently, or its .msi.
    • macOS: the .dmg is opened and the app copied to Applications.
    • Linux: a native .deb or .rpm where the distro takes it; on Arch and friends, a real pacman package converted from the .deb; AppImages everywhere. Menu entries and optional desktop shortcuts come with it.
  • Updates. New versions show up in the Library with their release notes. You can update one tool or all of them, and get notifications.
  • Checked downloads. Downloads are resumable and checked against SHA-256 checksums before anything is installed.
  • Finds existing installs. Tools installed before by hand are found in the system's package database, registry or Applications folder.
  • Build from source. Tauri tools can be cloned from GitHub and built locally, with a check of what the system needs first.
  • Updates itself. The launcher's own updates are downloaded in the background and installed on restart. They are signed, and the signature is checked first.

A tool's page in ZLauncher

The assistant

Describe what you need ("something to test how fast I type", "are there updates for my tools?") and the assistant finds the right tool, explains it and does the rest.

  • Searches the catalogue in your own words, typos included, and answers with cards for the tools it means.
  • Acts for you: installs, downloads, builds from source, updates one tool or everything, opens a tool, or uninstalls it after you confirm.
  • Reads the source: a tool's GitHub README (outline first, then the section it needs), regular-expression search inside it, and the repository's stars, license, releases and issues.
  • Knows your system (OS, processor, Linux install format, what's installed, what has updates) and knows ZSync and its developer.
  • Thinks out loud with models that reason: the thinking and every tool call stream into the chat as they happen. Thinking can be turned off.
  • Your model, your choice: Ollama by default, fully local: the chat never leaves your computer. Or OpenAI, Anthropic, Gemini, or any OpenAI-compatible server (LM Studio, llama.cpp, …) with your own key. Keys are stored only on your computer and sent only to that provider.

The ZLauncher assistant answering a request for a typing test, with its thinking, its tool calls and a card to build the tool

Install

Download it from zsync.eu/zlauncher: an .exe or .msi for Windows, an AppImage, .deb or .rpm for Linux, a .dmg for macOS (Apple Silicon or Intel).

Building

You need Node 20+, pnpm, stable Rust and Tauri's system dependencies. On Linux the promo videos also need the GStreamer plugins (gst-plugins-good, gst-libav).

pnpm install
pnpm dev            # run the launcher in development mode
pnpm build          # build installers for this system
pnpm typecheck      # TypeScript + the CSS rules check
pnpm test           # Rust tests
pnpm lint:rs        # clippy, warnings as errors

Layout

Path What's in it
apps/desktop The Tauri v2 app: React 19 + Tailwind 4 UI in src/, the Rust side in src-tauri/ (the assistant is src-tauri/src/assistant.rs)
crates/zl-catalog The tool list (projects.php) and promo videos
crates/zl-crawler Finds each tool's release files on its homepage (overrides in overrides.toml)
crates/zl-download Resumable downloads with SHA-256 checks
crates/zl-install Installing, updating, launching and removing, per system; detection of existing installs
crates/zl-build Building a tool from its GitHub source
crates/zl-store The local SQLite database

Releasing

The Release ZLauncher workflow (Actions, started by hand) builds every installer plus the signed update files and puts them into a draft release. They are published on zsync.eu/zlauncher, and installed launchers update themselves from there.

Before a release, raise the version (root Cargo.toml, package.json, apps/desktop/package.json, tauri.conf.json) and add its section to CHANGELOG.md. That section becomes the release notes; its first paragraph is the update notice inside the launcher.

It needs these repository secrets:

Secret What it is
TAURI_SIGNING_PRIVATE_KEY The updater signing key; its public half is in tauri.conf.json.
TAURI_SIGNING_PRIVATE_KEY_PASSWORD The key's password.
ZL_GITHUB_CLIENT_ID Optional: a GitHub OAuth app's client ID for "Sign in with GitHub".

License

ZLauncher is free software: GNU General Public License v3.0 or later, © 2026 TheHolyOneZ. See LICENSE. The Linux install engine is based on ZLynstall. Each tool the launcher installs has its own license.

About

Every ZSync tool, one launcher: browse, install and update every zsync.eu tool with one click. Windows, Linux, macOS. Tauri v2 + Rust + React.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages