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/rill

About

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.

Discussion