{"id":15194404,"url":"https://github.com/ahmetb/rectanglewin","last_synced_at":"2025-08-20T18:34:08.232Z","repository":{"id":45240595,"uuid":"442302775","full_name":"ahmetb/RectangleWin","owner":"ahmetb","description":"Spectacle/Rectangle for Windows: Hotkey-driven window snapping for Windows 10/11.","archived":false,"fork":false,"pushed_at":"2023-01-12T23:54:31.000Z","size":1949,"stargazers_count":191,"open_issues_count":3,"forks_count":10,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-12-19T14:08:09.912Z","etag":null,"topics":["window-management","window-manager","windows","windows-10"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ahmetb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-12-28T00:05:25.000Z","updated_at":"2024-12-19T00:10:09.000Z","dependencies_parsed_at":"2023-02-09T13:46:24.044Z","dependency_job_id":null,"html_url":"https://github.com/ahmetb/RectangleWin","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmetb%2FRectangleWin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmetb%2FRectangleWin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmetb%2FRectangleWin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmetb%2FRectangleWin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ahmetb","download_url":"https://codeload.github.com/ahmetb/RectangleWin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230445927,"owners_count":18227060,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["window-management","window-manager","windows","windows-10"],"created_at":"2024-09-27T23:00:27.366Z","updated_at":"2024-12-19T14:08:18.196Z","avatar_url":"https://github.com/ahmetb.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RectangleWin\n\nA minimalistic Windows rewrite of macOS\n[Rectangle.app](https://rectangleapp.com)/[Spectacle.app](https://www.spectacleapp.com/).\n([Why?](#why))\n\nA hotkey-oriented window snapping and resizing tool for Windows.\n\nThis animation illustrates how RectangleWin helps me move windows to edges\nand corners (and cycle through half, one-thirds or two thirds width or height)\nonly using hotkeys:\n\n![RectangleWin demo](./assets/RectangleWin-demo.gif)\n\n## Install\n\n1. Go to [Releases](https://github.com/ahmetb/RectangleWin/releases) and\n   download the suitable binary for your architecture (typically x64).\n\n2. Launch the `.exe` file. Now the program icon should be visible on system\n   tray!\n\n3. Click on the icon and mark as \"Run on startup\" to make sure you don't have\n   to run it every time you reboot your PC.\n\n## Keyboard Bindings\n\n- **Snap to edges** (left/right/top/bottom ½, ⅔, ⅓):\n  - \u003ckbd\u003eWin\u003c/kbd\u003e + \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003e\u0026larr;\u003c/kbd\u003e\u003ckbd\u003e\u0026rarr;\u003c/kbd\u003e\u003ckbd\u003e\u0026uarr;\u003c/kbd\u003e\u003ckbd\u003e\u0026darr;\u003c/kbd\u003e\n  - Press multiple times to alternate between ½, ⅔ and ⅓.\n\n- **Corner snapping**\n  - \u003ckbd\u003eWin\u003c/kbd\u003e + \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003e\u0026larr;\u003c/kbd\u003e: top-left ½, ⅔ and ⅓\n  - \u003ckbd\u003eWin\u003c/kbd\u003e + \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003e\u0026uarr;\u003c/kbd\u003e: top-right ½, ⅔ and ⅓\n  - \u003ckbd\u003eWin\u003c/kbd\u003e + \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003e\u0026darr;\u003c/kbd\u003e: bottom-left ½, ⅔ and ⅓\n  - \u003ckbd\u003eWin\u003c/kbd\u003e + \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003e\u0026rarr;\u003c/kbd\u003e: bottom-right ½, ⅔ and ⅓\n\n- **Center window** on the display: \u003ckbd\u003eWin\u003c/kbd\u003e+\u003ckbd\u003eAlt\u003c/kbd\u003e+\u003ckbd\u003eC\u003c/kbd\u003e\n\n- **Maximize window**: \u003ckbd\u003eWin\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003eF\u003c/kbd\u003e\n  (Obsolete since Windows natively supports \u003ckbd\u003eWin\u003c/kbd\u003e+\u003ckbd\u003e\u0026uarr;\u003c/kbd\u003e)\n\n- **Always On Top (toggle)**: \u003ckbd\u003eWin\u003c/kbd\u003e+\u003ckbd\u003eAlt\u003c/kbd\u003e+\u003ckbd\u003eA\u003c/kbd\u003e\n\n## Why?\n\nIt seems that no window snapping utility for Windows is capable of letting\nuser snap windows to edges or corners in {half, two-thirds, one-third} sizes\nusing configurable **shortcut keys**, and center windows in a screen like\nRectangle.app does, so I wrote this small utility for myself.\n\nI've tried the native Windows shortcuts and PowerToys FancyZones and they\nare not supporting corners, alternating between half and one/two thirds, and\nare not offering enough hotkey support.\n\n## Roadmap\n\n- Configurable shortcuts: I don't need these and it will likely require a pop-up\n  UI, so I will probably not get to this.\n\n## Development (Install from source)\n\nWith Go 1.17+ installed, clone this repository and run:\n\n```sh\ngo generate\nGOOS=windows go build -ldflags -H=windowsgui .\n```\n\nThe `RectangleWin.exe` will be available in the same directory.\n\n## License\n\nThis project is distributed as-is under the Apache 2.0 license.\nSee [LICENSE](./LICENSE).\n\nIf you see bugs, please open issues. I can't promise any fixes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmetb%2Frectanglewin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fahmetb%2Frectanglewin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmetb%2Frectanglewin/lists"}