Skip to content

SnapBack v0.6.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 06 Jul 10:28
v0.6.0
76c4285
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Added

  • Auto-restore on dock, undock, and wake: display changes are debounced
    and the matching profile is restored per the Auto-Restore Mode setting
    (Automatic / Prompt / Disabled) — the setting previously had no effect.
  • Menubar minimap: the dropdown opens with a to-scale map of the current
    display arrangement with the active profile's saved windows drawn in;
    clicking it restores the profile.
  • Cyclic snapping walks screens column by column: pressing Left/Right on
    an already-snapped window carries it to the near half of the adjacent
    screen, so repeated presses traverse the whole setup half-by-half.
  • Hotkeys cheat sheet in the menubar, derived from the action registry.
  • One-line installer (scripts/install.sh).
  • CI: syntax check + 59-test plain-Lua suite on every push and PR.

Changed

  • Rebranded AutoArrange → SnapBack: new URL scheme hammerspoon://snapback
    (legacy windowlayout still works), storage moved to ~/.hammerspoon/snapback/
    with automatic one-time migration, menubar SB:.
  • Internals split into focused modules (profile store, snap geometry, smart
    matching, action registry, minimap) with the pure logic under test.

Fixed

  • Menubar menu no longer freezes into a static snapshot after changing
    Auto-Restore mode.
  • Up/Down hotkeys now snap to top/bottom halves, matching the menu (they
    previously maximized/minimized while the menu items snapped).
  • Fuzzy window matching no longer lets titles that normalize to nothing
    (clocks, counters) match any window at high confidence.
  • All hs.spaces calls are guarded — Spaces trouble on newer macOS degrades
    a restore instead of aborting it, and failures are reported in the alert.
  • Switching profiles validates the name, so a Stream Deck URL typo can't
    activate a brand-new empty profile.
  • Snap-cycle detection uses a sub-second clock; the 2-second window is real.
  • Removed the disabled drag-to-edge watcher (unsafe as written) and the
    broken "Edit Config File..." menu item (now "Open Data Folder...").

Installation

  1. Download SnapBack.spoon.zip from the assets below and unzip it.
  2. Double-click SnapBack.spoon to install it (Hammerspoon will handle this automatically).
  3. Or manually move SnapBack.spoon to ~/.hammerspoon/Spoons/.
  4. Add the following to your ~/.hammerspoon/init.lua:
hs.loadSpoon("SnapBack")
spoon.SnapBack:start()
  1. Reload Hammerspoon.

Full Changelog: v0.5.0...v0.6.0

Assets 3
Loading