damn-download

Analyze and categorize files in your Downloads folder using client-side RAG.

Uses a hybrid approach: known file extensions are instantly classified, while unknown/ambiguous files are categorized via ChromaDB with local embeddings (all-MiniLM-L6-v2 via ONNX — no API keys needed).

Install

Requires Python >= 3.14 and uv.

uv sync

Usage

# Scan and show files
damn-download scan ~/Downloads

# Categorize files
damn-download categorize ~/Downloads

# Categorize recursively
damn-download categorize ~/Downloads -r

# Preview organization (dry-run)
damn-download organize ~/Downloads

# Actually move files into category folders
damn-download organize ~/Downloads --execute

# Add a custom category
damn-download add-category "game-mods" "Game modification files, mods, resource packs, texture packs, .jar mod files for Minecraft, .osz beatmap files for osu!"

# List all categories
damn-download categories

# Reset category database
damn-download init --reset

Categories

Built-in categories: documents, images, videos, audio, archives, installers, code, data, ebooks, fonts, disk-images, torrents.

Add custom categories with damn-download add-category to improve classification for your specific file types.