Skip to content

Veda-Swaroop/TidyBit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

62 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TidyBit Logo

TidyBit — Cross-Platform File Organizer

A desktop file organizer app built with Python and PySide6, published on the Microsoft Store and Linux Snap Store. TidyBit helps you clean up cluttered folders by automatically categorizing and moving files based on customizable rules.

Python Platform Platform License: MIT Microsoft Store tidybit


Download

Windows

Get it from Microsoft

  • Automatic updates
  • Recommended for most users

Linux (Snap)

Get it from the Snap Store

  • Easy installation
  • Auto updates via Snap

Direct Download (GitHub Releases)

GitHub release

Windows: Download the .exe setup file and run the installer.

Linux (AppImage):

  1. Download the .AppImage file
  2. Right-click → Properties → Permissions → Enable "Allow executing file as program"
  3. Double-click to run

Note: If the AppImage fails to run on Linux, it may be a FUSE version issue. See AppImage - FUSE for instructions.

Store versions are recommended for automatic updates and better system integration.


Screenshots

UI 1 UI 2 UI 3

UI 4 UI 5 UI 6


How It Works

TidyBit operates in four clear steps:

  1. Validation — Confirm source and target folder paths
  2. Fetch Files — Display all files from the source folder
  3. Organize — Categorize files based on rules defined in Settings (documents, images, videos, code, archives, etc.)
  4. Move — Create subfolders in the target directory and move files accordingly

The app works only on files directly inside the source folder. Sub-directories within the source location are ignored.


Features

  • Clean, beginner-friendly GUI with step-by-step workflow
  • Real-time progress bar during file operations
  • Handles large files and files on external drives
  • Duplicate file handling
  • Pre-defined rules for commonly used file types and categories
  • Fully customizable rules — add, modify, or delete
  • Option to reset and restore default rules
  • Clear error messages and user feedback at each step

Installation (Running from Source)

git clone https://github.com/Veda-Swaroop/TidyBit.git
cd TidyBit
pip install -r requirements.txt
python run.py

Contributing

Contributions, issues, and feature requests are welcome. Feel free to open an issue or submit a pull request.


License

This project is licensed under the MIT License.