♛ Project 12 · Desktop Utility
Folder Saga
organize · discover · reclaim your space

A desktop app that turns file organization from a chore into a quest. Point it at a messy folder and it sorts loose files into clean categories, sweeps duplicates and junk into a review vault, and tracks your progress with XP, levels, streaks, and achievements. Every move is preview-first and fully reversible — nothing is ever deleted.

View on GitHub ↗ See inside
Scroll
A tidy in action01
folder saga — preview tidy
78
chaos before
0
chaos after
The plan (nothing moved yet)
12
Images/ · .jpg .png .webp
8
Documents/ · .pdf .docx .txt
3
Video/ · .mp4 .mkv
5
_SagaVault/duplicates/ · identical by hash
2
_SagaVault/junk/ · .tmp .crdownload
⚔ +380 XP ♛ Level 2 🔥 3-day streak ★ Achievement: First Quest ♦ 1.2 GB reclaimed
What it does02

Reversible Tidy

Sorts loose files into category folders — Images/, Documents/, Video/, Code/ and more. Duplicates and junk go to a review vault, never the trash. Hit Undo and every file goes back exactly where it was.

preview → approve → undo

Duplicate Detection

Finds identical files by content hash, not name. Two files called different things but containing the same bytes get caught; two files with the same name but different contents don't. Duplicates go to the vault for you to review — never auto-deleted.

blake2b content hash

The Map

An interactive treemap and collapsible tree of your drive, color-coded by file type. See at a glance where your space went. Opens in your browser — purely read-only, changes nothing.

The Realm — Game Layer

Your drive becomes a quest board. Each folder is a region with a mess rating; your worst folder is the boss. Tidying pays XP and gold (space reclaimed). Level up, keep a daily streak, unlock achievements like Dupe Slayer and Gold Hoarder.

the game IS the habit

Disk Report

A fast, dependency-free scan that shows where your space actually went — by category, by folder, by biggest files. The answer to "what's eating my drive?" in seconds.

Space Reclaim

Finds duplicates and junk across a folder tree: identical files by content, empty files, half-finished downloads, temp files. Reports what you'd free — without touching anything until you say go.

The three rules03

A file organizer that people can't trust with their files is useless. So the engine holds to three rules, and each one is enforced by a test that blocks the release if it ever breaks.

1 · Nothing is ever deleted

Duplicates and junk are moved into a _SagaVault folder you control. You empty it yourself, when you're sure. The app's hands stay off the delete key, period.

test: file count never drops

2 · Every move is logged and reversible

Each move is written to a JSONL transaction log as it happens. Undo replays the log in reverse and puts every file back exactly. Even a crash mid-tidy leaves a log that still rolls back cleanly.

test: tidy then undo restores everything

3 · It only touches loose files

It sorts the files sitting directly in the folder you pointed it at. It does not reach into your existing subfolders and rearrange them, and it never moves anything outside the target. The blast radius is exactly the mess you pointed it at.

test: existing subfolder is never touched
Under the hood04

How it's built

Pure Python with tkinter for the GUI — no external dependencies for the core app. The interactive map and realm board are self-contained HTML pages that open in your default browser. Threading keeps the UI responsive during scans. The organize engine uses os.rename for atomic moves with a shutil.move cross-device fallback. Duplicate detection uses blake2b hashing, only within same-size groups to stay fast on large folders.

Pythontkinterblake2bos / shutilJSONL logsHTML / CSS / JSpytest

Design decisions

  • Dry-run by default. Preview shows the full plan — what moves where, chaos score before and after, space reclaimed. You approve before anything happens.
  • Vault, not trash. Files flagged as duplicates or junk go to a visible folder you can browse. The app never calls delete.
  • Game is the habit. XP comes from the useful action (sorting files, reclaiming space). The rewarding thing and the useful thing are the same thing.
  • 53 tests. Safety-critical paths (tidy, undo, round-trip, never-delete) are tested with snapshot assertions. Read-only paths (scan, map, survey) are proven read-only.

Tidy your drive. Undo any time.

Free and open source. Runs on your own machine, nothing leaves it. Works on Windows today.