Skip to content

Latest commit

 

History

History
57 lines (37 loc) · 1.48 KB

README.md

File metadata and controls

57 lines (37 loc) · 1.48 KB
Raw

shimmy

Build

Shimmy is a lightweight utility designed for macOS users who need quick and precise control over their window positions. It allows users to nudge windows in any direction using customisable global keyboard shortcuts. Unlike full-fledged window management tools, Shimmy focuses on providing simple directional adjustments, making it a perfect companion to other window management solutions.

shimmy-cap.mp4

Requirements

  • macOS
  • Go 1.22.1
  • A C compiler (to build)

Installation

  1. git clone the repository
  2. Build the binary with go build

Usage

Running the binary in the terminal activates the following global shortcuts:

  • Cmd + Shift + Q - Quit the application
  • Cmd + Shift + Up - Move active window up
  • Cmd + Shift + Down - Move active window down
  • Cmd + Shift + Left - Move active window left
  • Cmd + Shift + Right - Move active window right

Run in the foreground:

# Set movement distance to 10 pixels (default)
./shimmy -p 10

Run in the background:

nohup ./shimmy -p 10 &

Future development

  • Add support for custom keybinds
  • Run in the background as a menu bar app

Related Projects

  • Rectangle - A window management app for macOS.
  • robotgo - Go Native cross-platform system automation.