Rill
Native, customizable desktop bar with live workspaces and TOML themes
- Category
- Status Bar
- WM Type
- —
- License
- free
- Open Source
- Yes
- Keybindings
- Yes
- Scripting
- Yes
- Last Update
- 2026-11-08
Features
- AeroSpace, OmniWM and yabai Workspaces
- Native System Controls
- TOML Config With Live Reload
- Top, Bottom, Left or Right Placement
- Eight Bundled Themes
- Command, Stream and Event Modules
- Plugins and UI Extensions
- SF Symbols, No Nerd Font Needed
- VoiceOver and Reduce Motion Support
Install
brew tap AleckAstan/rill && brew install --cask AleckAstan/rill/rillAbout
Rill is a configurable native desktop bar for macOS. You arrange built-in controls and live workspaces in TOML, choose from multiple layouts and themes, and add custom data through scripts, plugins, or extensions. It integrates with AeroSpace, OmniWM, and yabai, and its built-in modules work without a window manager.
Who It's For
Rill is for Mac users on Apple Silicon who want a Waybar- or SketchyBar-style desktop bar, but built from native controls and set up in one TOML file instead of a folder of shell scripts. It suits AeroSpace, OmniWM, and yabai users who want live workspace switching in their bar. It also works for people who don't run a tiling window manager at all and just want a cleaner, themeable bar with system controls.
How It Works
Rill is a native macOS app that draws one or more "surfaces": bars placed at the top, bottom, left, or right edge, on one display or all of them. Each surface has start, center, and end slots, and each slot lists module IDs that point to [[modules]] tables in the config. The built-in modules are native controls: calendar, application and Apple menus, Wi-Fi, Bluetooth, output volume, microphone, keep awake, battery, CPU, and RAM. They need no scripts and no window manager, and they use system fonts and SF Symbols, so you don't need a Nerd Font. Keyboard access, VoiceOver, and Reduce Motion work the same way they do in the native controls.
Workspace modules talk to AeroSpace, OmniWM, or yabai to show and switch workspaces live; with AeroSpace and OmniWM they can also show app icons. For custom data, Rill offers command, stream, and event modules, packaged plugins, and experimental rich UI extensions (API v2) for notch and edge widgets, built with the RillExtensionKit SDK that ships in the repo. Rill watches the config file, so saving it reloads the bar. If an edit is invalid, the last working bar stays on screen.
Configuration
The config lives at ~/.config/rill/config.toml. This is a surface layout from the README. Each ID refers to a [[modules]] entry:
# ~/.config/rill/config.toml
[[surfaces]]
start = ["spaces", "frontmost"]
center = ["clock"]
end = ["cpu", "memory", "wifi", "volume", "battery"]
Styles include continuous bars, individual capsules, glass, and Convex Style. The bundled themes are Convex Style, Catppuccin-inspired, Mono Minimal, Tokyo Night Pills, Gruvbox Blocks, Nord Glass, Everforest Rail, and Latte Bottom.
Compared to Alternatives
The README names Waybar and SketchyBar as inspirations. SketchyBar is a general-purpose bar you build mostly with your own scripts. Rill puts native built-in controls first and keeps scripts, plugins, and extensions for custom data. Compared to simple-bar, which runs as an Übersicht widget, Rill is a standalone app, and it supports OmniWM alongside AeroSpace and yabai. Rill is a young project, though, and doesn't have the community configs and plugin ecosystem that SketchyBar has built up.
Requirements
- macOS 14 or later, Apple Silicon only
- Liquid Glass styling needs macOS 26 or later and falls back to translucent styling on older systems
- OmniWM integration needs macOS 26 or later
- Releases are locally signed and not notarized, so macOS may block the first launch
- Early-stage project: v0.2.0 (November 2026) is the latest release
Getting Started
brew tap AleckAstan/rill
brew install --cask AleckAstan/rill/rill
rillctl init
open -a Rill
rillctl init writes a starter config to ~/.config/rill/config.toml and won't overwrite an existing one. If macOS blocks the app on first launch, follow the first-launch instructions linked from the README. A DMG install guide is also available. From there, edit the surfaces and modules, or start from one of the bundled themes. The README links guides for custom producers, plugins, and UI extensions.