Client Folder Tidy

Client Folder Tidy is a single stdlib-only Python 3 script for cleaning file names in one client folder. It runs as a dry run by default: it changes no files and writes one plain-text log listing the planned renames. With --apply it renames files, replacing spaces and underscores with hyphens, removing symbols, and lowercasing extensions. With --sort it moves files into folders such as documents, spreadsheets, images, design, video, audio, archives and presentations; other types go to an 'other' folder. It never overwrites existing files: name clashes get -2, -3 suffixes. With --recursive it scans subfolders, but it skips hidden files, hidden folders (for example .git), symbolic links and its own log files. Every run writes a log file into the scanned folder. The script exits with a non-zero code if any move fails or the log cannot be written. Limits: it does not read file contents, find duplicates, fix dates or undo changes, and the sorting list is fixed. Keep a backup before using --apply on important folders. Requires Python 3.8 or later. Created with AI assistance; review the code before running it on important files.

Format: python script · Instant download (.zip) · Includes: README.md, client_folder_tidy.py, test_client_folder_tidy.py

Created with AI assistance and checked automatically before release.

Secure payment by Stripe. See terms & refund policy.