https://github.com/s0d3s/positioner
🌪Manage [save/restore] your desktop icons, with pretty GUI on Windows❖
https://github.com/s0d3s/positioner
desktop desktop-management icon-position icons save-restore-position windows
Last synced: about 1 year ago
JSON representation
🌪Manage [save/restore] your desktop icons, with pretty GUI on Windows❖
- Host: GitHub
- URL: https://github.com/s0d3s/positioner
- Owner: s0d3s
- License: agpl-3.0
- Created: 2023-05-11T18:50:14.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2023-07-12T17:10:55.000Z (almost 3 years ago)
- Last Synced: 2025-04-10T00:43:54.433Z (about 1 year ago)
- Topics: desktop, desktop-management, icon-position, icons, save-restore-position, windows
- Language: QML
- Homepage:
- Size: 2.59 MB
- Stars: 16
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
### TOOL FOR SAVING, RESTORING AND MANAGING DESKTOP ICONS
![shield-downloads-count]
![shield-windows-only]
[About](#why-positioner) ●
[Features](#-----features--) ●
[Installation](#-installation) ●
[Article](https://medium.com/@s0d3s/how-to-save-the-position-of-icons-on-the-desktop-and-what-is-positioner-app-f564cde01360)
[![shield-download]](../../releases/latest)
## Why Positioner?
Has 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?
It happened to me. This was the initial reason for the development.
`Positioner` - will help not only restore the same layout, but also create several `snapshots` of the desktop, with your settings, and switch between them.
✨ Features
> ⚠ Positioner is now at the alpha-stage, so exist some nuances.
> For example, the next few releases will work in single-threaded mode, in order
to facilitate testing (that is, when executing a command, the GUI will freeze)
* Save/restore icons position
* Attach `snapshots` to quick slots
* Change desktop view(`flags`)
* Quick button for hide\show icons
* Restore icons position on OS startup
* Set custom `snapshot` name
* Create & use your own transition(the logic by which the icons move from point to point)
> Now this feature is available, but only in manual mode (it is not displayed in the GUI).
> To create your own transition, modify the file `src/movement_transitions/default_transition.py`.
> You can do this before "compiling" or after installation.
## 💽 Installation
You can use `Positioner` in two ways:
- Install and use as a standalone programm
- Download source code, install dependencies and run as python script
> ❗ NOTE:
> If you have too many icons on your desktop, then the transition may not be smooth.
> This is a Windows bug (which cannot be bypassed at the Positioner level), however,
> this process can be facilitated by turning off the flag responsible for displaying file names.
### Standalone Installation
- Download installer from [latest release page](../../releases/latest)
- Run and install
> ~~⚠ If installed in Program Files, you will need administrator rights to run `Positioner`~~
- Use `Positioner`!
> Optional: Press ⭐ on the github page😉
### <As Script> Installation
- [Download and install python 3.9+](https://www.python.org/)
- Download sorce code from [latest release](../../releases/latest)
- Unpack sorce code to some folder, and run here command line
- Install all requirements:
```bash
pip install -r requirements.txt
```
- For start, run:
```bash
python main.py
```
[cat]: https://cataas.com/cat/says/Positioner
[shield-downloads-count]: https://img.shields.io/github/downloads/s0d3s/Positioner/total?cacheSeconds=1800
[shield-windows-only]: https://img.shields.io/badge/-Windows%20only-555?logoWidth=40&logo=windows&logoColor=0078D6
[shield-download]: https://img.shields.io/badge/%E2%80%8C[Latest]-Download-green?style=for-the-badge&logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjxzdmcgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPg0KPHBhdGggZD0iTTYgMjFIMThNMTIgM1YxN00xMiAxN0wxNyAxMk0xMiAxN0w3IDEyIiBzdHJva2U9IiM5N2NhMDAiIHN0cm9rZS13aWR0aD0iNCIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIi8+DQo8L3N2Zz4=