CN File Organizer

Automated desktop file classification, duplicate detection, and workspace organizer.

Executive Overview

CN File Organizer eliminates digital chaos by turning disorganized directories—such as system download folders, desktop screens, and project assets—into structured, categorized file hierarchies according to custom user parameters and file metadata.

The Problem & Motivation

Over time, modern knowledge workers and developers accumulate thousands of disorganized files. Manual sorting is tedious and frequently skipped, while simple file-renaming scripts risk overwriting critical files or breaking references.

Architecture & System Design

Built with a reactive background file system watcher and a pipeline execution model. Operations are validated in a dry-run verification sandbox before any file pointer is manipulated.

Architectural PipelineDirectory Watcher -> Event Trigger -> Rule Engine -> Hash Verification -> Transactional Safe Move -> Audit Log

Non-Destructive Execution: Every action generates an undo transactional log, allowing users to restore previous directory states with one click.

Chunked Hashing for Duplicates: Employs quick size-checks followed by incremental SHA-256 byte chunk comparisons to detect identical files without loading gigabytes of media into memory.

Pattern Matching Rules: Regex and MIME-type classification engines with customized target routing.

Technical Challenges & Solutions

1Challenge: Handling large media files (multi-gigabyte videos) during duplicate detection without causing UI freezes or OOM crashes.

Engineered Solution: Architected a progressive hash comparator: first comparing exact byte lengths, then comparing the first 4KB chunk, and only hashing full files when collisions remain unresolved.

2Challenge: Protecting against OS file-lock exceptions when sorting files currently open in other applications.

Engineered Solution: Implemented non-blocking retry queues and graceful skip-alerts that notify users of locked files without interrupting the entire organization batch.

Key Outcomes & Impact

Reduced routine workspace organization time from hours of manual sorting to a 2-second automated workflow.
Identified and reclaimed dozens of gigabytes of duplicate disk space across testing directories.
Built a fault-tolerant file management architecture with 100% rollback coverage.

Technology Stack

Release Changelog

v0.9.0-beta2025-06-20

• Directory watcher with real-time classification
• Smart duplicate detection with progressive SHA-256
• Dry-run simulation mode and undo log engine