Skip to content

v0.1.1

Choose a tag to compare

View all tags
@github-actions github-actions released this 28 May 01:44
· 139 commits to main since this release
v0.1.1
4d19d1d

What's new in 0.1.1

  • Software updates now work end to end. Sparkle is fully wired up — Tatami checks for and installs updates in the background. Pick the frequency (hourly / daily / weekly) or check manually from Settings or the menu bar. (0.1.0 shipped the appcast but didn't actually wire the updater.)
  • New About tab — version, creator, and open-source credits (FlashSpace, yabai, and the libraries Tatami is built with).
  • Under the hood: settings now use Perception's observation, dependency clients adopt @DependencyClient, and an unused autoFocusBlacklist setting was removed.

Tatami is a macOS workspace manager with yabai-style window tiling — group your apps into virtual workspaces you switch with a keystroke or trackpad swipe, and have their windows tiled automatically. No SIP changes, no shell scripting.

Features

Tiling (yabai-style BSP)

  • Automatic binary space partitioning with a dwindle (spiral) layout
  • Directional focus / swap / resize (vim-like h j k l)
  • Zoom a window to fill the workspace, toggle split orientation
  • Rotate, mirror, balance; drag-to-swap and live resize sync
  • Configurable inner / outer gaps

Workspaces

  • Per-workspace app assignments; switch by hotkey, swipe, or "recent"
  • Loop-around, skip-empty, and follow-app-focus options
  • Auto-open assigned apps on activation
  • Multi-display (pin a workspace or follow apps dynamically)
  • Floating apps that never tile

Focus & interface

  • focus-follows-mouse / mouse-follows-focus, optional cursor hide
  • Menu bar item with the active workspace (icon + name)
  • On-screen HUD on switch, per-workspace SF Symbol icons
  • skhd-style shortcut syntax, plain-TOML config, scripting CLI

Install

brew install --cask pangmo5/tap/tatami

Or download the signed & notarized .dmg below.

Requirements

  • macOS 14.0 or later
  • Accessibility permission (System Settings → Privacy & Security → Accessibility)

See docs/CONFIGURATION.md for the full config.toml reference.

Inspired by FlashSpace and yabai. Licensed under GPL-3.0.

Assets 3
Loading