https://github.com/ahmetb/RectangleWin

Spectacle/Rectangle for Windows: Hotkey-driven window snapping for Windows 10/11.
https://github.com/ahmetb/RectangleWin

window-management window-manager windows windows-10

Last synced: about 2 months ago
JSON representation

Spectacle/Rectangle for Windows: Hotkey-driven window snapping for Windows 10/11.

• Host: GitHub
• URL: https://github.com/ahmetb/RectangleWin
• Owner: ahmetb
• License: apache-2.0
• Created: 2021-12-28T00:05:25.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2023-01-12T23:54:31.000Z (over 1 year ago)
• Last Synced: 2024-06-18T23:16:51.271Z (3 months ago)
• Topics: window-management, window-manager, windows, windows-10
• Language: Go
• Homepage:
• Size: 1.86 MB
• Stars: 167
• Watchers: 2
• Forks: 6
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# RectangleWin

A minimalistic Windows rewrite of macOS

[Rectangle.app](https://rectangleapp.com)/[Spectacle.app](https://www.spectacleapp.com/).

([Why?](#why))

A hotkey-oriented window snapping and resizing tool for Windows.

This animation illustrates how RectangleWin helps me move windows to edges

and corners (and cycle through half, one-thirds or two thirds width or height)

only using hotkeys:

![RectangleWin demo](./assets/RectangleWin-demo.gif)

## Install

1. Go to [Releases](https://github.com/ahmetb/RectangleWin/releases) and

   download the suitable binary for your architecture (typically x64).

2. Launch the `.exe` file. Now the program icon should be visible on system

   tray!

3. Click on the icon and mark as "Run on startup" to make sure you don't have

   to run it every time you reboot your PC.

## Keyboard Bindings

- **Snap to edges** (left/right/top/bottom ½, ⅔, ⅓):

  - Win + Alt + ←→↑↓

  - Press multiple times to alternate between ½, ⅔ and ⅓.

- **Corner snapping**

  - Win + Ctrl + Alt + ←: top-left ½, ⅔ and ⅓

  - Win + Ctrl + Alt + ↑: top-right ½, ⅔ and ⅓

  - Win + Ctrl + Alt + ↓: bottom-left ½, ⅔ and ⅓

  - Win + Ctrl + Alt + →: bottom-right ½, ⅔ and ⅓

- **Center window** on the display: Win+Alt+C

- **Maximize window**: Win+Shift+F

  (Obsolete since Windows natively supports Win+↑)

- **Always On Top (toggle)**: Win+Alt+A

## Why?

It seems that no window snapping utility for Windows is capable of letting

user snap windows to edges or corners in {half, two-thirds, one-third} sizes

using configurable **shortcut keys**, and center windows in a screen like

Rectangle.app does, so I wrote this small utility for myself.

I've tried the native Windows shortcuts and PowerToys FancyZones and they

are not supporting corners, alternating between half and one/two thirds, and

are not offering enough hotkey support.

## Roadmap

- Configurable shortcuts: I don't need these and it will likely require a pop-up

  UI, so I will probably not get to this.

## Development (Install from source)

With Go 1.17+ installed, clone this repository and run:

```sh

go generate

GOOS=windows go build -ldflags -H=windowsgui .

```

The `RectangleWin.exe` will be available in the same directory.

## License

This project is distributed as-is under the Apache 2.0 license.

See [LICENSE](./LICENSE).

If you see bugs, please open issues. I can't promise any fixes.