paulsp94/omacosy

What is it?

Key features

• 01Dwindle tiling that splits the focused window along its longer edge
• 02Caps Lock mapped to a Super key for omarchy-style shortcuts
• 03Single-process status bar with popups, sliders and screen dimming
• 04Focus follows mouse with per-app opt-out
• 05Four-finger trackpad swipes to switch workspaces
• 06Workspace overview with live window previews and type-to-search

Use cases

• Developers who want omarchy-like keyboard-driven tiling on a Mac
• Users who want one theme switch to cover the bar, borders and wallpaper
• Anyone willing to grant macOS accessibility and input permissions for tiling

Quick start

1. 1

   Clone the repo and run the installer

   d=~/.local/share/omacosy if [ -d "$d/.git" ]; then git -C "$d" pull --ff-only; else git clone https://github.com/paulsp94/omacosy.git "$d"; fi && cd "$d" && ./install.sh
2. 2

   Grant the macOS permissions the installer asks for (Accessibility, Input Monitoring, etc.)

Things to know

• !Targets macOS 26 (Tahoe) only and has so far run only on the author's own machine.
• !Needs broad permissions, including Accessibility and Input Monitoring, and Karabiner-Elements runs as root.
• !Karabiner-Elements is a third-party dependency that installs a DriverKit system extension.

In collections

Topics

FAQ

What is omacosy?

An omarchy-style desktop setup for macOS, adding Hyprland-like dwindle tiling, a themed status bar, focus-follows-mouse and workspace overview. omacosy brings an omarchy-style workflow to macOS. It tiles windows with a dwindle layout that splits the focused window along its longer edge, maps a Caps Lock key to Super for shortcuts, and uses a single self-built status bar process that draws the bar, popups, volume and brightness sliders, and screen dimming.

Is omacosy free to use? What license does it have?

omacosy is open source under the MIT license. Check the license terms before using it in commercial products.

Is omacosy still maintained?

Actively maintained. The last commit to omacosy was on Nov 4, 2026.

What can I use omacosy for?

Developers who want omarchy-like keyboard-driven tiling on a Mac Users who want one theme switch to cover the bar, borders and wallpaper Anyone willing to grant macOS accessibility and input permissions for tiling

How do I install omacosy?

Clone the repo and run the installer: d=~/.local/share/omacosy if [ -d "$d/.git" ]; then git -C "$d" pull --ff-only; else git clone https://github.com/paulsp94/omacosy.git "$d"; fi && cd "$d" && ./install.sh Grant the macOS permissions the installer asks for (Accessibility, Input Monitoring, etc.)

Where can I get omacosy?

The source code and installation instructions are on GitHub: https://github.com/paulsp94/omacosy