RectangleWin

command module
v0.2.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 11, 2023 License: Apache-2.0 Imports: 14 Imported by: 0

README

RectangleWin

A minimalistic Windows rewrite of macOS Rectangle.app/Spectacle.app. (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

Install

  1. Go to 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+↑)

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:

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.

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

Documentation

Overview

Copyright 2022 Ahmet Alp Balkan

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL