Home

minfwm Wiki

Welcome to the minfwm documentation!

minfwm is an infinite 2D canvas window manager for macOS 14+. It replaces the concept of traditional virtual desktops (Spaces) with a single continuous 2D surface. You can pan anywhere, zoom out for an overview with optional static window previews, organize windows freely, and navigate quickly with trackpad gestures and keyboard shortcuts.

Documentation Pages

• Getting Started: Requirements, installation, permissions, starting the daemon, and default shortcuts.
• Configuration: Guide to configuring shortcuts, trackpad sensitivity, snapping, animations, and overview previews in minfwm.toml.
• Yabai Integration: Why the Yabai Scripting Addition is required, how to build and load it, and SIP prerequisites.
• Architecture: High-level overview of core geometry, macOS platform adapters, and IPC protocol.
• Development: Building from source, testing with CTest, and developer tools (dev-update).
• Releases: Versioning scheme, upgrading releases, and checking installed version.

Requirements at a Glance

1. macOS 14+ (Sonoma or newer).
2. Accessibility Permission: Required for window discovery, focus tracking, and coordinate mapping.
3. Disabled System Integrity Protection (SIP): Necessary to load the Yabai Scripting Addition.
4. Compatible Yabai Scripting Addition: Allows windows to be positioned smoothly offscreen and above the menu bar. See the Yabai Integration guide for simple setup instructions.