Skip to content

A modular Python utility for directory automation. Uses a decoupled JSON configuration to manage file-sorting logic with local audit logging.

Notifications You must be signed in to change notification settings

johnathanhodge-bit/python-file-sorter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Personal Automation: Local File Organizer

License: MIT

🎯 Purpose

This is a Python-based utility designed to automate directory hygiene. It demonstrates a "Logic-from-Policy" architecture, where the sorting rules are decoupled from the execution engine for maximum flexibility and security.

πŸ› οΈ Tech Stack

  • Language: Python 3.12+
  • Configuration: JSON-driven policy management
  • Interface: Tkinter GUI (Native)
  • Logging: Integrated audit trail (organizer.log)

πŸ” Key Features

  • Zero Cloud Footprint: All operations occur locally on your machine.
  • Dynamic Rules: Modify config.json to add new file categories without changing a single line of code.
  • Error Resilience: Gracefully handles permission issues and system-protected files.
  • Audit Trail: Every file movement is timestamped and recorded for transparency.

πŸš€ How to Use

  1. Initialize: Ensure you have Python installed.
  2. Configure: Edit config.json to define your desired folder names and file extensions.
  3. Execute: Run python3 organizer.py.
  4. Select: Use the visual dialog to pick the folder you wish to organize.

Developed as a proof-of-concept for AI-assisted executive automation.

About

A modular Python utility for directory automation. Uses a decoupled JSON configuration to manage file-sorting logic with local audit logging.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages