A Raycast-esque launcher for Omarchy. It learns what you use, searches your apps and every Omarchy action, does the math, keeps your clipboard, and looks like it shipped with your theme.
Omarchy's built-in menu is great at what it does. omacast adds what Raycast users miss on Linux:
- Learns your habits. Results are ranked with a port of Raycast's root-search algorithm, plus frecency and learned search terms. The things you actually use float to the top, and if you type
ffand pick Firefox,ffkeeps meaning Firefox. - One search for everything. Your apps, all ~400 Omarchy menu actions (with breadcrumbs and live ✓ state), a calculator, and web-search fallbacks.
- Built-in commands. Clipboard History, Emoji & Symbols, Switch Theme and Calculator History, each with an optional hotkey of its own.
- Finds the window you already have.
↵on an app focuses its open window instead of starting another one. - Your shortcuts. Give anything an alias, pin favorites, and hide the commands you never touch.
- Keyboard-first. A Ctrl+K action panel, Ctrl+1–9 quick picks, search history on ↑, section jumping, and emacs- or vim-style navigation.
- Native to Omarchy. It runs inside
omarchy-shellas a plugin, with no Electron, no Node and no extra daemons. The window stays ready while hidden, so the hotkey opens it in a single frame, and it follows your theme live when you runomarchy theme set.
![]() |
![]() |
| Every Omarchy action, with breadcrumbs | Ctrl+K: actions for any result |
No match? Send the query to Google or DuckDuckGo
There's no theme config. omacast binds to Omarchy's own colours, so it changes the moment you switch themes.
Under Omarchy's Glassy Windows (omarchy hyprland window transparency glassy) the card turns see-through
and Hyprland blurs what's behind it, like Omarchy's own menus.
Requires Omarchy 4 (Hyprland 0.56+, omarchy-shell). Install it from the
Omarchy plugin marketplace, or with:
omarchy plugin add https://github.com/typecraft-dev/oma-cast --enable
~/.config/omarchy/plugins/typecraft.omacast/bin/omacast install # link the omacast CLI into ~/.local/bin
omacast setup hyprland # bind Alt+Space
omacast doctor # check everything is wired upPress Alt+Space. Super+Space stays the Omarchy menu.
omacast setup hyprland lists what it will change and asks before changing it. It writes
~/.config/hypr/omacast.lua and appends one require("hypr.omacast") line to
~/.config/hypr/hyprland.lua; it never edits Omarchy's own files. To use another key, edit
omacast.lua; setup never overwrites one that already exists. To bind it yourself instead, add
this to your Hyprland config:
o.bind("ALT + SPACE", "omacast launcher", hl.dsp.global("omacast:toggle"), { submap_universal = true })
-- While omacast is open it switches Hyprland to this submap, so Super+J/K reach the launcher.
hl.define_submap("omacast", function()
hl.bind("SUPER + F24", hl.dsp.no_op()) -- a submap needs one bind to exist
end)
-- Blur behind the launcher under Glassy Windows.
hl.layer_rule({ match = { namespace = "^omacast$" }, blur = true, ignore_alpha = 0.3 })An omacast.lua written by an older version has only the first line. Add the rest to get Super+J/K and the
glass blur; without the submap, Super+J/K stay Hyprland's and everything else works as before.
Update with omarchy plugin update typecraft.omacast.
omacast uninstall # asks to remove the hotkey, then runs: omarchy plugin remove typecraft.omacastOr remove it by hand: omarchy plugin remove typecraft.omacast, then delete ~/.config/hypr/omacast.lua
and the require("hypr.omacast") line in ~/.config/hypr/hyprland.lua, and ~/.local/bin/omacast.
Your data stays until you delete it: ~/.config/omacast, ~/.local/share/omacast, ~/.cache/omacast
and ~/.local/state/omacast.
An empty search shows Favorites, Suggestions (what you use most), Commands and Applications.
Type, and you get ranked Results, a Calculator answer when the query is math, and Use "<query>" with…
web searches at the end. Ctrl+P filters the root to All, Applications or Commands.
- Applications.
↵on an app focuses its most recently used window, switching to its workspace, raising it on floating workspaces and restoring it from the dock if it's minimized. It only launches the app when no window is open. Windows are matched by desktop id,StartupWMClass, or the URL Chromium and Brave web apps are named after.Shift+↵(Open New Window) always launches. Apps open through Omarchy's own launcher, so terminal apps go toomarchy-launch-tui. - The Omarchy menu. Every action in the Omarchy menu is searchable from the root, with breadcrumbs like
Appearance › Windows. Submenus open in place (search within them,
Escto go back), items Omarchy hides stay hidden, and toggles show their live ✓ state.Ctrl+↵opens an item in the Omarchy menu itself. Omarchy Menu opens the whole menu. - Web search. Search Google and Search DuckDuckGo (alias
ddg) take a query in an argument pill:Tabinto it, type,↵. - Confirmations. Shut Down, Restart, Log Out and Delete All Entries ask first (
↵confirms,Esccancels). - Feedback. Results show toasts in the footer (
Ctrl+Topens their actions, such as Undo after disabling a command or Copy Error Message after a failure), and a HUD through Omarchy's OSD when the window closes.
Type math straight into the search bar; the answer shows in a Calculator card above the results. omacast has its own engine, so there's nothing to install.
| Kind | Try |
|---|---|
| Arithmetic and functions | 2^10, sqrt(2) * 10, sin(30°) |
| Percentages | $30 + 20%, 20% off 50, 50 as a % of 200 |
| ~250 units, including mixed units | 5 ft to cm, 5 ft 3 in to cm, 60 mph * 2 h, 16px to rem |
| Currencies | 100 usd in eur |
| Dates | 3 days from now, days until christmas |
| Time zones | time in tokyo, 3pm london to nyc |
| Number bases | 255 to hex |
| Work time | 40 hours in work days (a work week is 5 days) |
| Unix time | unix 1700000000, 1700000000 to date, now to unix |
↵ copies the answer, Ctrl+↵ pastes it into the app you came from, and Ctrl+Shift+C copies
"question = answer". Each one is saved to Calculator History (searchable, kept for 90 days; Ctrl+D
deletes an entry, Ctrl+Shift+D deletes all). Trig takes radians unless you add ° or deg.
Currency rates are ECB reference rates (see network access).
config.json sets remToPxRate (16), workHoursPerDay (8) and clockFormat (auto follows your locale,
or 12h / 24h).
Search Clipboard History in the root search, or bind it directly:
o.bind("SUPER + CTRL + V", "omacast clipboard history", hl.dsp.global("omacast:clipboard"), { submap_universal = true })Pressing the binding again closes it.
- omacast records text, links, colours, files and images you copy, with the app you copied from, when, and how many times.
- The list is on the left and a preview with its details is on the right, in Pinned, Today, Yesterday and Earlier sections. The type dropdown (
Ctrl+P) filters by All Types, Text, Images, Files, Links or Colors. ↵pastes into the app you came from,Ctrl+↵copies,Ctrl+Oopens a link or file,Ctrl+Shift+Ppins,Ctrl+Ddeletes an entry andCtrl+Shift+Ddeletes everything except pins.- Entries are kept for a week, as in Raycast. Pinned entries are always kept. Change it with
"clipboardHistoryDuration"inconfig.json(P1D,P1W,P1M,P3M,P6M,P1Yorunlimited). - Copies from password managers are never recorded: anything marked sensitive, plus the apps in
"clipboardDisabledApplications"(Wayland app ids; KeePassXC, Bitwarden, 1Password and Seahorse by default)."clipboardHistory": falsestops recording. - The history is in
~/.local/share/omacast/db/clipboard.json, and images and long text are in~/.local/share/omacast/clipboard/, both readable only by you.
Search Search Emoji & Symbols, or bind it directly:
o.bind("SUPER + CTRL + SPACE", "omacast emoji", hl.dsp.global("omacast:emoji"), { submap_universal = true })(Super+Ctrl+Space is Omarchy's background switcher by default; add hl.unbind("SUPER + CTRL + SPACE") first
to take it over.)
- An 8-column grid of every Unicode 17 emoji, with Pinned and Recently Used sections above the categories, and the selected emoji's name in the footer.
- Search by name, or by the keywords from Omarchy's own emoji picker (
lol,ship…). - Arrow keys move around the grid.
↵pastes,Ctrl+↵copies,Ctrl+Shift+Ccopies the name,Ctrl+Shift+Ppins,Ctrl+Dremoves one from Recently Used andCtrl+Shift+Dclears them all. - Pick a skin tone from the action panel (
Ctrl+K); it applies to every emoji that has one.
Switch Theme lists your Omarchy themes, your own and Omarchy's, with the current one checked and a preview of the highlighted theme beside the list. ↵ applies it with omarchy-theme-set, and omacast changes with it. It replaces Omarchy's own theme picker in omacast's results. To open it from Omarchy's theme keys as well:
hl.unbind("SUPER + CTRL + T")
o.bind("SUPER + CTRL + T", "omacast switch theme", hl.dsp.global("omacast:theme"), { submap_universal = true })Pressing the key again closes it.
Executable scripts in ~/.config/omacast/script-commands/ become commands, using the same
Raycast Script Commands headers:
#!/bin/bash
# @raycast.schemaVersion 1
# @raycast.title Switch Display
# @raycast.mode silent
# @raycast.icon 🖥️
# @raycast.argument1 { "type": "dropdown", "placeholder": "Input", "data": [{"title": "Mac mini", "value": "x0091"}, {"title": "MacBook Pro", "value": "x00d0"}] }
monitor-input-cycle "$1" && echo "Switching display"- Arguments (
text,password,dropdown, up to three) appear as pills after the query:Tabmoves into them, and←/→pick a dropdown option. - The last line the script prints becomes the result: a HUD for
silent, a toast forcompact. fullOutputandinlinescripts run ascompactfor now.needsConfirmationasks first, andcurrentDirectoryPathsets the folder the script runs in.- The folder is rescanned each time the launcher opens. Scripts need
chmod +xand a shebang.
| Key | Does |
|---|---|
Alt+Space |
Open or close omacast |
↵ / Ctrl+↵ / Ctrl+Shift+↵ |
Run the first, second or third action |
Shift+↵ |
Open a new window of an app (↵ switches to the one already open) |
Ctrl+K |
Open the action panel (type to filter it; each action shows its shortcut) |
Ctrl+1…9 |
Pick a result |
↑ / ↓, Super+J / Super+K |
Move through results |
Ctrl+N / Ctrl+P |
Next / previous (emacs bindings; Ctrl+P moves up only inside popups) |
PageUp / PageDown |
Move eight results at a time |
Ctrl+↑ / Ctrl+↓ |
Jump between sections |
↑ on an empty search |
Search history |
Ctrl+P |
Filter dropdown (All / Applications / Commands; types in Clipboard History) |
Tab / Shift+Tab |
Into and out of an argument pill |
Ctrl+Shift+F |
Add to or remove from favorites (Ctrl+Alt+↑↓ to reorder) |
Ctrl+Shift+C |
Copy (the command, desktop id, answer or name) |
Alt+Shift+D |
Disable a command |
Ctrl+T |
Actions for the current toast (Undo, Copy Error Message) |
Ctrl+Shift+K |
About the selected result |
Super+V / Ctrl+V / Ctrl+Shift+V / Shift+Insert |
Paste text into the query (also accepts clipboard-history selections) |
Super+Backspace |
Clear the query |
Esc / Ctrl+[ / Backspace on an empty query |
Back |
Shift+Esc |
Back to the root |
Ctrl + / Ctrl − / Ctrl 0 |
Zoom |
With "navigationBindings": "vim-motions", Ctrl+J / Ctrl+K move and the action panel moves to Alt+K.
Super+J/K need the omacast submap from Install.
There's no settings window yet. Preferences live in two places.
~/.config/omacast/config.json. Create it and add only what you want to change. omacast picks up changes
as soon as you save; an unreadable file falls back to the defaults and logs a warning.
| Key | Default | Does |
|---|---|---|
currencyRates |
true |
Download daily exchange rates for the calculator |
remToPxRate |
16 |
Pixels per rem |
workHoursPerDay |
8 |
Hours in a work day |
clockFormat |
"auto" |
"auto", "12h" or "24h" |
rootFilter |
true |
false hides the All / Applications / Commands dropdown and its shortcut |
keepVisibleOnFocusLoss |
false |
true keeps the launcher open when you click outside it |
clipboardHistory |
true |
false stops recording (the history stays) |
clipboardHistoryDuration |
"P1W" |
How long unpinned entries are kept |
clipboardDisabledApplications |
password managers | Wayland app ids whose copies are never recorded |
logLevel |
"info" |
How much omacast writes to the shell log |
General settings, set through the CLI (it checks each value):
omacast call settings.getGeneralSettings
omacast call settings.updateGeneralSettings '{"navigationBindings":"vim-motions"}'| Setting | Values |
|---|---|
navigationBindings |
emacs or vim-motions |
windowMode |
expanded, or compact (only the search bar until you type) |
escapeKeyBehavior |
pop-back-or-close or close-and-pop-to-root |
popToRootTimeout |
Seconds before a closed launcher resets to the root (default 90) |
rootSearchSensitivity |
low, medium or high |
uiZoom |
A number like 1.1 (Ctrl + / − / 0 set it too) |
Aliases, favorites and disabled commands are set from the launcher (Ctrl+K on a result). To re-enable a
disabled command, use Undo on the toast (Ctrl+T), or remove its "enabled": false from
~/.local/share/omacast/db/settings.json.
omacast toggle | show | hide
omacast run <commandId> # e.g. builtin:emoji-picker, app:com.mitchellh.ghostty, omarchy:appearance.theme
omacast call <method> [json] # call any backend method; omacast call system.info lists them
omacast doctor # checks the shell, IPC, the backend, QML errors in the shell log, and the hotkey
omacast setup hyprland [--yes]
omacast build-search # build the optional search helper (needs cargo)
omacast install | uninstallGlobal shortcuts for Hyprland binds: omacast:toggle, omacast:clipboard, omacast:emoji, omacast:theme.
Bind them with submap_universal = true so they still work while omacast is open.
omacast needs only what Omarchy ships: omarchy-shell (Quickshell), Hyprland, bash, jq and socat.
It adds no packages and no background services.
- Superwhisper recording indicator. When
python3with PyGObject is installed, the plugin runsservices/superwhisper-frame.pyalongside the shell. While the launcher is open it tells Superwhisper where the card is over the session bus (com.superwhisper.ShellOverlay), so Superwhisper's recording glow or pill draws on the launcher instead of the window under it. It makes no network requests, and does nothing without Superwhisper. - Currency rates. When you open the launcher and its rates are over 12 hours old, the calculator downloads
ECB exchange rates from
api.frankfurter.dev(retrying 30 minutes after a failure) and caches them in~/.cache/omacast/currencies.json. This is the only network request omacast makes. Turn it off with"currencyRates": falsein~/.config/omacast/config.json. - Optional search helper. With Rust (
cargo) installed,omacast install(oromacast build-search) builds the small flea-search helper fromsearch/on your machine. It matches titles, alternate names, subtitles and keywords outside the shell's UI thread and tolerates transposed or missing letters, and it also searches the emoji list. Nothing is downloaded prebuilt. Without it, omacast uses the built-in matcher, so a marketplace install works without Rust. Aliases, favorites, learned terms and frecency stay in omacast's ranker either way. If the helper fails or times out, search falls back to the built-in matcher until the plugin reloads. Rebuild it afteromarchy plugin update.
Your search history, learned search terms, calculator history and clipboard history stay on your machine, in
owner-only files: omacast creates its ~/.config, ~/.local/share, ~/.cache and ~/.local/state
directories as 0700 and its database files as 0600, and tightens any it finds readable by other users.
Text you copy or paste goes to wl-copy on stdin, never on a command line, so other local users can't read it
from the process list. Paste sends Ctrl+Shift+V to terminals (Alacritty, Kitty, Ghostty, foot, WezTerm,
Konsole, GNOME Terminal, Ptyxis, Herdr) and Shift+Insert everywhere else, as Omarchy's clipboard history does.
The one exception is a script command's arguments: they reach your script as $1…$3, so they are on its
command line while it runs.
The plugin used to be typecraft.oma-cast. On first start, omacast moves your oma-cast config, data,
cache and state directories to the omacast names. In a development checkout, bin/omacast install removes
the old plugin link and ~/.local/bin/oma-cast, and omacast setup hyprland moves oma-cast.lua to
omacast.lua, keeping your key. omacast doctor reports anything left over.
omacast is early. Search, ranking and the Omarchy integration are done.
Done:
- Root search with Raycast's ranking, frecency, aliases and favorites
- The whole Omarchy menu
- Calculator and Calculator History
- Clipboard History
- Emoji & Symbols
- Switch Theme
- Script Commands (arguments, confirmation)
Next:
- Settings view (General, Commands, Calculator, Scripts)
- Script Commands: the
fullOutputview andinlinerefresh -
omacast://deep links
Later:
- Quicklinks
- Snippets and text expansion
- Running Raycast extensions built from the open-source
raycast/extensionsrepo - Window management and a window switcher
- File search
- Importing your
.rayconfigfrom macOS
The full plan is in SPEC.md.
git clone https://github.com/typecraft-dev/oma-cast.git
cd oma-cast
bin/omacast install # symlink this checkout into omarchy-shell instead of a marketplace copy
node --test tests/*.test.js # unit tests, no npm install needed
tests/smoke.sh # live checks against the running shell
omacast dev # reload on every saveRemove a marketplace install first (omarchy plugin remove typecraft.omacast); both use the same plugin id.
Quickshell caches QML for the life of the process, so run omacast reload after editing a checkout. See CLAUDE.md for the layout and conventions.
The website is in site/: a static page deployed to Cloudflare. Its "Try it" launcher is these same core/*.js modules running in the browser.
omacast is an independent, clean-room project. It isn't affiliated with or endorsed by Raycast, and it contains no Raycast code or assets. It never contacts Raycast's servers, has no telemetry, and has no AI features.



