wrangler

Wrangler

Wrangler is an open-source window organizer designed specifically for macOS, providing an intuitive solution for managing application windows. It seamlessly integrates interactive grid snapping, edge drop zones, and automated tiling features, enhancing productivity while maintaining system security.

Key Features

• Interactive Grid Overlay: Trigger the grid HUD using ⌥ Space to visually position windows by clicking and dragging across the grid cells. This feature offers real-time feedback with a translucent blueprint of the intended window arrangement.

• Snap Zones: Enable drag-and-drop functionality by moving windows to the screen edges or corners, resulting in predefined layouts ideal for ultrawide displays. Layout options include:

  • 50% / 50% Split: Divide the screen into two equal halves.
  • Three Columns: Create a tri-pane layout.
  • Center Focus: Arrange windows with a prominent center.
  • Four Corners: Utilize all four quarters of the screen.

• Automated Window Tiling: Execute window organization through ⌃ ⌥ T, creating a balanced layout using Binary Space Partitioning (BSP). This automatic feature scales and arranges windows, ensuring no overlap while maintaining focus on the active application.

• Multi-Display Management: Effortlessly move windows across multiple displays while preserving their dimensions. Use ⌃ ⌥ → to shift to the next screen and ⌃ ⌥ ← for the previous one.

• Width Cycling: Cycle through width presets for windows on multiple presses, offering flexible arrangements like 1/2, 2/3, and 1/3 widths.

• Dynamic Stage Manager Clearance: Automatically adjusts window margins when macOS Stage Manager thumbnails are active, preventing obstruction of the stage strip.

• In-App Auto-Updates: Keep Wrangler updated with periodic checks for new versions available on GitHub Releases, facilitating easy one-click updates.

Keyboard Shortcuts

Wrangler supports customizable keyboard shortcuts for various actions, including:

All shortcuts can be modified in the settings, providing a tailored user experience.

Robust Preference Management

Wrangler’s preferences allow users to adjust various settings through a comprehensive sidebar, including:

• Snap zone configurations, grid sizes, margins, and layouts.
• Options to customize shortcut keys and functional behaviors.
• Exclude specific applications from window management, ensuring smooth interaction with utility tools.

Command Line Interface (CLI) Automation

Wrangler includes a headless CLI for advanced automation, enabling users to perform various tasks through simple commands, such as checking permissions, listing display geometries, and managing window layouts programmatically.

# Check permissions
swift run wrangler-cli check-perm

# List connected displays
swift run wrangler-cli screens

# Snap to standard presets
swift run wrangler-cli snap left-half

Conclusion

Wrangler is a sophisticated window management solution for macOS that provides users with a balance of control and automation. By simplifying window arrangement and leveraging the power of macOS’s native accessibility features, it enhances multi-tasking efficiency without compromising system integrity.