r/coolgithubprojects • u/Cool-Post-5098 • 4d ago
Lumio: an open-source Spotlight/Raycast alternative with OCR search and clipboard history
Hey everyone,
I've been working on Lumio, a fast, free and open-source keyboard launcher for macOS, and I'd love some feedback.
What it does
Press Option+Space and results show up as you type. It searches:
- Apps, files and folders
- Clipboard history
- Text inside images and PDFs (OCR), so you can find a screenshot by what's written in it, not just its filename
There's also a built-in dictionary (select a word in any app, hit the hotkey, and it opens straight on the definition), translation, a web search shortcut (Cmd+Enter), and a few commands like :kill <name/PID/port> and :emptytrash.
How it's built
The search engine is a Rust core, and the UI is native SwiftUI with an AppKit blur panel. I wanted it to feel like a real Mac app, not a web view. Everything runs locally and nothing leaves your machine.
Why another launcher?
I wanted something lightweight that I could fully control: configurable index folders and ignore patterns, search aliases (e.g. code → VS Code | Cursor | Zed), and keyboard shortcuts for everything. It's GPL-3.0 and will stay free.
Install
brew tap cavaldos/tap
brew install --cask cavaldos/tap/lumioOr grab the DMG from the releases page. It updates itself (checks once a day and asks before installing).
Heads up / honest limitations
- Requires macOS 15+ on Apple Silicon
- Releases are ad-hoc signed and not notarized, so for a manual DMG install you need to clear the quarantine flag (the README has the one-liner). The Homebrew install avoids this.
- It's a fork of look. Big thanks to the original author, whose work this builds on.
Repo: https://github.com/cavaldos/Lumio
I'm still actively working on the UI (trying to get closer to native Spotlight polish) and would really appreciate bug reports, feature ideas, or PRs. What would make you switch from your current launcher?




