{"id":39028837,"url":"https://github.com/bbmorten/windows-position-manager","last_synced_at":"2026-01-17T17:35:44.737Z","repository":{"id":329778379,"uuid":"1112157593","full_name":"bbmorten/windows-position-manager","owner":"bbmorten","description":"Window Position Manager is a macOS utility built with Electron that solves the frustration of rearranging windows every time you disconnect your monitor or reboot.","archived":false,"fork":false,"pushed_at":"2025-12-09T15:15:58.000Z","size":772,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-23T06:39:20.366Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bbmorten.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-08T08:26:54.000Z","updated_at":"2025-12-09T15:16:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bbmorten/windows-position-manager","commit_stats":null,"previous_names":["bbmorten/windows-position-manager"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/bbmorten/windows-position-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbmorten%2Fwindows-position-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbmorten%2Fwindows-position-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbmorten%2Fwindows-position-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbmorten%2Fwindows-position-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bbmorten","download_url":"https://codeload.github.com/bbmorten/windows-position-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbmorten%2Fwindows-position-manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28513474,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T13:38:16.342Z","status":"ssl_error","status_checked_at":"2026-01-17T13:37:44.060Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-01-17T17:35:44.628Z","updated_at":"2026-01-17T17:35:44.721Z","avatar_url":"https://github.com/bbmorten.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Window Position Manager (WPM)\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/robot-logo.png\" alt=\"WPM Logo\" width=\"150\" height=\"150\"\u003e\n  \u003ch3\u003eSave and Restore Your Perfect Layout\u003c/h3\u003e\n\u003c/div\u003e\n\n**Window Position Manager** is a macOS utility built with Electron that solves the frustration of rearranging windows every time you disconnect your monitor or reboot. \n\nIt remembers exactly where your windows are—across multiple monitors and Mission Control spaces—and puts them back for you with a single click.\n\n## ✨ Features\n\n- **Multi-Monitor Support**: Correctly handles external displays and remembers window coordinates relative to specific screens.\n- **Spaces / Mission Control Support**: Can automatically swipe through your desktop spaces to save and restore windows on every virtual desktop.\n- **Profiles**: Create as many presets as you need (e.g., \"Work\", \"Home\", \"Streaming\").\n- **App Launching**: If an app is closed when you restore a layout, WPM can automatically launch it for you.\n- **Smart Logic**: Prioritizes window bundle IDs but falls back to app names if necessary.\n\n## 🚀 How It Works\n\n### Saving a Profile\n1. Arrange your windows exactly how you like them.\n2. Open Window Position Manager.\n3. Enter a name for your profile (e.g., \"Deep Work\").\n4. Click **Save Profile**.\n\n\u003e **Note**: For multi-space saving, check the \"Save all spaces\" box. The app will take control of your screen and swipe through each space to capture window data. **Please do not touch the mouse or keyboard during this process.**\n\n### Restoring a Profile\n1. Open the dashboard.\n2. Find your desired profile card.\n3. Click **Restore Layout**.\n4. Watch as your windows snap back into place!\n\n## 🛠️ Installation \u0026 Development\n\n### Prerequisites\n- macOS (tested on macOS Sequoia/Sonoma)\n- Node.js \u0026 npm\n\n### Running Locally\n```bash\n# Clone the repository\ngit clone https://github.com/bbmorten/windows-position-manager.git\n\n# Install dependencies\nnpm install\n\n# Start the application\nnpm start\n```\n\n### Building for Production\nTo create a standalone `.dmg` installer:\n\n```bash\nnpm run dist\n```\nThe output file will be in the `dist/` directory.\n\n## 🔒 Permissions\nOn first launch, macOS will ask for **Accessibility Permissions**. This is required for the app to query window positions and move them.\n1. Go to **System Settings \u003e Privacy \u0026 Security \u003e Accessibility**.\n2. Toggle the switch for **Window Position Manager** (or your terminal if running locally).\n\n## 📝 License\nISC\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbmorten%2Fwindows-position-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbbmorten%2Fwindows-position-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbmorten%2Fwindows-position-manager/lists"}