centre 0.1.0__tar.gz

centre-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jack Scott
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

centre-0.1.0/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: centre
+Version: 0.1.0
+Summary: Your Window Position Manager
+Author-email: Jack Scott <cloner.bl12@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/JackScott7/centre
+Project-URL: Repository, https://github.com/JackScott7/centre
+Project-URL: Issues, https://github.com/JackScott7/centre/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Environment :: Win32 (MS Windows)
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: keyboard>=0.13.5
+Requires-Dist: pyautogui>=0.9.54
+Requires-Dist: pygetwindow>=0.0.9
+Dynamic: license-file
+
+# Centre
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+---
+
+Centre is your window position manager.
+
+Take control of your windows by choosing where they appear, how they’re arranged, and what size they should be.
+
+Consistency is `centre`'s goal.
+
+## What Centre Tries to Achieve
+
+---
+Centre was built for users who want consistent window placement across desktop sessions.
+
+# Install
+
+---
+
+```PowerShell
+pip install centre
+```
+
+## Start Centre Automatically
+
+---
+To do that, create a Windows Task Scheduler task.
+
+Run the following command as Administrator in PowerShell/cmd to create a Task in Windows Task Scheduler.
+```PowerShell
+schtasks /Create /TN "centre" /SC ONLOGON /TR "centre -s" /RL LIMITED /F
+```
+
+# Usage
+
+After your window configuration is ready, start the listener:
+---
+
+```bash
+$ centre -s
+```
+
+# The CLI
+
+---
+You can use `centre` CLI to find out window titles, sizes and screen positions.
+The CLI will help you to accurately find your window title to set the exact position you want on the screen with your
+desired size.
+
+Examples:
+
+```PowerShell
+# List all active window titles
+centre -l
+```
+
+## Refresh your config without restarting
+
+---
+You can use the predefined shortcut `ctrl+alt+r` to reload/refresh your config without restarting the background
+process.
+This is useful when trying to edit your config.
+
+# Window Configuration (config.json)
+
+---
+Your config will be created at the first startup in:
+
+CMD
+
+```cmd
+%USERPROFILE%\.centre\config.json
+```
+
+PowerShell
+
+```PowerShell
+$env:USERPROFILE\.centre\config.json
+```
+
+The default config includes these values:
+
+- The resolution key is based on your display resolution.
+
+```json
+{
+    "presets": {
+        "1920x1080": {}
+    },
+    "predefined_keybindings": {
+        "enabled": true,
+        "bindings": {
+            "refresh": "ctrl+alt+r",
+            "center": "ctrl+alt+d",
+            "minimize": "ctrl+alt+m"
+        }
+    },
+    "logging": false
+}
+```
+
+**_You can change any predefined keyboard shortcut, for example setting refresh to ctrl+shift+f10._**
+
+---
+Window presets should be placed inside the "presets" object in `config.json`.
+
+A window preset should look like this:
+
+```json
+{
+    "PS7": {
+        "LEFT": 224,
+        "TOP": 168,
+        "SIZE_X": 1473,
+        "SIZE_Y": 697
+    },
+    "Default_Position": {
+        "LEFT": 25,
+        "TOP": 34,
+        "SIZE_X": 1860,
+        "SIZE_Y": 980
+    }
+}
+
+```
+
+- Be sure to add `Default_Position` in your presets under the generated default resolution.
+  When Centre does not find the active window in your presets, it uses `Default_Position` as the fallback size and position.
+
+- `Default_Position` is useful when you have a list of apps that you have set a custom position for,
+  but intend to keep all other apps in one specific location.
+
+Your final config should look something like this:
+
+```json
+{
+    "presets": {
+        "1920x1080": {
+            "PS7": {
+                "LEFT": 224,
+                "TOP": 168,
+                "SIZE_X": 1473,
+                "SIZE_Y": 697
+            },
+            "Default_Position": {
+                "LEFT": 25,
+                "TOP": 34,
+                "SIZE_X": 1860,
+                "SIZE_Y": 980
+            }
+        }
+    },
+    "predefined_keybindings": {
+        "enabled": true,
+        "bindings": {
+            "refresh": "ctrl+alt+r",
+            "center": "ctrl+alt+d",
+            "minimize": "ctrl+alt+m"
+        }
+    },
+    "logging": false
+}
+```
+
+# Caveats
+
+---
+
+Some windows may overlap even when they use the same configured position and size.
+
+This is due to some apps having a bigger actual window than the rendered UI.
+
+# License
+
+---
+
+This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.

centre-0.1.0/README.md

@@ -0,0 +1,178 @@
+# Centre
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+---
+
+Centre is your window position manager.
+
+Take control of your windows by choosing where they appear, how they’re arranged, and what size they should be.
+
+Consistency is `centre`'s goal.
+
+## What Centre Tries to Achieve
+
+---
+Centre was built for users who want consistent window placement across desktop sessions.
+
+# Install
+
+---
+
+```PowerShell
+pip install centre
+```
+
+## Start Centre Automatically
+
+---
+To do that, create a Windows Task Scheduler task.
+
+Run the following command as Administrator in PowerShell/cmd to create a Task in Windows Task Scheduler.
+```PowerShell
+schtasks /Create /TN "centre" /SC ONLOGON /TR "centre -s" /RL LIMITED /F
+```
+
+# Usage
+
+After your window configuration is ready, start the listener:
+---
+
+```bash
+$ centre -s
+```
+
+# The CLI
+
+---
+You can use `centre` CLI to find out window titles, sizes and screen positions.
+The CLI will help you to accurately find your window title to set the exact position you want on the screen with your
+desired size.
+
+Examples:
+
+```PowerShell
+# List all active window titles
+centre -l
+```
+
+## Refresh your config without restarting
+
+---
+You can use the predefined shortcut `ctrl+alt+r` to reload/refresh your config without restarting the background
+process.
+This is useful when trying to edit your config.
+
+# Window Configuration (config.json)
+
+---
+Your config will be created at the first startup in:
+
+CMD
+
+```cmd
+%USERPROFILE%\.centre\config.json
+```
+
+PowerShell
+
+```PowerShell
+$env:USERPROFILE\.centre\config.json
+```
+
+The default config includes these values:
+
+- The resolution key is based on your display resolution.
+
+```json
+{
+    "presets": {
+        "1920x1080": {}
+    },
+    "predefined_keybindings": {
+        "enabled": true,
+        "bindings": {
+            "refresh": "ctrl+alt+r",
+            "center": "ctrl+alt+d",
+            "minimize": "ctrl+alt+m"
+        }
+    },
+    "logging": false
+}
+```
+
+**_You can change any predefined keyboard shortcut, for example setting refresh to ctrl+shift+f10._**
+
+---
+Window presets should be placed inside the "presets" object in `config.json`.
+
+A window preset should look like this:
+
+```json
+{
+    "PS7": {
+        "LEFT": 224,
+        "TOP": 168,
+        "SIZE_X": 1473,
+        "SIZE_Y": 697
+    },
+    "Default_Position": {
+        "LEFT": 25,
+        "TOP": 34,
+        "SIZE_X": 1860,
+        "SIZE_Y": 980
+    }
+}
+
+```
+
+- Be sure to add `Default_Position` in your presets under the generated default resolution.
+  When Centre does not find the active window in your presets, it uses `Default_Position` as the fallback size and position.
+
+- `Default_Position` is useful when you have a list of apps that you have set a custom position for,
+  but intend to keep all other apps in one specific location.
+
+Your final config should look something like this:
+
+```json
+{
+    "presets": {
+        "1920x1080": {
+            "PS7": {
+                "LEFT": 224,
+                "TOP": 168,
+                "SIZE_X": 1473,
+                "SIZE_Y": 697
+            },
+            "Default_Position": {
+                "LEFT": 25,
+                "TOP": 34,
+                "SIZE_X": 1860,
+                "SIZE_Y": 980
+            }
+        }
+    },
+    "predefined_keybindings": {
+        "enabled": true,
+        "bindings": {
+            "refresh": "ctrl+alt+r",
+            "center": "ctrl+alt+d",
+            "minimize": "ctrl+alt+m"
+        }
+    },
+    "logging": false
+}
+```
+
+# Caveats
+
+---
+
+Some windows may overlap even when they use the same configured position and size.
+
+This is due to some apps having a bigger actual window than the rendered UI.
+
+# License
+
+---
+
+This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.

centre-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=77.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "centre"
+version = "0.1.0"
+description = "Your Window Position Manager"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [
+    { name = "Jack Scott", email = "cloner.bl12@gmail.com" }
+]
+license = "MIT"
+license-files = ["LICENSE"]
+dependencies = [
+    "keyboard>=0.13.5",
+    "pyautogui>=0.9.54",
+    "pygetwindow>=0.0.9",
+]
+
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Operating System :: Microsoft :: Windows",
+    "Environment :: Win32 (MS Windows)",
+]
+
+[project.urls]
+Homepage = "https://github.com/JackScott7/centre"
+Repository = "https://github.com/JackScott7/centre"
+Issues = "https://github.com/JackScott7/centre/issues"
+
+[project.scripts]
+centre = "centre.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

centre-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

centre-0.1.0/src/centre/__init__.py

@@ -0,0 +1,4 @@
+from .core import Centre
+
+__all__ = ["Centre"]
+__version__ = "0.1.0"

centre-0.1.0/src/centre/cli.py

@@ -0,0 +1,31 @@
+import argparse
+from .core import Centre
+from .utilities import Utilities
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(prog="centre", description='Centre is A lightweight Windows tool'
+                                    ' for consistent app placement, sizing, and desktop layout control.')
+
+    group = parser.add_mutually_exclusive_group()
+    group.add_argument('-l', '--list', action='store_true', help='List Window Title, Size and Position')
+    group.add_argument('-s', '--start', action='store_true', help='Start Centre as background process')
+    group.add_argument('-c', '--read-config', action='store_true', help='Read config file and print out')
+
+    args = parser.parse_args()
+
+    ctr = Centre()
+    if args.list:
+        titles = Utilities.list_window_titles()
+        print(titles)
+    elif args.read_config:
+        print(ctr.get_config)
+    elif args.start:
+        ctr.listen()
+
+
+if __name__ == '__main__':
+    main()
+
+
+__all__ = ["Centre"]

centre-0.1.0/src/centre/core.py

@@ -0,0 +1,109 @@
+import json
+import logging
+import os
+import keyboard
+from .utilities import Utilities
+
+
+class Centre:
+    """
+    Base class for Centre
+
+    This is where config and log handling are initialized.
+    """
+    def __init__(self):
+        config_dir = os.path.join(os.path.expanduser("~"), ".centre")
+        if not os.path.isdir(config_dir):
+            os.mkdir(config_dir)
+
+        self.__config_file_path = os.path.join(config_dir, "config.json")
+
+        if not os.path.isfile(self.__config_file_path):
+            with open(self.__config_file_path, 'w') as f:
+                self.__config = {
+                    "presets": {
+                        f"{Utilities.get_display_resolution()}": {}
+                    },
+
+                    "predefined_keybindings": {
+                        "enabled": True,
+                        "bindings": {
+                            "refresh": "ctrl+alt+r",
+                            "center": "ctrl+alt+d",
+                            "minimize": "ctrl+alt+m",
+                        }
+                    },
+                    "logging": False
+                }
+                json.dump(self.__config, f, indent=4)
+                return
+        self.load_config()
+
+        self.__logging = self.__config.get("logging", False)
+        if self.__logging:
+            logging.basicConfig(level=logging.INFO, filename=Utilities.get_log_file_path())
+
+    @property
+    def get_config(self) -> str:
+        """
+        Get the loaded config upon initialization
+
+        :return: loaded config
+        """
+        return json.dumps(self.__config, indent=4)
+
+    def load_config(self) -> None:
+        """
+        Load the `config.json`
+
+        This method is used to refresh/reload the config without restarting the background process.
+
+        Config will be accessible through Centre.get_config
+
+        :return: None
+        """
+        try:
+            with open(self.__config_file_path, "r") as f:
+                self.__config = json.load(f)
+        except FileNotFoundError as e:
+            raise FileNotFoundError(f"Config file not found at '{self.__config_file_path}'\nPlease run centre again.")
+        except json.decoder.JSONDecodeError as parse_error:
+            print(f"Syntax error in {self.__config_file_path}\nError: {parse_error.msg} on line {parse_error.lineno}")
+            exit(1)
+
+    def __get_keybindings(self) -> dict:
+        bindings = self.__config.get("predefined_keybindings").get("bindings", {})
+        return bindings
+
+    def __assign_keyboard_bindings(self, bindings: dict) -> None:
+        if not bindings:
+            raise ValueError("Your config seems to have an issue that's causing centre to exit.")
+
+        if not self.__config.get("predefined_keybindings").get("enabled", False):
+            raise ValueError("Please enable the predefined keybindings in config so centre can assign keybindings.")
+
+        for k,v in bindings.items():
+            if k == "refresh":
+                keyboard.add_hotkey(v, Utilities.refresh_hotkey, (self,))
+            elif k == "center":
+                args = (self.__config.get("presets"), Utilities.get_display_resolution())
+                keyboard.add_hotkey(v, Utilities.center_hotkey, args)
+            elif k == "minimize":
+                keyboard.add_hotkey(v, Utilities.minimize_window_hotkey)
+            else:
+                pass
+
+    def listen(self) -> None:
+        """
+        Main entry point for centre, will run in the background when called.
+
+        Keyboard shortcuts in config will be processed.
+        :return: None
+        """
+        bindings = self.__get_keybindings()
+        self.__assign_keyboard_bindings(bindings)
+        try:
+            print("[+] Centre running in background")
+            keyboard.wait()
+        except KeyboardInterrupt or Exception:
+            exit(0)

centre-0.1.0/src/centre/utilities.py

@@ -0,0 +1,71 @@
+import json
+import os
+import pygetwindow as gw
+from pyautogui import size as resolution_size
+
+
+class Utilities:
+    @staticmethod
+    def entry_path(file: str) -> str:
+        return os.path.dirname(os.path.abspath(file))
+
+    @staticmethod
+    def get_display_resolution() -> str:
+        width, height = resolution_size()
+        return f"{width}x{height}"
+
+    @staticmethod
+    def get_log_file_path() -> str:
+        config_dir = os.path.join(os.path.expanduser("~"), '.centre')
+        return os.path.join(config_dir, 'centre.log')
+
+    @staticmethod
+    def minimize_window_hotkey() -> None:
+        window = gw.getActiveWindow()
+        if window:
+            window.minimize()
+
+    @staticmethod
+    def center_hotkey(presets, current_preset) -> None:
+        window = gw.getActiveWindow()
+        if not window:
+            return
+        app_poses = presets[current_preset]
+
+        if not app_poses.get('Default_Position', None):
+            return
+
+        for key in app_poses.keys():
+            if key in window.title:
+                window.resizeTo(app_poses[key]['SIZE_X'], app_poses[key]['SIZE_Y'])
+                window.moveTo(app_poses[key]['LEFT'], app_poses[key]['TOP'])
+                return
+        else:
+            if window:
+                window.resizeTo(app_poses['Default_Position']['SIZE_X'], app_poses['Default_Position']['SIZE_Y'])
+                window.moveTo(app_poses['Default_Position']['LEFT'], app_poses['Default_Position']['TOP'])
+
+    @staticmethod
+    def refresh_hotkey(centre) -> None:
+        centre.load_config()
+
+    @staticmethod
+    def list_window_titles() -> str:
+        """
+        Gets a list of all window titles.
+
+        :return: list of window titles
+        """
+        return json.dumps([
+            {
+                "title": x.title,
+                "size": {
+                    "width": x.size.width,
+                    "height": x.size.height
+                },
+                "top": x.top,
+                "left": x.left,
+                "bottom": x.bottom,
+                "right": x.right,
+            } for x in gw.getAllWindows() if x.title
+        ], indent=4)

centre-0.1.0/src/centre.egg-info/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: centre
+Version: 0.1.0
+Summary: Your Window Position Manager
+Author-email: Jack Scott <cloner.bl12@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/JackScott7/centre
+Project-URL: Repository, https://github.com/JackScott7/centre
+Project-URL: Issues, https://github.com/JackScott7/centre/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Environment :: Win32 (MS Windows)
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: keyboard>=0.13.5
+Requires-Dist: pyautogui>=0.9.54
+Requires-Dist: pygetwindow>=0.0.9
+Dynamic: license-file
+
+# Centre
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+---
+
+Centre is your window position manager.
+
+Take control of your windows by choosing where they appear, how they’re arranged, and what size they should be.
+
+Consistency is `centre`'s goal.
+
+## What Centre Tries to Achieve
+
+---
+Centre was built for users who want consistent window placement across desktop sessions.
+
+# Install
+
+---
+
+```PowerShell
+pip install centre
+```
+
+## Start Centre Automatically
+
+---
+To do that, create a Windows Task Scheduler task.
+
+Run the following command as Administrator in PowerShell/cmd to create a Task in Windows Task Scheduler.
+```PowerShell
+schtasks /Create /TN "centre" /SC ONLOGON /TR "centre -s" /RL LIMITED /F
+```
+
+# Usage
+
+After your window configuration is ready, start the listener:
+---
+
+```bash
+$ centre -s
+```
+
+# The CLI
+
+---
+You can use `centre` CLI to find out window titles, sizes and screen positions.
+The CLI will help you to accurately find your window title to set the exact position you want on the screen with your
+desired size.
+
+Examples:
+
+```PowerShell
+# List all active window titles
+centre -l
+```
+
+## Refresh your config without restarting
+
+---
+You can use the predefined shortcut `ctrl+alt+r` to reload/refresh your config without restarting the background
+process.
+This is useful when trying to edit your config.
+
+# Window Configuration (config.json)
+
+---
+Your config will be created at the first startup in:
+
+CMD
+
+```cmd
+%USERPROFILE%\.centre\config.json
+```
+
+PowerShell
+
+```PowerShell
+$env:USERPROFILE\.centre\config.json
+```
+
+The default config includes these values:
+
+- The resolution key is based on your display resolution.
+
+```json
+{
+    "presets": {
+        "1920x1080": {}
+    },
+    "predefined_keybindings": {
+        "enabled": true,
+        "bindings": {
+            "refresh": "ctrl+alt+r",
+            "center": "ctrl+alt+d",
+            "minimize": "ctrl+alt+m"
+        }
+    },
+    "logging": false
+}
+```
+
+**_You can change any predefined keyboard shortcut, for example setting refresh to ctrl+shift+f10._**
+
+---
+Window presets should be placed inside the "presets" object in `config.json`.
+
+A window preset should look like this:
+
+```json
+{
+    "PS7": {
+        "LEFT": 224,
+        "TOP": 168,
+        "SIZE_X": 1473,
+        "SIZE_Y": 697
+    },
+    "Default_Position": {
+        "LEFT": 25,
+        "TOP": 34,
+        "SIZE_X": 1860,
+        "SIZE_Y": 980
+    }
+}
+
+```
+
+- Be sure to add `Default_Position` in your presets under the generated default resolution.
+  When Centre does not find the active window in your presets, it uses `Default_Position` as the fallback size and position.
+
+- `Default_Position` is useful when you have a list of apps that you have set a custom position for,
+  but intend to keep all other apps in one specific location.
+
+Your final config should look something like this:
+
+```json
+{
+    "presets": {
+        "1920x1080": {
+            "PS7": {
+                "LEFT": 224,
+                "TOP": 168,
+                "SIZE_X": 1473,
+                "SIZE_Y": 697
+            },
+            "Default_Position": {
+                "LEFT": 25,
+                "TOP": 34,
+                "SIZE_X": 1860,
+                "SIZE_Y": 980
+            }
+        }
+    },
+    "predefined_keybindings": {
+        "enabled": true,
+        "bindings": {
+            "refresh": "ctrl+alt+r",
+            "center": "ctrl+alt+d",
+            "minimize": "ctrl+alt+m"
+        }
+    },
+    "logging": false
+}
+```
+
+# Caveats
+
+---
+
+Some windows may overlap even when they use the same configured position and size.
+
+This is due to some apps having a bigger actual window than the rendered UI.
+
+# License
+
+---
+
+This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.

centre-0.1.0/src/centre.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+src/centre/__init__.py
+src/centre/cli.py
+src/centre/core.py
+src/centre/utilities.py
+src/centre.egg-info/PKG-INFO
+src/centre.egg-info/SOURCES.txt
+src/centre.egg-info/dependency_links.txt
+src/centre.egg-info/entry_points.txt
+src/centre.egg-info/requires.txt
+src/centre.egg-info/top_level.txt

centre-0.1.0/src/centre.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

centre-0.1.0/src/centre.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+centre = centre.cli:main

centre-0.1.0/src/centre.egg-info/requires.txt

@@ -0,0 +1,3 @@
+keyboard>=0.13.5
+pyautogui>=0.9.54
+pygetwindow>=0.0.9

centre-0.1.0/src/centre.egg-info/top_level.txt

@@ -0,0 +1 @@
+centre