FolderFresh is licensed under GPL-3.0. Versions prior to 1.4.0 remain under the MIT license they were originally released with.
Website: https://trihedron1240.github.io/FolderFresh/
FolderFresh is a powerful, rule-based file automation engine that intelligently organises, manages, and processes your files in real-time. It's a full-featured automation tool for power users, developers, and anyone who needs advanced file management with complete control over their folder workflows.
Version 3.0.0 is a complete rewrite of FolderFresh, rebuilt from the ground up using modern Windows technologies for superior performance, reliability, and native integration.
Note: This is a beta release. Some features may be incomplete or subject to change. Please report any bugs or issues on the GitHub Issues page.
- Rebuilt in C# / .NET 9 — Native Windows performance replacing Python
- WinUI 3 Interface — Modern Fluent Design UI with smooth animations
- Native Windows Integration — Toast notifications, system tray, registry startup
- Async Architecture — Non-blocking operations throughout for a responsive experience
- Advanced Pattern Matching — Full regex support with case sensitivity options
- Date Range Conditions — Match files by creation/modification date ranges
- Multiple Actions Per Rule — Execute several actions when a rule matches
- Dynamic Placeholders — Use
{date:format},{extension},{counter},{name}in destinations
- Complete Configuration Snapshots — Each profile stores rules, categories, and settings
- Instant Profile Switching — Change entire automation setups with one click
- Profile-Folder Linking — Assign specific profiles to watched folders
- Import/Export Ready — JSON-based storage for easy backup and sharing
- Intelligent Debouncing — Waits for file writes to complete before processing
- Loop Prevention — Tracks recently organized files to prevent infinite loops
- Per-Folder Status — See watching/organizing/error state for each folder
- Independent Profiles — Each watched folder can use a different profile
- Subfolder Support — Optionally monitor subdirectories
- Native Notifications — Proper Windows 10/11 toast notifications
- Organization Alerts — Get notified when files are automatically organized
- Error Notifications — Know immediately when a watcher encounters issues
- Works in Tray Mode — Notifications appear even when minimized to tray
- Minimize to Tray — Keep FolderFresh running without taskbar clutter
- Close to Tray — X button minimizes instead of closing
- Start Minimized — Launch silently on Windows startup
- Quick Controls — Pause/resume all watchers from tray context menu
- Discord-Inspired Design — Familiar dark purple aesthetic
- Consistent Styling — Unified look across all components
- High Contrast Text — Excellent readability in all conditions
- Create custom rules with flexible conditions and actions
- Match by: filename patterns (regex/glob), file size, creation/modification date, path depth, file content, extension
- Operators: contains, starts with, ends with, equals, regex, greater/less than, date ranges, and more
- Act with: move, copy, rename, delete, sort into subfolders
- Condition Groups: nest conditions with AND/OR/NONE logic for complex matching
- Priority execution: rules run in order; first match wins
- Test mode: preview rule effects before applying to real files
- Profile-specific rules: different automation for different workflows
- Auto-organises files when rules don't match (can be disabled)
- Default categories: Documents, Images, Audio, Video, Archives, Other
- Visual icons: Each category has a distinctive emoji
- Customizable: Change names, colors, extensions, and destination folders
- Sorts by file type with intelligent extension mapping
- Auto-organize files as they're created or modified
- Multiple folders with independent automation profiles
- Safe writing: 1-second debounce ensures files finish writing before processing
- Status indicators: See if each folder is idle, watching, organizing, or has errors
- Pause/Resume: Stop all watchers globally from system tray
- Create multiple profiles for different workflows (Downloads, Work, Photography, etc.)
- Complete snapshots: Each profile saves its own rules, categories, and settings
- Quick switching: Change your entire setup instantly
- Folder mapping: Assign different profiles to different watched folders
- Preview Mode: See exactly what will happen before organizing
- Undo History: Revert recent file operations
- Trash Support: Optionally move deleted files to Recycle Bin instead of permanent delete
- System Tray: Minimize or close to tray, start minimized
- Windows Startup: Optionally launch FolderFresh when Windows starts
- Toast Notifications: Native Windows notifications for organize events
- Modern UI: WinUI 3 with Fluent Design principles
Desktop
├── Documents
├── Images
├── Videos
├── Audio
├── Archives
└── Other
- Windows 10 (version 1809 or later) or Windows 11
- x64 processor
- .NET 9.0 Runtime (included in installer)
Download the latest installer from the Releases page.
git clone https://github.com/Trihedron1240/FolderFresh.git
cd FolderFresh/FolderFreshLite
dotnet restore
dotnet build
dotnet run- Microsoft.WindowsAppSDK — WinUI 3 framework
- Microsoft.Windows.SDK.BuildTools — Windows SDK integration
- System.Text.Json — JSON serialization
- Visual Studio 2022 (17.8+) with ".NET Desktop Development" workload
- Windows App SDK extension
- .NET 9.0 SDK
- Open
FolderFreshLite.slnin Visual Studio - Select
Releaseconfiguration andx64platform - Build → Build Solution (Ctrl+Shift+B)
- Output will be in
bin/Release/net9.0-windows10.0.22621/
- Build in Release mode
- Run the Inno Setup script in the
installer/folder - Installer will be created in the output directory
All settings are stored in %APPDATA%\FolderFresh\:
Version 3.0 is a complete rewrite and does not automatically migrate settings from v2.0. You will need to:
- Note your existing rules and categories in v2.0
- Recreate them in v3.0 using the new rule editor
- Set up your watched folders and profiles
Pull requests, issues, and suggestions are welcome. FolderFresh is an open project made to help users stay organised effortlessly.
Some UI and backend improvements were refined using AI-assisted development tools (Claude Code, ChatGPT). All logic has been manually reviewed, tested, and verified. No proprietary or third-party code is used.
- Complete rewrite in C# / .NET 9 with WinUI 3
- Profile system with complete configuration snapshots
- Native Windows toast notifications
- System tray integration with minimize/close to tray
- Modern Fluent Design dark theme
- Significant performance improvements and fixes
- Transition from customtkinter to PySide6
- Advanced rule engine with multi-condition matching
- Profile system with per-folder mapping
- Real-time auto-sync with multiple folders
- Smart category sorting with auto-detection
- Initial releases with basic file organization
- Category-based sorting
- Simple UI with customtkinter