Mouzi 🧹🐁

Your downloads, tamed.

Mouzi is a silent, elegant file organizer that lives in your system tray and keeps your Downloads folder (and any other folder) automatically tidy. It runs quietly in the background, monitors selected folders, and moves, renames, or sorts files based on customizable rules.

• Runs 24/7 in the background with minimal resource usage (~5 MB RAM)
• Automatically organizes new files as they arrive
• Shows a subtle Windows toast notification with the count of organized files
• Silent autostart with Windows

• Images (.jpg, .png, .gif, .webp...) → Downloads/Images/
• Documents (.pdf, .docx, .xlsx...) → Downloads/Documents/
• Archives (.zip, .rar, .7z...) → Downloads/Archives/
• Installers (.exe, .msi...) → Downloads/Installers/
• Music / Video → dedicated folders
• Catch-all rule for everything else

• Create your own rules with extensions, regex patterns, and destination folders
• Use dynamic placeholders in paths: {year}, {month}, {day}, {extension}, {filename}
• Reorder rules by priority - first match wins

• Per-folder ignore patterns — like .gitignore for your files
• Set up via Settings UI or write a .mouziignore file manually
• Supports wildcards (*.tmp), exact names (.DS_Store), and folders (node_modules/)

Each watched folder can run in one of three modes:

• Silent - automatically organize files as they arrive (default)
• Manual - collect files and only process them when you click Clean Now
• Paused - watch the folder but don't move anything

• Import .zip, .tgz, or .tar.gz archives directly from Google Takeout
• Files are extracted to a staging folder and sorted using your existing rules
• No need to manually unzip and reorganize everything

• Every action is logged locally in SQLite
• Undo any single move with one click
• Clear history anytime

Auto-detects your system language. Supported:

• 🇬🇧 English
• 🇵🇱 Polish
• 🇮🇹 Italian
• 🇩🇪 German
• 🇫🇷 French
• 🇷🇺 Russian
• 🇯🇵 Japanese
• 🇻🇳 Vietnamese
• 🇪🇸 Spanish
• 🇺🇦 Ukrainian

(Falls back to English if system language is not supported)

• Follows system theme, or force Light / Dark mode from settings

• 100% offline - zero cloud, zero file name uploads
• No telemetry by default
• System files ignored - desktop.ini, Thumbs.db, .DS_Store, and other OS hidden files are never touched
• Portable version available - run without installing, leaves no trace in the registry
• All data stored locally in your user profile folder

⚠️ Windows 10/11. Requires the Microsoft Edge WebView2 Runtime (pre-installed on most systems).

🐧 Linux requirements: libwebkit2gtk-4.1 and libayatana-appindicator3. Most modern distros have these pre-installed.

SHA-256 Checksums

Mouzi_0.1.5_x64-setup.exe:   ee9b173aaa10c03fac5c201345cb388115bbb0c78e2e294a92d18fad454e99a2
Mouzi_0.1.5_amd64.AppImage:  6801341766201a7a2a6c45fb3217757567b27507bef74b5e7bf6d847fdbfc5bb
Mouzi_0.1.5_amd64.deb:       73301c563a7c00dd4a68d143550d953ca8644c206a7603b4f3f8be066e0efe6a
Mouzi-0.1.5-1.x86_64.rpm:    62a2e565f4dcd3e6a19c19122d4399b77684c07826419d2515a1e1aa532f56d6

1. Download Mouzi for your OS using the links above.
2. Windows: Install and Mouzi starts automatically with a tray icon (📂). Linux: Run the AppImage directly, or install the .deb/.rpm package.
3. Left-click the tray icon to open the popup - see recent actions, stats, and clean manually.
4. Right-click the tray icon for the menu: Clean Now, Settings, Quit.
5. Drop a file into your Downloads folder and watch it disappear into the right subfolder within 2 seconds.

Rules are evaluated top-to-bottom. The first rule that matches a file wins.

Destination path placeholders:

Downloads/Documents/{year}/{month}/
→ Downloads/Documents/2026/05/

A computer repair technician uses Mouzi to automatically move ScreenConnect installers out of the Downloads folder before less-technical users can open them—adding an extra layer of friction against remote-access scams.

Read the case study: How Mouzi is being used to reduce ScreenConnect scam risk →

Mouzi is a file organizer, not antivirus or endpoint security software. Filename-based rules should be used as an additional safeguard, not as a replacement for security software and user education.

+---------------------------------------------+
|  Frontend (React 19 + TypeScript + Tailwind) |
|  +- Popup window (300x420, frameless)        |
|  +- Settings window (900x650)                |
+---------------------------------------------+
|  Tauri 2.x Bridge                            |
+---------------------------------------------+
|  Backend (Rust)                              |
|  +- File Watcher (notify crate)              |
|  +- Rules Engine                             |
|  +- Scheduler (time-based cleaning)          |
|  +- SQLite Database (rusqlite)               |
|  +- System Tray & Notifications              |
+---------------------------------------------+

• Rust (latest stable)
• Node.js 22+
• Windows: Windows SDK / MSVC (Visual Studio Build Tools)
• Linux: libwebkit2gtk-4.1-dev, libayatana-appindicator3-dev, fuse (see Tauri Linux prerequisites)

# Clone the repo
git clone https://github.com/yourusername/mouzi.git
cd mouzi

# Install frontend dependencies
npm install

# Run in development mode (hot-reload for both frontend & Rust)
npm run tauri dev

# Production build (MSI + NSIS installer)
npm run tauri build

Output will be in src-tauri/target/release/bundle/.

• Added a quick enable/disable switch directly to every rule row.
• .mouziignore now supports inline comments. Escape a literal # as \#.

MVP with default rules, multi-language support, dark mode, history & undo, start with Windows, custom folders with local rules, folder modes (silent / manual / paused), system files ignored, check for updates, .mouziignore, portable version, browser temp files ignored, grace period option, file lock check, single-instance guard, first-run popup visibility, clickable toast, skip 0 KB placeholder files, Linux port, Google Takeout archive import, Wayland crash workaround.

• Rename "Clean Downloads" to "Organize Downloads" to avoid implying that files will be deleted (#51)
• Detect extensionless files by magic bytes and route them through the existing rules engine (#49)
• Confirmation dialog for "Delete History" button
• Batch group selected files
• Suggest mode (modal confirmation per file)
• Custom notification / popup after intercepting files (e.g. "Dangerous file moved by Mouzi")
• Extension normalization rule (per-rule toggle + custom mappings, e.g. .jpeg → .jpg)
• Rename "Edit" button to "Save" in rule editor
• Better error messages for invalid rules / input
• Move files to Recycle Bin instead of permanent move
• Auto-update via Tauri updater
• Windows Explorer context menu ("Add to Mouzi")
• npm wrapper (npm install -g mouzi) for cross-platform CLI install
• Local AI tagging (ONNX runtime for content classification)
• Rule learning from user manual moves
• macOS port

If Mouzi saves you time and keeps your Downloads folder sane, consider supporting its development:

Or visit the project homepage: mouzi.cc

Order folders any way you want inside Windows File Explorer, and add custom thumbnails.

Mouzi is released under the MIT License.

Built with Tauri, React, Tailwind CSS, and Rust.

_{Made with ❤️ for people who download too much stuff.}