Visualise, find duplicates, and safely reorganise your files

Disk Organiser helps you understand disk usage, find repeated files, and apply safe, reversible reorganisation strategies — with optional AI-powered suggestions.

Open demo Read docs

Preview of the visualiser

Key Features

Disk visualisation

Interactive maps and tree views show where space is used, helping you prioritise cleanup and organisation.

Duplicate detection

Find repeated files by content hash, size and metadata, with filters for date, size and type.

Safe operations

All automated operations create backup snapshots so you can preview and revert changes safely.

Pluggable AI

Integrate local or cloud models to get suggested organisation strategies tailored to your preferences.

Quick start

Clone the repo, create a virtual environment, install requirements and run the backend:

git clone https://github.com/krahd/disk_organiser.git
cd disk_organiser
python3 -m venv venv
source venv/bin/activate
pip install -r backend/requirements.txt
python backend/app.py

Open the frontend (`frontend/index.html`) in your browser (it expects the API at http://127.0.0.1:5000 by default).

Architecture & Integrations

Disk Organiser is a small Flask backend with a static frontend. Model integrations live under backend/model_wrappers/ and are optional. The app is designed to run locally and respects filesystem permissions.

Contribute

Contributions are welcome. See the documentation for development setup, tests and contribution guidelines in the docs folder.

Quick links: Issues · Pull requests