osfeed.dev
Projects/iluxav / omaestro

omaestro

Lua automation rules for Hyprland, like Hammerspoon

by@iluxav·Maintained by@iluxav
Get it on GitHub
Updated 2026-10-06 12 things you can do
Follow GitHub

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.

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.

React when a window opens, gets focus or changes title, and float, center, move or arrange windows from a rule.

1 other tool for window rules
Since v0.1.6

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

Since v0.1.6

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

Since v0.1.6

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.

Type a short trigger like :sig anywhere and have it replaced by your text.

1 other tool for text expander
Since v0.1.6
Good to know

Your user must be in the input group; typing goes through a US keymap.

Show all 12

Install, configure, update and share rule plugins straight from git repositories.

1 other tool for Hyprland plugins
Since v0.1.6
Good to know

Plugins run as you with everything om can do; there is no registry or review.

See every rule in a panel in the Omarchy bar and switch each one on or off.

1 other tool for Omarchy bar widget
Since v0.1.6
Good to know

The panel and bar icon need the Omarchy plugin install.

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.

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
omaestro release history 3
commit bceb5d92026-10-06

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 (osfeed)

Read the evidence
commit af99d852026-10-04

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 (canido)

Read the evidence
v0.1.62026-10-02
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 (canido)

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