Perch

1.2.0 2026-10-31

Added

• Rule for Active Window: saves where the focused window is now as a rule without touching other rules, from the menu or a global shortcut. The menu shows the app and title of that window below the item. An existing rule for that window is updated; a specific rule is placed before the app's broader ones so it takes effect.

Fixed

• Popups such as browser sign-in windows are left alone instead of being stretched to the main window's frame: a new window that opens next to an existing window of the app and is less than half its area keeps the size and place the app gave it.

1.1.0 2026-10-15

Added

• Russian localization. Perch follows the system language, or the language set for it in System Settings → General → Language & Region → Applications.
• Russian website at https://realsweb.com/Perch/ru/ with a language switch; About Perch links to the page in the app's language.

Changed

• The settings window shows app names as Finder does, localized.

1.0.0 2026-10-15

First release.

Window placement

• Rules per app with an optional window-title regex; the first matching rule wins.
• Placement modes: exactFrame (relative to the display's visible area), displayOnly (scales position and size to the target display, so moving back and forth restores the frame) and fill.
• Display profiles keyed by the set of connected displays, identified by vendor/model/serial; exact match first, then the most specific subset, with an empty profile as the catch-all.
• New windows are placed when they appear and re-placed on every move/resize during a configurable enforcement window (default 2 s), so apps that reposition themselves (VSCode) end up where the rule says.
• Rules are re-applied after display changes, including sleep and wake.
• Windows on other Spaces are caught up when their Space becomes active.
• Windows skipped because they were unreadable or minimized are re-checked after 2, 7 and 17 s.
• Moves that leave the size off target (cross-display moves) are retried once.
• Manual moves stick: config edits only touch windows whose rule changed.

Snapshot

• Turns the current window layout into exactFrame rules for the current display set.
• Apps with several windows get stable title patterns: the VSCode workspace, the Chrome profile suffix, or the exact title as a last resort.
• Keeps existing rules that no visible window matches (e.g. windows on other Spaces).

Config

• Human-readable JSON in ~/Library/Application Support/Perch/config.json, reloaded when it changes; parse errors are shown with the path of the offending value while the last valid config stays in effect.
• Config window: view everything and edit rules (enable, title regex, display, mode, order, delete, pin to the current window position), profiles (create for current displays, rename, delete), timings, excluded apps and global shortcuts.
• Excluded apps that Perch never moves and Snapshot skips.
• Global shortcuts for Apply Rules Now and Snapshot, layout-independent.

App

• Menu bar app with Apply Rules Now, Snapshot, Open Config, Displays, Launch at Login and About Perch (icon, version, description and a link to the website).
• Accessibility permission check that picks up the grant without a restart.
• App icon and a matching template menu bar icon.
• Persisted log summary for every pass, e.g. applyAll (displays changed): 12 windows: 0 moved, 12 in place.
• Build with make: app bundle, self-signed code signing (keeps the Accessibility grant across rebuilds), install to ~/Applications, encrypted backup and restore of the signing identity.
• Website at https://realsweb.com/Perch with the download, install steps and this changelog (make site builds it).