Omadock is built by just one person — suva (@thepathless). I've loved computers and programming for as long as I can remember, but I never pursued it professionally — I'm a medical student in India, and Omadock is what I build in the hours between classes and clinics (yes, heavily vibe-coded with AI pair-programming tools ✨). But this costs real money I don't quite have — AI tokens every month, plus my coding-agent subscription: the ₹499 Freebuff Starter plan that makes Omadock possible was literally borrowed from my mom 😅.

Money is always tight as a student — and my laptop is fighting me every step of the way. It's a ThinkPad L14 Gen 2 with a Realtek RTL8821AE WiFi card — one of the most notoriously Linux-hostile chipsets ever shipped (constant WiFi drops, flaky Bluetooth, a touchscreen that half-works) — plus sticking keys and a trackpad with a mind of its own. Honestly, it's the worst possible laptop for Linux.

So I'm saving up for a proper machine: a Dell XPS 13 (2026) — the same XPS line DHH, Omarchy's creator, is writing love letters to ("Year of the Linux Laptop"). It's the cheapest of the three I'm eyeing — a Framework 13 doesn't even ship to India, and a modern ThinkPad T/X costs far more.

Every donation goes to exactly two things: AI coding tokens that make development possible, and the laptop fund 💻. Monthly or one-time — both keep updates coming.

▓░░░░░░░░░░░░░░░░░░░ $0 / $1,000 — Dell XPS 13 (2026) goal

(running total so far: −₹499 for my Freebuff Starter subscription — borrowed from my mom 😅. Updated monthly; honesty is the least I can offer)

To everyone who donates — really, truly, thank you. 🙏

Omadock (オマドック) is an ultra-fast, lightweight shell overlay plugin built natively for Omarchy (Arch Linux + Hyprland + Quickshell).

Crafted in the spirit of Omakase (おまかせ) — curated elegance and effortless flow — Omadock bridges the gap between dynamic tiling compositors and tactile desktop ergonomics. It delivers fluid wave magnification, live screencopy preview cards, and multi-instance window management with strictly 0.00% background CPU consumption.

• 🔘 3-State Window Dots: Instant visual indicator dots for active, visible, and minimized windows.
• 🌊 Continuous Wave Physics: Fluid cosine-falloff cursor wave dynamics alongside classic zoom mode with zero coordinate jumping.
• 🪟 Visual Window Previews: Minimized windows park directly on the dock as visual thumbnail cards.
• 📁 App Group Folders: 2x2 live preview grid, popover tray, drag-to-group, in-place title editing, drag-to-pin, and drag-out extraction to ungroup/unpin.
• 💾 Removable Media Auto-Docking: USB and removable drive detection with mountpoint badges, storage tooltips, and contextual eject/unmount actions.
• 📐 Dock Alignment Options: Bottom alignment support (center, left, right) with dynamic coordinate compensation and Hyprland workspace integration.
• 🖥️ Multi-Monitor Docks: One dock per monitor, each listing only the windows open on that monitor — like the Windows taskbar on every display.
• ⚡ FreeDesktop Jump Lists: Contextual quick actions for supported desktop applications.
• 📂 Folder Stacks & Popovers: 1-click popovers for recent files with automatic theme sync and color presets.
• 🔔 Attention Glow & Canberra Chimes: Bouncing alerts and audio chimes for background notifications.
• 🎯 Intelligent Zero-CPU Autohide: Event-driven 2D Axis-Aligned Bounding Box (AABB) window overlap detection aware of all tiled and floating windows.
• 🔄 Fluid Drag-and-Drop: Drag pinned items to reorder with live real-time insertion markers.
• ⌨️ Desktop Keybindings: Automated bind-keys.sh integration with ~/.config/hypr/bindings.lua (SUPER + D, SUPER + M, SUPER + SHIFT + M).

omarchy plugin add https://github.com/thepathless/omadock.git --enable --yes

omarchy plugin update omadock --yes

omarchy plugin remove omadock --yes

Every running application icon features micro-indicators communicating the exact state of all open instances:

  ┌─────────────────────────────────────────────────────────────┐
  │  INDICATOR LEGEND:                                          │
  │   [ ▬ ] Active / Focused Window   (Illuminated Theme Bar)   │
  │   [ ● ] Open / Visible Window     (Solid High-Contrast Dot) │
  │   [ ○ ] Minimized / Parked Window (Hollow Circle Ring)      │
  └─────────────────────────────────────────────────────────────┘

When a window is parked on special:minimized, Omadock generates a live visual preview tile between your pinned and running applications:

• 📸 Visual Window Previews: Displays a clean, static thumbnail of the window upon minimization.
• 🎯 1-Click Restore: Left-clicking any preview tile restores the window directly onto your currently active workspace.
• 📍 Origin Restoration: Right-click any tile to choose between Restore Here, Restore to Original Workspace, or Close.
• 📦 Stacked Group Cards: In "all" mode, multiple windows from the same application bundle into a stacked visual card with count badge.
• 🧩 Space-Saving Icon Collapse: Unpinned apps collapse into their preview tile when all windows are minimized, keeping the dock uncluttered.

Configure how clicking an active application icon behaves in omadock.json or via the Settings menu:

                         ┌─────────────────────────────────┐
                         │   Click On Focused Dock Icon    │
                         └──────────────┬──────────────────┘
                                        │
             ┌──────────────────────────┼──────────────────────────┐
             ▼                          ▼                          ▼
     [ Active Window ]           [ All Windows ]             [ Disabled ]
  (Sequential FIFO — default)  (Group Batch / Hide)        (Standard / Classic)

1. "active" (Default): Minimizes the active window and passes focus to the next instance.
2. "all" (Group Batch): Simultaneously minimizes all instances of the application in an atomic batch.
3. "off" (Disabled): Keeps all windows visible and cycles focus between open instances.

Omadock features Juan Pablo Zamora's raised-cosine falloff equation for fluid, Apple-style wave magnification:

$$\text{scale}(d) = 1 + (\text{peak} - 1) \cdot \frac{1 + \cos\left(\frac{\pi \cdot d}{R}\right)}{2} \quad \text{for } d \le R$$

• Wave Mode ("wave"): Dynamic slot growth where neighbor items smoothly expand with constant unmagnified home coordinates (zero feedback drift).
• Zoom Mode ("zoom"): Scales only the hovered icon in-place without shifting surrounding slots.
• Off ("off"): Clean, static dock geometry for minimal distraction.

Pin directories like ~/Downloads, ~/Projects, or custom paths directly to your dock:

• Recent Files Popover: 1-click reveals up to 16 newest files sorted chronologically with mimetype icons, file sizes, and relative times (Just now, 5m ago).
• Direct Opening: Click any file to launch with xdg-open or open the containing folder in your file manager.
• GTK Folder Dialog: Easily browse and attach custom folders from the Settings menu.

Organize applications into intelligent macOS / iOS-style folders directly on your dock:

• 2x2 Live Preview Grid: Folder icons render a dynamic micro-grid of contained application icons with live window indicator dots.
• Fluid Popover Tray: Clicking a folder opens a sleek, floating app tray with columns automatically scaled to content (2 to 4 columns).
• Drag-to-Group & Drag-to-Pin: Drag any dock icon onto another pinned app to instantly create a folder. Drag running unpinned apps to pin them directly into folders or dock slots.
• In-Place Title Editing: Click the folder title in the header to rename inline with instant configuration persistence.
• Drag-Out Extraction & Auto-Dissolution: Drag an icon out of the folder popover back onto the dock to unpin or extract. When only 1 app remains, the folder automatically dissolves back into a standard dock pin.

Zero-CPU hardware integration for removable media and USB storage:

• Kernel Udev Integration: Detects USB flash drives, SD cards, and external storage reactively via Linux udev and udisks2.
• Mountpoint & Storage Tooltips: Displays drive capacity, filesystem label, and mount status on hover.
• Contextual Eject & Unmount: 1-click or right-click context menu to safely unmount and eject removable drives with native desktop notifications.

Flexible screen placement tailored to your workflow:

• Bottom Alignment Modes: Position the dock at "center", "left", or "right" along the bottom edge.
• Dynamic Coordinate Compensation: Popovers, tooltips, and context menus automatically measure available screen margins and reposition themselves to prevent clipping against display boundaries.
• Smooth Cubic Transitions: Position shifts glide smoothly via hardware-accelerated cubic bezier animations.

Enable Settings → Placement & Alignment → Show on All Monitors (or "multiMonitor": true) to run a dock on every connected monitor:

• Per-Monitor Apps: Each dock shows the windows open on its own monitor, with pinned apps on every dock. A window dragged, or a workspace moved, to another monitor moves its icon to that monitor's dock. Turn off Only This Monitor's Apps ("perMonitorApps": false) to list every window on every dock.
• Minimized Tiles Follow Their Origin: A parked window's preview tile appears on the dock of the monitor it was minimized from, whichever dock minimized it.
• Hotplug Aware: Docks appear and disappear as monitors are connected or removed.
• Keybindings Act Where You Are: minimizeActive and restoreLast target the focused monitor's dock first; toggleVisibility, reveal and hide apply to every dock.

Deep Linux desktop and compositor integration:

• FreeDesktop Jump Lists: Right-click applications to access native quick actions parsed directly from .desktop files (e.g. New Incognito Window, New Document, Open Profile).
• Intelligent Zero-CPU Autohide: Employs mathematical 2D Axis-Aligned Bounding Box (AABB) intersection tests triggered strictly on Hyprland window movement events, keeping background CPU consumption at 0.00%.

Right-click the Omarchy logo or empty dock space to access deep customization:

Settings Menu	Appearance	Placement & Alignment	Behavior & Windows
Effects & Animations	Size & Spacing	Folders & Stacks	App Folders & Groups

• Shapes: Auto (Theme), Rounded, Round (Pill), Square.
• Opacity: Auto (Theme), 100%, 80%, 65%, 35%, 0% (Transparent Specular).
• Placement & Alignment: Center (Default), Left Aligned, Right Aligned along the screen edge.
• Color Presets: Theme Auto, Pure Black, Mocha, Deep Slate, Midnight Blue, Dark Navy, Emerald Forest, Velvet Ruby.
• Icon Sizing: Small ($28\text{px}$), Medium ($36\text{px}$), Large ($44\text{px}$), Extra Large ($52\text{px}$).
• App Folders & Groups: Automatic smart collections from running apps, drag-to-group, in-place title renaming, and column scaling.

Settings persist in ~/.config/omarchy/omadock.json and are editable live: