Skip to content

v1.3.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 06 Jun 11:05
· 79 commits to main since this release
v1.3.0
570d369

⚠️ Breaking Changes

  • [[floatingApps]] is now [[sharedApps]] — configs migrate automatically on first launch: each floating entry becomes a shared app with floating = true. Shared apps are part of every workspace — tiled into each layout by default, or floating everywhere. Manage them in Workspaces → Shared Apps; dotfiles that template the config should switch to the new key.
  • Floating windows now need the Screen Recording permission — they stay above the tiles via ScreenCaptureKit mirrors, and without the grant they won't stay on top. Grant it in Settings → General → Permissions, then relaunch.

New

  • Floating windows that stay above the tiles — without disabling SIP. Mark any app as floating per workspace (the Float toggle next to Auto-open, or the toggleFloating hotkey): its windows stay untiled and are kept on top by mirroring them onto Tatami-owned ScreenCaptureKit panels. Reach for a floating window and the real one is handed back to you; while a floating app has focus the mirrors (and the screen-recording indicator) get out of the way. Multiple floating windows stack by focus recency.
  • Shared Apps editor in the Workspaces sidebar — add/remove shared apps and flip their Float toggle, presented like a special workspace.
  • Settings reorganized into a System Settings-style sidebar (General, Tiling, Focus & Mouse, Workspaces, Shortcuts, Appearance), with a new Screen Recording row under Permissions.
  • Shared hotkeys — toggleSharedFloating floats the focused app everywhere (joins Shared Apps as floating if needed; toggling off flips it to shared tiled), and toggleAppInSharedApps adds/removes the focused app in Shared Apps.
  • Per-action HUD — floating changes, app membership, tiling pause, fullscreen zoom, and balance now show a brief overlay, each individually toggleable in Settings → Appearance → Overlay (plus the master switch and a configurable duration). Un-floating an app that stays in its workspace / Shared Apps shows a follow-up hint with the shortcut that removes it entirely.
  • What's New on first launch after an update — a one-time window summarizing setup-affecting changes (with a Screen Recording grant button when needed) and feature highlights; the full changelog is also viewable from About → View Changelog.
  • Missing Screen Recording no longer fails silently: the first activation that needs floating mirrors shows the system prompt and a warning HUD pointing at the Settings row.
  • Auto-open apps reopen on workspace re-entry when their window was closed, not just on first activation.
  • Fixed-size windows (e.g. the iOS Simulator) can float — resizability is only required for tiling.
  • Floating windows' marker dots are always visible (not just on the focused window), and dots follow window drags with a smooth glide.

Fixes

  • HUD overlays sometimes vanished instantly instead of fading out — the panel's window-alpha animation only ran reliably once per launch; the fade now runs on the content view.

Install / Update

  • Homebrew: brew upgrade --cask tatami
  • Direct: Tatami-1.3.0.dmg
  • In-app: Sparkle will pick this up on its next check.
Assets 4
Loading