This Python script automates the organization of files in your Downloads folder by sorting and moving them into categorized folders based on file extensions and creation dates.
- Automatically sorts files into folders like Photos, Documents, Code, Text, Compressions, etc.
- Organizes files by Year and Month based on filenames or file creation dates.
- Creates target folders automatically if they don’t exist.
- Detects duplicate files by comparing sizes and removes duplicates from the source.
- Cleans up any leftover unclassified files and folders from the source directory.
-
Define your source folder (default: Downloads) and target folders for different file types.
-
Specify file extensions grouped by category.
-
Extract date info from the filename or fallback to file creation/modification date.
-
Move files into folders structured as:
-
Delete any files or folders remaining in the source folder that don’t match the known extensions.
-
Backup your files before running this script!
The script deletes files considered duplicates or unclassified, so accidental data loss is possible. -
The script supports macOS, Linux, and Windows, but behavior may vary due to differences in how these systems handle file creation dates.
-
Modify the folder paths and file extensions inside the script to match your setup and needs.
I welcome contributions and ideas to make this script even better! Here’s how you can help:
- Report bugs or issues by opening an issue in this repository.
- Suggest new features or improvements via issues or discussions.
- Submit code changes by forking the repo, making your changes, and opening a pull request (PR).
- Look for issues labeled good first issue or help wanted if you want a place to start.
- Please follow the existing code style and add comments where necessary.
Feel free to reach out if you want help getting started or have questions!
If you'd like, I can also help you add new mechanics or anything you see it lacks.
— PAMUGR