Skip to content

justduyen/python-file-organizer-robot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

2 Commits
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Python File Organizer Robot

This is a simple Python script that automatically cleans up your Downloads folder by categorizing files into corresponding subfolders.

๐Ÿ“‚ Folder Structure

The script scans the Downloads directory and moves files into the following folders (created automatically if not present):

  • Images/: .jpg, .png, .gif, .svg, .webp, etc.
  • Documents/: .pdf, .docx, .xlsx, .txt, .md, .csv, etc.
  • Videos/: .mp4, .mkv, .avi, .mov, etc.
  • Music/: .mp3, .wav, .flac, etc.
  • Installers/: .exe, .msi, .iso
  • Archives/: .zip, .rar, .7z, .tar
  • Others/: Any remaining file types.

๐Ÿš€ Usage

Method 1: Command Line

  1. Install Python (if not already installed).
  2. Open Terminal in the project directory.
  3. Run the command:
    python src/main.py

Method 2: Quick Run (Windows)

Double-click the run_robot.bat file.

โš™๏ธ Customization

To add or remove file extensions, open src/main.py and edit the ext_to_folder dictionary.

๐Ÿ“ Logging

  • All actions are recorded in history.log located in the project root folder.
  • You can check this file to see which files were moved or if any errors occurred.

โš ๏ธ Notes

  • The script automatically renames files if duplicates exist (e.g., image_(1).png).
  • The script ignores folders and hidden files.

About

A Python automation script that keeps your Downloads folder organized. It acts like a robot to sort files into categories (Images, Documents, Videos) automatically.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors