Skip to content

Files

Latest commit

c2d973a · May 24, 2025

History

History
187 lines (122 loc) · 10.1 KB

readme-en.md

File metadata and controls

187 lines (122 loc) · 10.1 KB

zerolaunch-rs

Gitee star Gitee fork GitHub stars GitHub forks GitCode stars

Platform GPLv3 License Ask DeepWiki

GiteeGitHubGitCode

📕 Brief Introduction

ZeroLaunch is an application launcher meticulously crafted for the Windows platform, helping you instantly find and launch desired applications for the ultimate in efficiency and speed!

Currently, the existing program launchers on the market don't quite meet my needs, so I developed this software. I use it daily, so there's no need to worry about me abandoning it (at most, there might be no new updates (~ ̄▽ ̄)~).

🖥️ Software Interface

Main Interface Preview

Click the image to view the complete set of feature screenshots

Customizable background image

✨ Why choose ZeroLaunch-rs / What makes ZeroLaunch-rs unique?

🔒 Privacy First

Runs completely offline, no internet connection required. Your data always stays on your device. Adhering to a zero data collection policy, strictly following local processing to ensure your information security.

⚡ Efficient Smart Search

Thanks to the optimization of a unique search algorithm, the program boasts excellent spell correction capabilities based on triple matching technology (full name/Pinyin/initials). The program supports mixed Chinese and English queries, combined with a real-time dynamic sorting algorithm and multi-threaded concurrent processing technology, achieving millisecond-level response speeds even on lower-spec devices.

🌐 Lightweight and Pure

Focused solely on application search and launch functions, achieving highly specialized application search. Undisturbed by other complex features, ready to use out of the box – that's how pure it is.

🔬 Software Features

Core Features

  • Application Search: Quickly retrieve and launch applications and UWP apps, providing a smooth program access experience.
  • Application Wake-up: Intelligently identifies and brings already open windows to the foreground, enabling convenient multi-task switching.
  • Customizable Interface: Highly customizable appearance, supporting custom background images, option colors, search font color and size, display font color and size, number of candidates displayed, frosted glass effect, rounded corner size settings, program width and height, and many other items, with convenient interaction buttons for each.
  • Open File Location: In the right-click menu, you can open the folder where the target file is located.

More Practical Features / Advanced Play

  • Fine-tune Search Algorithm: Supports fine-tuning the search algorithm to meet personalized settings.
  • Custom Program and File Addition: Supports adding files and programs using file wildcards or regular expressions, enabling the addition of files and programs. Intelligently identifies file formats and reacts correctly.
  • Custom Web Search: Supports adding and using the default browser to launch web pages.
  • Custom Command Search: Supports custom command addition, enabling functions like system startup, shutdown, and opening specific secondary settings pages.
  • Intelligent Loading of Program/File/Web Icons: Loads the correct file icons to the greatest extent possible, and also supports correct loading of Steam game icons.
  • Custom Configuration File Save Path: Supports custom local storage and network storage using the WebDAV protocol.
  • Supports Startup and Silent Launch: Nothing much to explain, right? ==
  • Debugging Function: Allows viewing the program's running status on the current computer (usually no issues), and viewing the search algorithm's results.
  • Gaming Mode: Allows manually disabling hotkeys to prevent issues during gaming.
  • Supports Opening Recently Launched Programs: Hold down the Alt key to list recently opened programs in order.
  • Supports Custom Keybindings: Allows customizing keyboard mappings to better suit your operating habits.
  • Supports Call-out Position Following Mouse: If the mouse is on a secondary screen, the search bar will appear on that secondary screen.

🚀 Quick Start

Hotkey Quick Reference

Function Hotkey
Call out search bar Alt + Space
Select item up/down ↑/↓ or Ctrl+k/j
Launch selected program Enter
Launch as administrator (for regular apps only) Ctrl + Enter
Clear search box Esc
Hide search interface Click outside area
Open already open window Shift + Enter
Sort by recent launch time Alt

Implementation of Common Features

For the implementation of program addition, file addition, command addition, search algorithm fine-tuning, and solutions to common problems, please refer to the following document: Usage Guide

Writing documentation is so troublesome, and sometimes I can't describe things well (っ °Д °;)っ. Go check out DeepWiki, it seems to explain things pretty well there.

🚩 Program Download

🛠️ Developer Guide

This Rust is quite good, unified package management is very convenient.

Environment Requirements

  • Rust v1.85.0
  • Node.js v22.11.0
  • Bun v1.2.3

Build Steps

# Clone the repository
git clone https://github.com/ghost-him/ZeroLaunch-rs.git

# Install dependencies
bun install

# Development mode
bun run tauri dev

# Production build
bun run tauri build

Build artifact path: ./src-tauri/target/release/

📦 Data Directory Structure

The program's configuration files are divided into: local configuration file and remote configuration file, both of which are JSON format files. The storage location of the local configuration file is as follows, and the local configuration file stores the address of the remote configuration file. The remote configuration file contains the file information generated during program runtime, and its default storage location is also this directory.

%APPDATA%\ZeroLaunch-rs\                # E.g.: C:\Users\[username]\AppData\Roaming\ZeroLaunch-rs\
├── logs/                               # Runtime logs
└── ZeroLaunch_local_config.json        # Location of the remote configuration file, defaults to this folder

📌 Known Limitations

Short Word Search

⚠️ When input length is < 3 characters, search results may not be precise enough.

🤝 Open Source Acknowledgments

This project is built upon the following excellent open-source projects:

🎯 To-do

Software Goals

  • Error handling optimization

Long-term Goals

Only start implementing the following features when the above goals are completed.

  • Support Linux system (Wayland preferred)

❤️ Support the Author

You can support the author in the following ways:

  1. Give a free little star ⭐
  2. Share this project with other interested friends
  3. Propose more suggestions for improvement (ZeroLaunch-rs is positioned as a pure program launcher, so it will only focus on launcher functions and will not add too many irrelevant features, please understand 🥺🙏)

Star History Chart

translated by gemini 2.5 flash thinking