Multi-Monitor Guide and Status

[BarutSRB]

Multi-Monitor Usage Guide

Multi-monitor support is available but still evolving. This guide explains how to use it correctly in its current state and outlines known limitations.

Current Capabilities

• Multiple monitors are supported with independent workspace assignments.
• Each workspace is rendered on exactly one monitor.
• Different workspaces can use different layouts.
• Workspaces do not need to be persistent.
• You can move windows between different monitor's workspaces

Required Monitor Arrangement

• Monitors must be arranged exactly as shown in the reference layout.
• The leftmost monitor must be configured as the top (main) monitor.
• This configuration is required for correct focus, workspace traversal, and mouse movement.

Workspace Assignment Rules

• You must explicitly:

  1. Assign a layout to a workspace
  2. Bind that workspace to a specific monitor

• A workspace cannot be shown on two monitors at the same time.

Mouse Configuration (Strongly Recommended)

• Enable mouse wrap.
• This allows the cursor to move naturally left-to-right across monitors.
• Without mouse wrap, cross-monitor navigation will feel weird due to how the arrangment of monitors is required within macOS system settings.

Known Limitations

• Some multi-monitor commands are only partially wired.
• Certain commands may be removed or merged in future releases to reduce complexity.
• Monitor-specific behaviors may change as the command model is simplified.

Multi-monitor support should currently be considered usable but not finalized. Expect breaking changes as the model is refined.