https://github.com/tectiv3/relux
macOS native launcher with some extensibility
https://github.com/tectiv3/relux
launcher swift swiftui
Last synced: 3 months ago
JSON representation
macOS native launcher with some extensibility
- Host: GitHub
- URL: https://github.com/tectiv3/relux
- Owner: tectiv3
- License: mit
- Created: 2026-03-06T11:26:26.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-06T15:42:43.000Z (4 months ago)
- Last Synced: 2026-03-06T17:32:47.751Z (4 months ago)
- Topics: launcher, swift, swiftui
- Language: Swift
- Homepage:
- Size: 4.77 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Relux
A macOS menu-bar utility that puts app launching, clipboard history, translation, and more behind a single hotkey.
## Screenshots
Search overlay — dark
Search overlay — light
Clipboard history
Settings
General
Scripts
Clipboard
Translate
## Features
- **App launcher** — fuzzy search across installed applications; search paths configurable in Settings
- **System Settings** — search and open macOS System Settings categories directly (Wi-Fi, Keyboard, Privacy, etc.)
- **Clipboard history** — searchable history, paste with `Cmd+Shift+V`. Confidential copies (passwords, OTPs) are automatically ignored via `org.nspasteboard.ConcealedType`, `TransientType`, and `AutoGeneratedType` conventions. Per-app exclusions configurable in Settings.
- **Translator** — select any text, trigger the overlay, pick Translate from quick links; streams translation via Anthropic API (requires API key in Settings)
- **Calculator** — inline math evaluation with currency conversion (rates fetched daily from ECB)
- **Web search** — fall through to DuckDuckGo
- **Custom scripts** — shell scripts that can read selected text and output back to the screen (or show a notification)
## Install
```bash
brew tap tectiv3/relux
brew install --cask relux
```
Or download the latest `.dmg` from [GitHub Releases](https://github.com/tectiv3/relux/releases). The app is signed and notarized by Apple.
## Requirements (building from source)
- macOS 14+
- Apple Silicon
- Xcode 16+
- [XcodeGen](https://github.com/yonaskolb/XcodeGen) (`brew install xcodegen`)
## Build & Run
```
xcodegen generate
open Relux.xcodeproj
```
Build and run from Xcode (⌘R).
## Usage
| Shortcut | Action |
|---|---|
| `Option+Space` | Open search overlay |
| `Cmd+Shift+V` | Open clipboard history |
| `Caps Lock` (on selection) | Quick links (translate, scripts, etc.) |
| `Esc` / click outside | Dismiss |
Keyboard shortcuts are configurable in Settings. On first launch Settings opens automatically.
> **Tip:** For the best experience, rebind the overlay shortcut to Caps Lock or another dedicated key so it's always one tap away.
## Architecture
```
Shell (menu bar, hotkey, overlay)
→ ExtensionProtocol
→ AppSearcher
→ SystemSettingsSearcher
→ ScriptSearcher
→ ClipboardStore (SQLite)
→ TranslateStore (SQLite)
```
Built around a generic extension protocol — the overlay is designed to be extended with new panel types.