Skip to content

Repository files navigation

Shawtie

File Sorting Framework

Shawtie is an AI powered file organization tool that uses ai to analyse, rename, and categorizes your files into structured folders. It uses ai to understand file content and generate descriptive names, making messy directories clean and searchable. Built for Linux, it handles images, documents, videos, audio files, and more.

  • AI Smart Renaming

  • Auto Caegorization into folders

  • Recursive Sorting inside folders

  • Metadata Viewer

  • History tracking

  • Undo Function

  • Dolphin integration to use actions with right - click.

  • Beautiful progress bars and colourful ooutpts.

  • Can see a dry run of what changes will be done.

Demo

recording_2025-11-22_22.48.39.mp4

How to run locally

  1. Clone the repository
git clone https://github.com/Turbash/shawtie
cd shawtie
  1. Install the dependencies
pip install -r requirements.txt
  1. Run the main file with target folder (there are other ways to run also watch demo)
python main.py test_files

Requirements

A decent version of python and pip

KDE Dolphin if you want to test dolphin integration.

pip package

You can now use shawtie simply by installing it with this command:

pip install shawtie

The package can be seen on https://pypi.org/project/shawtie/

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages