FROSTSWEEP

by FrostNode

Scan, categorize, and organize files into clean folder structures. Preview before you move. Undo when you need to.

> git clone > explore features

0+Lines

0Endpoints

0Tests

0Components

0Platforms

Capabilities

What FrostSweep does for your files

Smart File Scanning

Scans any folder to discover all file types, computing total counts, sizes, and per-category breakdowns in a single pass. Supports recursive subdirectory traversal.

Custom Category System

Create, edit, and delete file categories with custom extension rules and destination folder paths. Seven built-in categories included.

Organization Preview

See exactly where every file would move before touching anything. Full move plan with source paths, destinations, and category tags.

Dry Run Mode

Simulate the entire organization operation — logs every move that would happen without actually moving a single file.

One-Click Undo

Reverse the last organization instantly. Files are restored to their original locations with parent directories recreated as needed.

Duplicate Detection

Find duplicate files by filename across directories and identical content via MD5 hash comparison with 64KB block reads.

Six-Dimension Filtering

Filter by min/max file size, modified-after/before dates, extension whitelist, and extension blacklist. All filters combine.

Extension Selection Grid

Toggle individual file types on/off via interactive pills. Search, select all, or deselect all.

Real-Time Activity Log

Color-coded, timestamped log of every operation. Auto-scrolls, clearable, and exportable to CSV.

Scan Statistics Dashboard

Visual breakdown showing total files, total size, category distribution, and the top 5 largest files.

Dark & Light Themes

Full dark/light theme toggle with CSS custom properties.

Native Desktop Dialogs

OS-native folder picker and file save dialogs via Electron IPC.

Path Security

System-critical directories blocked. Export paths validated. CORS restricted to localhost. Backend binds to 127.0.0.1.

Catch-All Organization

Files with unknown extensions route to categorized subfolders under "Other Files" — organized by extension name.

Use Cases

Real-world scenarios where FrostSweep saves you time

Downloads Folder Cleanup

Your Downloads folder has 500+ files accumulated over months. FrostSweep scans it, shows the breakdown, and organizes everything into category folders in seconds.

$ cd backend && python main.py --port 19542

file-cleanupdownloadsbulk-organize

Project Asset Sorting

A design project directory has hundreds of mixed assets. Create custom categories for each asset type with specific destination folders, preview the plan, then execute.

$ # Settings tab → Create categories → Scan → Preview → Organize

design-assetscustom-categoriesproject-management

Duplicate Hunting

Multiple backup copies have created duplicate files everywhere. Find files with identical content via MD5 hashing, then decide what to keep.

$ # Duplicates tab → Scan with subdirectories → Review report

deduplicationdisk-cleanupcontent-hash

Selective File Migration

Moving to a new machine, need only files modified in last 6 months > 1MB, excluding temp files. Set filters, blacklist .tmp and .log, then organize.

$ # Filters: Min 1MB | After 2024-09-01 | Blacklist: .tmp,.log,.cache

migrationfilteringselective-move

Safe Reorganization with Undo

Reorganizing a shared folder but not sure if it works for everyone. Organize, review, and undo if needed.

$ # Organize → Review Activity Log → Undo if needed

undosafe-operationsreversible

Interactive Dashboard

Organize, deduplicate, and preview — all in one view

localhost:5173

~/Downloads

SubdirectoriesDry Run

Total Files

847

Total Size

2.3 GB

Supported Platforms

Run anywhere — desktop or browser

Windows 10/11

Full

NSIS installer. System32 blocked from organization.

macOS 12+

Full

DMG packaging. Standard macOS window lifecycle.

Linux

Full

AppImage packaging. Ubuntu, Fedora, Arch.

Browser

Development

Run backend + Vite dev server on localhost.

Quick Start

Clone, install, and run in minutes

Clone & Install
1> git clone https://github.com/dbeglaryan/FrostSweep.git
2> cd FrostSweep
3> cd backend && pip install -r requirements.txt && cd ..
4> cd frontend && npm install && cd ..
5> npm install

Development Servers
1> # Terminal 1: Python backend
2> cd backend && python main.py --port 19542
3> 
4> # Terminal 2: React frontend
5> cd frontend && npm run dev

Desktop App
1> npm run dev:electron

Run Tests
1> cd backend && python -m pytest tests/ -v
2> cd frontend && npx tsc --noEmit

Architecture

Electron + React + Python stack

Electron Shell

Spawns Python backend on a free port. Creates BrowserWindow and injects API URL.

React Frontend

Vite-built SPA with 11 components. HTTP/JSON communication with backend.

FastAPI Backend

12 REST endpoints. Thread-safe state with mutex lock. Path validation and CORS.

Core Engine

Scanner, organizer, filters, duplicates, config modules. Zero external deps beyond FastAPI.

File Operations

Extension matching, category routing, directory creation, dedup strategies, undo recording.

How FrostSweep Compares

Feature comparison with popular alternatives

Feature	FrostSweep	File Juggler	DropIt	Organize (CLI)
Cross-platform desktop app	Yes	Windows only	Windows only	macOS only
Custom category system	Yes	Yes	Yes	Yes
Preview before moving	Yes	No	No	Yes
One-click undo	Yes	No	No	No
Duplicate detection (content hash)	Yes	No	No	No
Six-dimension filtering	Yes	Partial	Partial	Partial
Dark/light theme	Yes	No	No	N/A
REST API backend	Yes	No	No	No
Open source	Yes	No	Yes	Yes
Real-time activity log	Yes	Yes	No	No
Dry run mode	Yes	No	No	Yes
Extension selection grid	Yes	No	No	No
Export logs to CSV	Yes	No	No	No
Price	Free	$40+	Free	Free