alonex-x/desktop-automation-toolkit

Desktop Automation Toolkit is a Python command line tool for keeping folders on your computer tidy without doing it by hand. It runs from a terminal and offers three main jobs: sorting files into subfolders based on their file type, deleting old temporary files that tend to pile up over time, and creating compressed backup copies of a folder. Each of these jobs is run as a simple command. The organize command scans a folder and automatically moves files into subfolders named after their extension, so images end up together, documents end up together, and so on. The clean command looks for temporary style files, such as those ending in tmp, log, bak, or a trailing tilde, and removes any that are older than a number of days you choose. The backup command copies an entire directory to a chosen destination, optionally compressing it to save space. Every command supports a dry run mode, which shows exactly what would happen without actually changing or deleting anything, so a user can check the results are what they expect before committing to them. Beyond the three built-in commands, the toolkit includes an optional rules engine controlled by a JSON file. This lets a user define their own automation logic, such as always deleting torrent files or always moving image files into a folder called Photos, without needing to edit the underlying Python code. Rules are checked in order, and the first one that matches a file is applied, if no rule matches, the tool falls back to its normal default behavior. Currently rules can match files by their extension, with support for matching by file size or age planned for later versions. The tool requires Python 3.6 or newer, has no external dependencies beyond Python's standard library, and works on Linux, macOS, and Windows through WSL. It is described by its author as part of a self-taught developer portfolio, and is one piece of a larger personal project ecosystem.