Skip to content

amethyst

Amethyst Window Manager Integration

This directory provides voice control integration for Amethyst, a popular automatic tiling window manager for macOS. By mapping natural spoken commands to Amethyst's keyboard shortcuts, users can seamlessly manage, resize, and tile application windows completely hands-free.

Configuration and Commands

The integration is driven by a single key configuration file:

  • amethyst.talon: Defines the context-aware Talon voice commands that map to Amethyst's keyboard shortcuts.

These commands trigger when Amethyst is running and allow the user to control the windowing environment:

  • Window Navigation: Cycle focus through active tiled windows using window next (maps to alt-shift-j) and window previous (maps to alt-shift-k).
  • Layout Modification: Quickly switch layout styles using commands like window full (fullscreen/maximized), window tall (standard tall layout), or window middle (3-column layout where the main pane is centered).
  • Sizing Control: Adjust the ratio of the master pane using window grow (alt-shift-l) and window shrink (alt-shift-h).
  • Window Management: Promote a window to the primary position using window move main (alt-shift-enter), toggle a window's floating status with window float (alt-shift-t), or force Amethyst to recalculate and refresh the layout with window reevaluate (alt-shift-z).