Wilfred is a fast, lightweight, cross-platform desktop search engine and application launcher. One summonable search bar (Ctrl+Alt+W on Windows/Linux, ⌘+Alt+W on macOS, configurable) sits above everything else and finds files, folders, apps, bookmarks, clipboard history, notes and more. It also handles calculations, conversions and system actions. The project’s tagline is Fast. Deep. Modular. Low-resource. Cross-platform. Extensible.
It’s a local-first, open-source (MIT) project written in C++20 with no third-party runtime dependencies. The name comes from Old English wil (will) and frith (peace), which the authors read as the will to find, the peace of knowing its yours.
Features
- Incremental, persistent filename/path/metadata index with a write-ahead log
- Filesystem watchers (ReadDirectoryChangesW, FSEvents, inotify) plus rescan fallback
- Fuzzy matching, acronyms, token/path ranking, recency and frequency signals
- Typo safety: Damerau (transposition-aware) near-miss matching on names, tokens and paths, plus Did you mean correction (commands, history, filenames)
- Inline autocomplete: ghost completion (→ to accept) + top-N candidates from history, commands and the index
- Context-aware ranking (recent folders, file types, time-of-day, session queries)
- Clipboard as a secondary source (text match, copied paths, clip history)
- Persistent clipboard manager (clips [query], pin, clips clear, clips url|email|path|code|ip)
- Content indexing for source, config, and text documents
- Real document text extraction (PDF, Office, RTF, HTML) into the content index
- Optional semantic search: local embeddings (llama.cpp server/model or built-in hash) + HNSW vector index (vectors.bin next to WAL/snapshot) merged with trigram soft-match (providers.semantic, embedding.*)
- Optional AI assistant (ai .../ask ..., screen-aware ai see ...) with your own keys: OpenAI, Anthropic, Gemini, Groq
- Snippets with folders, {date}/{clipboard}/{query} placeholders, and optional global abbreviations in any app
- Quick notes + todos (note ..., todo ..., persistent in the data dir)
- Pomodoro / countdown timers + stopwatch (timer, pomodoro, stopwatch)
- Rich file previews (documents, CSV, images, folders) in the overlay (F3) plus wilfred preview
- Calendar (.ics), contacts (.vcf), and notes (Markdown) sources + optional OCR indexing via tesseract (sources.*)
- Cross-platform overlay (Windows WebView2 topmost, macOS floating panel, Linux WebKitGTK with automatic X11 canvas fallback, layer-shell anchored on Wayland compositors, all above/skip-taskbar) with Ctrl/⌘+K actions popover and matching shortcuts in both Linux backends
- Browser bookmarks, history, and open tabs (bm, provider-backed)
- Instant NTFS full-disk enumeration via the USN journal on Windows
- Official OS index federation (os_search:): Windows Search, Spotlight, Tracker/Baloo, locate fill gaps Wilfred's index misses (os <query> forces it, duplicates dropped)
- Preview pane in the overlay (F3) plus wilfred preview, and chained result actions (open+copy_path) + named multi-step workflows (workflows:)
- Mini results for weather, time, disk, RAM, CPU, processes, battery, windows, timers, notes, media, network, layouts, and more
- Window management (windows, minimize/maximize/close window, snap) plus saved window layouts (layout save, layout)
- Screen-aware AI (ai see ... sends a screenshot as vision input to your provider)
- Quick notes now live as real Markdown files, searchable both as cards and through notes search
- System-wide automation: extra global hotkeys (hotkeys:), wilfred workflow / wilfred exec CLI triggers
- Search macros (!yt, gh, wiki, plus custom templates in config) + parameterized quicklinks (quicklinks: with {1}/{*}/{query})
- Per-app extra context actions (app_actions:) on top of the built-in file actions
- Large-file finder + duplicate candidates from the index (large, dupes)
- File conversion (convert song.wav to mp3, convert photo.bmp to png: native WAV/RAW + BMP/PNG/PPM/TGA, ffmpeg for mp3/ogg/flac/jpg/webp) + background removal (bgremove photo.png to transparent PNG, no model needed)
- Process killer (kill <pid|name>), native media keys (media play/next/mute/vol -- no helpers to install), network tools (ping, dns, myip), speech-to-text (transcribe via whisper CLI or the built-in spoke engine)
- Composable filters (*.cpp in Projects, type:image, size:>10mb, named scopes)
- Application discovery (Start Menu / .app bundles / .desktop files)
- Rich file actions (copy path flavors, SHA-256 hash, zip, terminal/editor here, new file/folder, Open With)
- Move to trash and extract archives from the overlay (inline confirm before deleting; zip entries are path-traversal checked)
- Inline audio/video previews in the details pane (browser-playable formats up to 10 MB, no external player)
- Multi-select results (Ctrl/⌘-click to toggle, Shift-click or Shift+arrows for ranges) and batch actions, plus drag files out of the overlay onto other apps
- Configurable overlay keybindings (keybinds:), saved searches (searches: + saved mini), a recent mini, and custom_metadata: surfaced by meta
- wilfred doctor health report (config, data dir, index, hotkey, overlay, services) with [ok]/[warn]/[FAIL] checks
- Default-browser detection, URL open, and web-search fallback
- Safe expression parser (arithmetic, functions, unit/currency/color/date conversion, uuid/base64/sha256/lorem/json, hex/dec/bin/oct, bits, regex/url/jwt)
- Native and stdio plugins, plus extra search backends via providers
- Calculator plus unit, currency, color, date, and small dev utilities
- System commands from the overlay (lock, sleep, shutdown, restart, logout, empty trash)
- System toggles (wifi on/off, bluetooth toggle, volume 50/mute, brightness 70) + settings deep-links (settings wifi/bluetooth/sound/display/...) -- real OS backends on Windows/macOS/Linux, honest unsupported errors on mobile/BSD gaps
- Package-manager search (winget firefox, brew switch, apt vlc -- Enter installs, Tab copies the command; packages lists detected managers)
- Settings + setup (settings config open/validate, settings edit <key> <value>, setup, wilfred setup --overwrite, wilfred config-get/set/reset, wilfred config-validate/open/path) and opt-in remote search backends (remotes: -- your endpoints only, off by default; per-source headers: + max_results:)
- Plugins with trust-on-first-use (plugins approval cards, wilfred plugin list/install/approve/revoke, optional plugins.registry index, sha256-verified installs)
- Window tiling (layout tile halves|thirds|grid|columns N|rows N|stack, wilfred tile …) + monitor-change auto-apply (layouts.auto_apply, auto_layout, monitor_layouts)
- Android app (Kotlin UI + C++ core via NDK → .apk): floating W button, search bar, same index/search/ranking -- see docs/android.md
- iOS app (SwiftUI + same C++ core → simulator .app): same search UI as Android (app-icon entry; iOS forbids overlay buttons), sandbox-only index -- see docs/ios.md
- Local backup/restore and optional remote sync (backup, restore, sync-push, sync-pull)
- Import from other launchers (wilfred import --list/--detect/auto --dry-run/--overwrite): Alfred, Raycast, PowerToys Run, Flow Launcher/Wox, Keypirinha, Listary, Ulauncher, Albert, KRunner, Rofi -- see docs/import.md
- YAML configuration with validation, Did you mean hints, and human-readable errors
- Global hotkey: Ctrl+Alt+W (Windows/Linux), ⌘+Alt+W (macOS), configurable
- Local search history (optional; disable or wilfred history-clear)
- Overlay UI plus CLI (search, launch, index, status, backup/sync, import)
Follow Wilfred
Other Useful Business Software
Custom VMs From 1 to 96 vCPUs With 99.95% Uptime
Live migration and automatic failover keep workloads online through maintenance. One free e2-micro VM every month.
Rate This Project
Login To Rate This Project
User Reviews
Be the first to post a review of Wilfred!