{"id":21698625,"url":"https://github.com/theohbrothers/position-explorerwindow","last_synced_at":"2025-04-12T12:42:03.699Z","repository":{"id":50778095,"uuid":"114087906","full_name":"theohbrothers/Position-ExplorerWindow","owner":"theohbrothers","description":"Opens, resizes, and arranges multiple Explorer windows at specified paths in a grid fashion to fit a screen, or multiple screens.","archived":false,"fork":false,"pushed_at":"2025-02-13T11:22:35.000Z","size":2676,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-26T07:22:11.895Z","etag":null,"topics":["automation","explorer","grid","module","organization","position","powershell","pwsh","windows","windows-explorer"],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theohbrothers.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-12-13T07:20:31.000Z","updated_at":"2025-02-13T11:22:39.000Z","dependencies_parsed_at":"2024-06-16T18:37:55.069Z","dependency_job_id":"d3af01ac-8b2b-42a2-8c13-cd73fc3ffd2f","html_url":"https://github.com/theohbrothers/Position-ExplorerWindow","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theohbrothers%2FPosition-ExplorerWindow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theohbrothers%2FPosition-ExplorerWindow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theohbrothers%2FPosition-ExplorerWindow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theohbrothers%2FPosition-ExplorerWindow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theohbrothers","download_url":"https://codeload.github.com/theohbrothers/Position-ExplorerWindow/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248568828,"owners_count":21126109,"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":["automation","explorer","grid","module","organization","position","powershell","pwsh","windows","windows-explorer"],"created_at":"2024-11-25T19:35:36.051Z","updated_at":"2025-04-12T12:42:03.677Z","avatar_url":"https://github.com/theohbrothers.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Position-ExplorerWindow\n\n[![github-actions](https://github.com/theohbrothers/Position-ExplorerWindow/actions/workflows/ci-master-pr.yml/badge.svg?branch=master)](https://github.com/theohbrothers/Position-ExplorerWindow/actions/workflows/ci-master-pr.yml)\n[![github-release](https://img.shields.io/github/v/release/theohbrothers/Position-ExplorerWindow?style=flat-square)](https://github.com/theohbrothers/Position-ExplorerWindow/releases/)\n[![powershell-gallery-release](https://img.shields.io/powershellgallery/v/Position-ExplorerWindow?logo=powershell\u0026logoColor=white\u0026label=PSGallery\u0026labelColor=\u0026style=flat-square)](https://www.powershellgallery.com/packages/Position-ExplorerWindow/)\n\nOpens, resizes, and arranges multiple `Explorer` windows at specified paths in a grid fashion to fit a screen, or multiple screens.\n\n![Demo](https://github.com/theohbrothers/Position-ExplorerWindow/raw/master/images/preview-demo.gif \"Demo of Position-ExplorerWindow\")\n\n## Install\n\nOpen [`powershell`](https://docs.microsoft.com/en-us/powershell/scripting/windows-powershell/install/installing-windows-powershell?view=powershell-5.1) or [`pwsh`](https://github.com/powershell/powershell#-powershell) and type:\n\n```powershell\nInstall-Module -Name Position-ExplorerWindow -Repository PSGallery -Scope CurrentUser -Verbose\n```\n\nIf prompted to trust the repository, hit `Y` and `enter`.\n\n## Usage\n\n```powershell\nImport-Module Position-ExplorerWindow\n\n# Simply use -ModeEasy with a list of -Paths\nPosition-ExplorerWindow -ModeEasy -Paths 'C:/path/to/folder1', 'C:/path/to/folder2', 'C:/path/to/folder3', 'C:/path/to/folder4'\n```\n\n## Usage (advanced)\n\n```powershell\nImport-Module Position-ExplorerWindow\n\n# Configure to your liking\n$params = @{\n    'Paths' = 'C:/path/to/folder1', 'C:/path/to/folder2', 'C:/path/to/folder3', 'C:/path/to/folder4', 'D:/path/to/folder1', 'D:/path/to/folder2', 'D:/path/to/folder3', 'D:/path/to/folder4'\n    'DestinationScreenWidth' = 1920\n    'DestinationScreenHeight' = 1080\n    'DestinationMonitor' = 'M'\n    'Rows' = 4\n    'Cols' = 2\n    'OffsetLeft' = 0\n    'OffsetTop' = 0\n    'Flow' = 'Y'\n}\n# Call with params splatting\nPosition-ExplorerWindow @params\n```\n\nUse `Get-Help Position-ExplorerWindow -Detailed` to see many good examples.\n\n## FAQ\n\nQ: System requirements?\n\n- Windows 7 and up\n- Powershell v2\n\nQ: I want to open multiple sets of windows quickly. How do I do that?\n\nSimply make a copy of the usage script above for each set of `Explorer` windows you want to open. Configure each script with a set of `Paths`. Keep the scripts on your Desktop. You can now easily run those scripts, by right-clicking and selecting `Run with Powershell`.\n\nAlternatively, as seen in this demo, you can pin `Powershell` onto your Taskbar, then pin your scripts by dragging and dropping over the Powershell on the Taskbar. Now you can easily run them by right-clicking on Powershell, and clicking the script.\n\n![Pin Demo](https://github.com/theohbrothers/Position-ExplorerWindow/raw/master/images/pin-demo.gif \"Demo of Position-ExplorerWindow\")\n\nQ: Help! the Taskbar is overlapping some of my Explorer windows!\n\nYou are probably an advanced user, and are not using `-ModeEasy`. A Taskbar with a single row of icons is often 40 pixels high (if at top or bottom) or 62 pixels wide (if at left or right). So:\n\n- If your Taskbar is on the **bottom**, reduce the `-DestinationScreenHeight` by 40. \u003cbr /\u003e\n- If your Taskbar is on the **top**, reduce the `-DestinationScreenHeight` by 40, and increase `-OffsetTop` by 40. \u003cbr /\u003e\n- If your Taskbar is on the **left**, reduce the `-DestinationScreenWidth` by 62, and increase `-OffsetLeft` by 62.  \u003cbr /\u003e\n- If your Taskbar is on the **right**, reduce the `-DestinationScreenWidth` by 62, and reduce `-OffsetLeft` by 62.\n\n\np.s. If your Taskbar is has *two or more rows* of icons, then change the above by multiples of 40 or 62.\n\nQ: Why are there gaps between windows?\n\nIt's likely you have Windows Aero active, since it is turned on by default on Windows 7 and above. When Aero is active, a window's dimensions includes window borders and shadow effects. Aero theme makes shadow regions around a window transparent, hence creating \"gaps\".\n\n## Background\n\nAn `Explorer` window cannot be opened at a specified coordinate on the screen through its command line. Because the author could not find any working solution that could conveniently open multiple Explorer windows in specified folders arranged in a predictable and orderly fashion on the screen, there had to be a tool that could do this.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheohbrothers%2Fposition-explorerwindow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheohbrothers%2Fposition-explorerwindow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheohbrothers%2Fposition-explorerwindow/lists"}