{"id":24778575,"url":"https://github.com/s0d3s/positioner","last_synced_at":"2025-04-10T00:43:58.356Z","repository":{"id":164127612,"uuid":"639577824","full_name":"s0d3s/Positioner","owner":"s0d3s","description":"🌪Manage [save/restore] your desktop icons, with pretty GUI on Windows❖","archived":false,"fork":false,"pushed_at":"2023-07-12T17:10:55.000Z","size":2714,"stargazers_count":16,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-10T00:43:54.433Z","etag":null,"topics":["desktop","desktop-management","icon-position","icons","save-restore-position","windows"],"latest_commit_sha":null,"homepage":"","language":"QML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/s0d3s.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":null,"patreon":"s0d3s","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2023-05-11T18:50:14.000Z","updated_at":"2025-03-30T18:38:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"b2919a13-d9d9-4e69-b8a0-7e1fcb472d37","html_url":"https://github.com/s0d3s/Positioner","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s0d3s%2FPositioner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s0d3s%2FPositioner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s0d3s%2FPositioner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s0d3s%2FPositioner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/s0d3s","download_url":"https://codeload.github.com/s0d3s/Positioner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248137998,"owners_count":21053775,"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":["desktop","desktop-management","icon-position","icons","save-restore-position","windows"],"created_at":"2025-01-29T08:37:46.986Z","updated_at":"2025-04-10T00:43:58.349Z","avatar_url":"https://github.com/s0d3s.png","language":"QML","funding_links":["https://patreon.com/s0d3s"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"https://github.com/s0d3s/Positioner/blob/media_storage/distribution/main/positioner_top_banner.svg\" alt=\"Positioner header logo\" height=300/\u003e\n\n### TOOL FOR SAVING, RESTORING AND MANAGING DESKTOP ICONS\n\n![shield-downloads-count]\n![](https://img.shields.io/github/v/release/s0d3s/Positioner?include_prereleases)\n![shield-windows-only]\n\n[About](#why-positioner) ● \n[Features](#-----features--) ● \n[Installation](#-installation) ● \n[Article](https://medium.com/@s0d3s/how-to-save-the-position-of-icons-on-the-desktop-and-what-is-positioner-app-f564cde01360)\n  \n[![shield-download]](../../releases/latest)\n\u003c/div\u003e\n\n## Why Positioner?\n\n\u003cimg align=\"right\" src=\"https://github.com/s0d3s/Positioner/blob/media_storage/distribution/main/main_presentation.gif\" width=\"250\" height=\"300\"/\u003e\n\u003cdiv align=\"left\"\u003e\n  \nHas it ever happened in your life, that you finally put your legion of desktop icons onto their positions, sorted them by meaning/color, **BUT** at the next start, Windows treacherously mixed your icons with quantum wind?\n\nIt happened to me. This was the initial reason for the development.\n\n`Positioner` - will help not only restore the same layout, but also create several `snapshots` of the desktop, with your settings, and switch between them.\n\u003c/div\u003e\n\n\n\u003cdiv\u003e\n  \u003ca href=\"https://medium.com/@s0d3s/how-to-save-the-position-of-icons-on-the-desktop-and-what-is-positioner-app-f564cde01360\"\u003e \n     \u003cimg align=\"right\" src=\"https://img.shields.io/badge/Read_on_Medium-12100E?style=for-the-badge\u0026logo=medium\u0026logoColor=white\"/\u003e\n  \u003c/a\u003e\n  \n  \u003ch2 align=\"left\"\u003e\n    ✨ Features\n  \u003c/h2\u003e\n\u003c/div\u003e \n\n\u003e ⚠ Positioner is now at the alpha-stage, so exist some nuances.\u003cbr\u003e\n\u003e For example, the next few releases will work in single-threaded mode, in order\u003cbr\u003eto facilitate testing (that is, when executing a command, the GUI will freeze)\n\n* Save/restore icons position\n\n  \u003cimg height=\"200\" width=\"500\" align=\"center\" src=\"https://github.com/s0d3s/Positioner/blob/media_storage/distribution/main/exmp_save_restore.gif\"/\u003e\n  \n* Attach `snapshots` to quick slots\n\n  \u003cimg height=\"200\" width=\"500\" align=\"center\" src=\"https://github.com/s0d3s/Positioner/blob/media_storage/distribution/main/exmp_attach_to_slot.gif\"/\u003e\n  \n* Change desktop view(`flags`)\n\n  \u003cimg height=\"200\" width=\"500\" align=\"center\" src=\"https://github.com/s0d3s/Positioner/blob/media_storage/distribution/main/exmp_desktop_flags.gif\"/\u003e\n  \n* Quick button for hide\\show icons\n\n  \u003cimg height=\"200\" width=\"500\" align=\"center\" src=\"https://github.com/s0d3s/Positioner/blob/media_storage/distribution/main/exmp_hide_show.gif\"/\u003e\n  \n* Restore icons position on OS startup\n\n* Set custom `snapshot` name\n  \n* Create \u0026 use your own transition(the logic by which the icons move from point to point)\n  \u003e Now this feature is available, but only in manual mode (it is not displayed in the GUI).\u003cbr\u003e\n  \u003e To create your own transition, modify the file `src/movement_transitions/default_transition.py`.\u003cbr\u003e\n  \u003e You can do this before \"compiling\" or after installation.\n\n## 💽 Installation\n\nYou can use `Positioner` in two ways:\n - Install and use as a standalone programm\n - Download source code, install dependencies and run as python script\n\n\u003e ❗ NOTE:\n\u003e   If you have too many icons on your desktop, then the transition may not be smooth.\u003cbr\u003e\n\u003e   This is a Windows bug (which cannot be bypassed at the Positioner level), however,\u003cbr\u003e\n\u003e   this process can be facilitated by turning off the flag responsible for displaying file names.\n\n\n### Standalone Installation\n\n - Download installer from [latest release page](../../releases/latest)\n - Run and install\n   \u003e ~~⚠ If installed in Program Files, you will need administrator rights to run `Positioner`~~\n\n - Use `Positioner`!\n   \u003e Optional: Press ⭐ on the github page😉\n\n### \u0026lt;As Script\u0026gt; Installation\n\n - [Download and install python 3.9+](https://www.python.org/)\n - Download sorce code from [latest release](../../releases/latest)\n - Unpack sorce code to some folder, and run here command line\n - Install all requirements:\n   ```bash\n   pip install -r requirements.txt\n   ```\n - For start, run:\n   ```bash\n   python main.py\n   ```\n\n  \n\n[cat]: https://cataas.com/cat/says/Positioner\n[shield-downloads-count]: https://img.shields.io/github/downloads/s0d3s/Positioner/total?cacheSeconds=1800\n[shield-windows-only]: https://img.shields.io/badge/-Windows%20only-555?logoWidth=40\u0026logo=windows\u0026logoColor=0078D6\n[shield-download]: https://img.shields.io/badge/%E2%80%8C[Latest]-Download-green?style=for-the-badge\u0026logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjxzdmcgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPg0KPHBhdGggZD0iTTYgMjFIMThNMTIgM1YxN00xMiAxN0wxNyAxMk0xMiAxN0w3IDEyIiBzdHJva2U9IiM5N2NhMDAiIHN0cm9rZS13aWR0aD0iNCIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIi8+DQo8L3N2Zz4=\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fs0d3s%2Fpositioner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fs0d3s%2Fpositioner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fs0d3s%2Fpositioner/lists"}