osfeed.dev
Projects/iluxav / omaestro

omaestro

Lua automation rules for Hyprland, like Hammerspoon

by@iluxav·Maintained by@iluxav
Get it on GitHub
v0.1.8 · 15 things you can do 4 stars 1 change to know before upgrading

Write small Lua rules that make your Hyprland desktop act for you: hotkeys, window placement, timers, system events, and rewriting selected text with a local model.

What you can do with omaestro

Rewrite, summarize or translate the text you selected with a local model and paste the result in place.

Since v0.1.6
Good to know

Needs Ollama with a model pulled (llama3.2 by default) or another OpenAI-compatible endpoint set in omaestro.toml; text goes only to that endpoint.

Share
Wrong?

Bind hotkeys, per-app hotkeys, modal key layers and chord menus from Lua without touching your Hyprland config.

Since v0.1.6
Good to know

A chord already bound by Hyprland or Omarchy is refused unless you free it or turn om override on.

Share
Wrong?

Snap the focused window to a half, a third, the center or the full screen with a key chord.

Since v0.1.6
Share
Wrong?

Run actions every interval, once after a delay, or every day at a set time, such as a stretch reminder.

Since v0.1.6
Share
Wrong?

Run actions on sleep and wake, USB devices, battery level, network changes, monitors and new files in a directory.

Since v0.1.6
Good to know

Battery is polled every 30 seconds; sleep and wake come from logind.

Share
Wrong?
Show all 15

Bring back a window you just closed, with its content and scroll position, within three seconds.

Since commit af99d85
Good to know

SUPER+W is Omarchy's close-window chord: unbind it in bindings.lua or turn om override on, otherwise the rule is refused.

Share
Wrong?

Make the screen warmer at night and normal again in the morning, with a hotkey to switch now and true colors while an image editor has focus.

Since commit bceb5d9
Share
Wrong?

Show large text in the middle of the screen for a moment from a rule, such as the time, a result or a countdown.

Since v0.1.8
Good to know

Drawn by quickshell: the Omarchy shell in its theme when omaestro is its plugin, else a quickshell omaestro starts. Without quickshell it is a notification. One card at a time, display only.

Share
Wrong?

Run a rule when you tap SUPER, ALT, CTRL or SHIFT on its own, once or twice in a row, while the key keeps working in shortcuts.

Since v0.1.8
Good to know

A quick press together with a key that has no Hyprland shortcut, or with a mouse click, still counts as a tap. One tap rule per key.

Share
Wrong?

Show the time, the date and the weather in large type for a second when you double-tap SUPER.

Since v0.1.8
Good to know

The weather comes from wttr.in, which receives your configured location or your IP; `weather = false` sends nothing. Needs om 0.1.8 or newer.

Share
Wrong?

Before you upgrade omaestro

Newest first
omaestro release history 4
v0.1.8
with v0.1.7

Double-tap SUPER to see the time, the date and the weather in large type in the middle of the screen for a second.

Details

New Lua API: `om.show(card, {seconds, position})` returns a handle with `:update` and `:close`, and `om.tap(key, fn, {within, count})` runs a rule on a bare modifier tap. New plugin `clock` (`om plugin add clock`), opened by a double tap of SUPER or by SUPER+ALT+A.

Also: om.show and om.tap for your own rules; om doctor says whether quickshell is installed; omaestro's own quickshell files stay in $XDG_RUNTIME_DIR.

v0.1.8, prebuilt for x86_64 and aarch64. Existing Omarchy installs: `omarchy plugin update io.github.iluxav.omaestro`, then `om plugin add clock`. Cards outside the Omarchy shell need quickshell; without it a card is a notification.

Added: Show large text in the middle of the screen for a m…Added: Run a rule when you tap SUPER, ALT, CTRL or SHIFT o…Added: Show the time, the date and the weather in large ty…Action required / inferred

Published by @iluxav with Claude Code

Read the evidence
commit bceb5d9

Make the screen warmer at night and normal again in the morning, through hyprsunset.

Details

New plugin night-light: warm colors at 20:00 and normal at 07:00 via hyprsunset (started when needed), SUPER+ALT+S to switch now, true colors while GIMP, Inkscape or darktable has focus, the screen set for the time of day after a wake.

Stable. om plugin add night-light; needs hyprsunset, which Omarchy ships.

Added: Make the screen warmer at night and normal again in…

Published by @iluxav with Claude Code

Read the evidence
commit af99d85

Undo closing a window within three seconds and get it back with its unsaved content.

Details

New tile-close-undo plugin: SUPER+W hides the focused window and closes it 3 seconds later; SUPER+Z in between restores it as it was.

On main; install with om plugin add https://github.com/iluxav/omaestro/tree/main/plugins/tile-close-undo. No new om release needed.

Added: Bring back a window you just closed, with its conte…

Seeded by @iluxav with Claude Code

Read the evidence
v0.1.6
First release

Select text anywhere, press a hotkey, and get it back rewritten in place by a local model.

Details

First releases (v0.1.1 to v0.1.6, 2026-09-30 to 2026-10-02): the om daemon and command, Lua rules in ~/.config/omaestro/init.lua and rules.d/, an Omarchy shell panel, and installable plugins from the repository's plugins/ directory.

Also: Settings in ~/.config/omaestro/omaestro.toml; om doctor checks the tools it uses; om skill install adds a skill for AI coding agents.

omarchy plugin add https://github.com/iluxav/omaestro --enable downloads the prebuilt om for x86_64 or aarch64 and checks its SHA256; or make install from a checkout. Needs Hyprland 0.56 or newer.

Added: Rewrite, summarize or translate the text you select…Added: Bind hotkeys, per-app hotkeys, modal key layers and…Added: React when a window opens, gets focus or changes ti…Added: Snap the focused window to a half, a third, the cen…Added: Run actions every interval, once after a delay, or…Added: Run actions on sleep and wake, USB devices, battery…Added: Type a short trigger like :sig anywhere and have it…Added: Keep the last ten clipboard entries and pick one to…Added: Install, configure, update and share rule plugins s…Added: See every rule in a panel in the Omarchy bar and sw…

Seeded by @iluxav with Claude Code

Read the evidence
Written by the project's maintainer, @iluxav, and checked against the repository.

Share

LinkedIn takes the link and its card only; write your text there.

X LinkedIn Reddit Hacker News Bluesky