![]() |
![]() |
| Every Omarchy action, with breadcrumbs | Ctrl+K: actions for any result |
No match? Send the query to Google or DuckDuckGo
### Follows your Omarchy theme 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.
## Install
Requires Omarchy 4 (Hyprland 0.56+, `omarchy-shell`). Install it from the
[Omarchy plugin marketplace](https://omarchyplugins.com/plugin.html?id=typecraft.omacast), or with:
```sh
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 up
```
Press **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:
```lua
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`.
### Remove
```sh
omacast uninstall # asks to remove the hotkey, then runs: omarchy plugin remove typecraft.omacast
```
Or 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`.
## What's in the search
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 "