Release notes

What’s new.

New features, improvements, and fixes for TweakMouse.

Download for Mac Beta
1.0.0 BetaBuild 18Latest BetaDownload this version

TweakMouse 1.0.0 Beta 18

New

  • The window wheel has a gradient rim and a rotating entrance animation. Turn off the animation in the Interaction settings for the wheel.
  • After opening the window wheel with a three-finger tap, move all three fingers together or leave one finger down to select an action. Lift all fingers to confirm.

Improved

  • The top bar uses a native macOS switch for the global enable state.

Fixed

  • Two-finger title-bar tiling supports more windows with custom title bars or slow accessibility responses. Gesture feedback appears earlier, and live placement reduces repeated resize requests when the target window responds slowly.
1.0.0 BetaBuild 17Download this version

TweakMouse 1.0.0 Beta 17

Fixed

  • Restore Logitech extended buttons after disconnecting and reconnecting over Bluetooth.
  • Restore the previous hardware DPI when DPI control is turned off. The custom value is saved for next time.
1.0.0 BetaBuild 16Download this version

TweakMouse 1.0.0 Beta 16

Improve special-button wake recovery, mouse application-window switching and Maximize behavior. The Beta installer is signed and notarized; broader physical acceptance remains open.

Fixed

  • Retry delayed receiver/device readiness and incomplete special-button setup while preserving saved mappings and rejecting stale recovery work.
  • Let mouse Previous/Next Application Window actions work over content and titlebars as well as Dock icons; retain the application captured at button-down and the existing trackpad Dock scope.
  • Fill ordinary or tiled windows before restoring a remembered size. Only an already maximized window toggles restore, respecting screen-edge spacing.
  • Preserve native menu clicks, improve inactive auxiliary-window targeting, and move mouse-targeted native windows between desktops without changing their geometry.

Improved

  • Configure transition timing for individual mouse window-layout mappings and include more input and HID lifecycle evidence in user-exported diagnostics.
1.0.0 BetaBuild 15Download this version

TweakMouse 1.0.0 Beta 15

Improve Logitech Bolt gesture-button recovery and remove duplicate button entries. The Beta installer is signed and notarized; physical Bolt and broader hardware acceptance remain open.

Fixed

  • Retry incomplete Bolt control setup and revalidate gesture-button diversion when native Button 6 fallback appears.
  • Prevent inactive HID fields and duplicate ordinary/extended entries from adding extra assignment rows, while preserving existing device-bound mappings.
  • Preserve original reporting flags across retries so quitting can restore the device state.
1.0.0 BetaBuild 14Download this version

TweakMouse 1.0.0 Beta 14

Restore titlebar gestures in applications with many controls, including Jianying Pro, while keeping browser tabs and interactive controls protected. The Beta installer is signed and notarized; broader physical compatibility remains in acceptance.

Fixed

  • Restore titlebar gestures when a window exposes many content controls. Filter by pointer position before applying the tab-search traversal limit.
  • Keep browser tabs, close/tool buttons and content protected. Unresolved geometry, cancellation and failed queries still stop capture.
  • Preserve Beta 13 auxiliary-window compatibility, centered display labels, compact icon spacing and adaptive dividers.
1.0.0 BetaBuild 13Download this version

TweakMouse 1.0.0 Beta 13

More reliable Window Management in applications with auxiliary floating windows, plus clearer multi-display radial labels and adaptive dividers. The Beta installer is signed and notarized; broader physical compatibility remains in acceptance.

Fixed

  • Keep three-finger and mapped middle-button Window Management available when inactive nonmodal utility windows appear, including Jianying Pro. Direct window mappings use the same selection rules.
  • Retain the captured target as auxiliary windows appear or disappear. Modal or focused dialogs and unrecognized windows continue to block operations behind them.

Improved

  • Vertically center multi-display radial names and reduce icon-to-text spacing.
  • Use 10% black dividers in light appearance and 10% white dividers in dark appearance across full and compact radial panels.
1.0.0 BetaBuild 12Download this version

TweakMouse 1.0.0 Beta 12

More reliable trackpad window controls: close a window when minimization is unavailable, and center directly without a detour to its previous position. The Beta installer is signed and notarized; broader physical acceptance remains in progress.

Fixed

  • Fall back to the captured window’s Close control when minimization is unavailable or refused, including ZoogVPN. No Quit command is sent.
  • Keep close fallback behind gesture release, cancellation and window validity checks; continuing a downward swipe into bottom-half placement does not close the window.
  • Center directly at the final position while restoring remembered dimensions when needed. Repeating Center avoids an unnecessary move, including TweakMouse’s own window.
  • Preserve the current display and fixed window dimensions when centering.
1.0.0 BetaBuild 11Download this version

TweakMouse 1.0.0 Beta 11

Improved Logitech receiver and Bluetooth recovery after Mac sleep, with fewer duplicate button entries and existing assignments preserved. The Beta installer is signed and notarized; overnight hardware acceptance remains in progress.

Fixed

  • Restore advanced mouse-button setup after wake over a Logitech receiver, including when macOS retains the existing connection.
  • Restore direct Bluetooth button setup after wake and retry when the wheel-mode key is ready before the gesture key.
  • Prevent temporary fallback reports from adding duplicate button entries during recovery while keeping existing assignments.
  • Improve recovery when the Mac sleeps again or the mouse reconnects before setup finishes.
1.0.0 BetaBuild 10Download this version

TweakMouse 1.0.0 Beta 10

A customizable grid window panel, shared panel settings, and consistent action icons. The Beta installer is signed and notarized; broader hardware and compatibility testing remains in progress.

New

  • Customize grid cells in the same action editor as the radial menu: choose actions, rename cells, exchange them by dragging, clear a cell, or restore defaults.
  • Both editors always offer current-display and other-display pages, so you can configure another display before connecting it. Display changes preserve the selected page and unsaved edits. Runtime panels still use connected displays only.
  • Adjust radial diameter or grid width from 180 to 360 pt. Grid width defaults to 218 pt; show or hide text labels, with icons centered when labels are hidden.

Improved

  • Mouse action settings and trackpad options share one set of panel style, display scope, live-layout mode, transition duration and spacing settings. These remain accessible without a connected trackpad.
  • Show application icons in the trackpad excluded-applications list and refine grid cell backgrounds, icon sizes and page indicators in light and dark appearances.

Fixed

  • Unify window action icons across radial and grid panels, action menus and selected-action summaries, including Maximize and Restore.
  • Improve layouts for maximized Parallels Coherence guest windows by checking guest-window state and geometry, while preserving the position and size before the first layout for Restore.
1.0.0 BetaBuild 9Download this version

TweakMouse 1.0.0 Beta 9

A customizable trackpad radial menu, improved window layouts and action editing, and clearer feedback. The Beta installer is signed and notarized; broader hardware and compatibility testing remains in progress.

New

  • Customize the radial menu’s 18 sectors with system actions, application actions, applications/files/URLs, macros, or no action. Rename sectors, exchange them by dragging, and switch display pages when another display is available.
  • Use shared live-layout settings and adjustable transitions for mouse and trackpad window actions. Restore returns to the position and size before the first layout in the current sequence.
  • Cycle among eligible application windows with Dock gestures. Trackpad options are organized into Gesture, Layout, and Interaction pages.

Fixed

  • Improved window identity checks and Accessibility frame readback for applications with delayed acknowledgements or minimum-size constraints. Supported placement and restore actions remain available for movable fixed-size windows.
  • Recognize a same-window fullscreen overlay, including the tested QQ Music lyrics view, for the existing fullscreen exit pinch gesture.
  • Two-, three-, and four-part layouts place the available windows and leave unused slots empty. Unnecessary unavailable/size/count warnings are suppressed; real failures retain concise feedback.
  • Use the current Dock work area and avoid intermediate movement below the Dock. With automatic Dock hiding enabled, layouts align to the screen edge while preserving menu-bar space and configured window spacing.
  • Correct radial action icons, allow paused macro recordings to be saved, and show macro names in action summaries. Shortcut and action-specific controls share the settings editor design.
  • Shorten menu labels in all ten languages, confirm bulk gesture/combination clearing, and improve mouse action routing across device changes and held-button combinations.
1.0.0 BetaBuild 8Download this version

TweakMouse 1.0.0 Beta 8

Refined three- and four-finger window-menu activation and handling of identified resting thumb or palm contacts. The Beta installer is signed and notarized; broader device and compatibility testing remains in progress.

Fixed

  • Added contact timing and a brief stability check before opening the window menu with three or four fingers.
  • Existing two-finger movement, pinching, scrolling and dragging take priority over an extra accidental contact.
  • Identified stationary thumb or palm contacts are excluded from window-menu counting, allowing a fresh three- or four-finger chord while the background contact stays down.
  • The last operating finger can confirm or cancel the selection and rearm the next chord without requiring the identified palm contact to lift.
1.0.0 BetaBuild 7Download this version

TweakMouse 1.0.0 Beta 7

Wheel fixes and scrolling recovery when switching macOS user accounts, in a signed and notarized Beta. Broader compatibility testing for the stable release is still in progress.

Fixed

  • Fixed wheel settings being bypassed when macOS natural scrolling changes the direction of a physical mouse report.
  • Vertical wheel mappings and the Reverse setting now use physical direction consistently across user accounts, while preserving continuous trackpad scrolling.
  • Input processing pauses when a user switches away and resumes on return, resetting wheel gesture state and scroll animation resources.
  • Improved scroll recovery after display changes or waking the Mac, with native scrolling retained if smooth scrolling cannot start.
1.0.0 BetaBuild 6Download this version

TweakMouse 1.0.0 Beta 6

An updated disk image installer for the signed and notarized Beta, retaining the application features from Beta 5. Compatibility testing for the stable release is still in progress.

Improved

  • Centered the application icon, arrow, Applications shortcut and their names vertically in the installer window.
  • Refined the text-free installer background with standard and Retina representations and the TweakMouse volume icon.
1.0.0 BetaBuild 5Download this version

TweakMouse 1.0.0 Beta 5

A signed and notarized Beta for testing before the stable release. Compatibility testing across Macs, macOS versions and input devices is still in progress.

Improved

  • Improved background-window click handling for the left and right buttons. Compatibility depends on the target app's Accessibility support.
  • Updated SmartShift sensitivity to use the regular native slider and improved wheel-mode sheet sizing.

Fixed

  • Removed the version-history button from the up-to-date dialog. Release notes and version-specific installers are now archived on this page.