whatisgithub

What is prism-organizer?

j-akiru5/prism-organizer — explained in plain English

Analysis updated 2026-05-18

39PythonAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A Windows command-line tool that scans a folder, reports what's in it, and can automatically sort, deduplicate, and clean up your files.

Mindmap

mindmap
  root((Prism Organizer))
    What it does
      Scans folders
      Reports file types and duplicates
      Reorganizes files
    Tech stack
      Python
      YAML config
      SHA-256 hashing
    Use cases
      Clean Downloads folder
      Remove duplicates
      Scheduled organizing
    Audience
      Everyday Windows users
    Setup
      npm install
      pip install
      Clone repo

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Clean up a messy Downloads folder by sorting files into type or date based subfolders.

USE CASE 2

Find and remove duplicate files using size, partial hash, and full hash checks.

USE CASE 3

Set up a scheduled or watch-mode job that keeps a folder automatically organized.

USE CASE 4

Use AI-assisted classification to sort files with unclear or ambiguous names.

What is it built with?

PythonYAMLSHA-256Windows Task Scheduler

How does it compare?

j-akiru5/prism-organizeraa2448208027-code/localaihotswapamapvoice/pilottts
Stars393939
LanguagePythonPythonPython
Setup difficultyeasymoderatehard
Complexity2/53/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

The npm package downloads a standalone binary, so Python is not required unless you install via pip.

MIT license: free to use, modify, and redistribute, including commercially, as long as you keep the copyright notice.

So what is it?

Prism Organizer is a command-line tool for Windows that scans a folder on your computer and helps you sort, clean, and understand what is in it. You point it at a directory like your Downloads folder and it produces a report breaking down file types, the largest files, duplicates, and junk files like incomplete downloads or temporary files. The tool can reorganize files in two ways: by type (moving images, documents, videos, and code files into separate subfolders) or by date (sorting files into year and month folders). A three-phase duplicate finder checks file size first, then a partial hash, then a full SHA-256 hash to confirm exact duplicates quickly. There is also a perceptual hashing mode that finds visually similar images even if they are not byte-for-byte identical. Every operation creates a log so you can undo it, and by default the tool shows a preview of what it will do before making any changes. Beyond the basic commands, the tool offers a watch mode that monitors a folder in real time and automatically sorts or cleans new files as they arrive. A scheduling feature connects to Windows Task Scheduler so you can run organize jobs on a daily or weekly basis without opening the tool manually. If you want to define your own sorting rules, you can write them in a YAML configuration file. An AI classification feature can suggest categories for files whose names are ambiguous. It supports three providers: OpenAI (paid, cloud-based), Ollama (free, runs locally on your machine), and LM Studio (free, runs locally). An interactive setup wizard walks you through choosing and configuring a provider. Installation does not require Python if you use the npm package, which downloads a standalone binary on first run. Python users can also install it with pip or clone the repository directly. The tool runs on Windows and is released under the MIT license. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Show me the command to preview how this tool would reorganize my Downloads folder before actually moving anything.
Prompt 2
Help me write a YAML config file that sorts my files by type into custom named folders.
Prompt 3
Explain how the three-phase duplicate detection in this tool works and why it checks size before hashing.
Prompt 4
Walk me through setting up the free local AI classification option instead of the paid OpenAI provider.

Frequently asked questions

What is prism-organizer?

A Windows command-line tool that scans a folder, reports what's in it, and can automatically sort, deduplicate, and clean up your files.

What language is prism-organizer written in?

Mainly Python. The stack also includes Python, YAML, SHA-256.

What license does prism-organizer use?

MIT license: free to use, modify, and redistribute, including commercially, as long as you keep the copyright notice.

How hard is prism-organizer to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is prism-organizer for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.