# 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.
[](https://www.producthunt.com/products/mouzi?launch=mouzi)
[](https://www.reddit.com/r/Mouzi/)
[](https://x.com/hsrvibe)
[](https://mouzi.cc)
[](https://mouzi.cc)
[](https://tauri.app)
[](https://www.rust-lang.org)
[](https://react.dev)
[](LICENSE)
[](https://gitgem.org/github/hsr88/mouzi)
[](https://sourceforge.net/projects/mozui/files/latest/download)
---
## ๐ธ Screenshots
---
## โจ Features
### ๐ Silent by Default
- 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
### ๐ Smart Rules Engine
- **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
### ๐ ๏ธ Fully Customizable
- 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
### ๐ซ Ignore Rules (.mouziignore)
- 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/`)
### ๐ Folder Modes
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 **Organize Now**
- **Paused** - watch the folder but don't move anything
### ๐ฆ Google Takeout Import
- 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
### ๐ History & Undo
- Every action is logged locally in SQLite
- Undo any single move with one click
- Clear history anytime
### ๐ Multi-language
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)*
### ๐ถ๏ธ Dark Mode
- Follows system theme, or force Light / Dark mode from settings
### ๐ Privacy First
- **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
---
## ๐ Help translate Mouzi
Want to use Mouzi in another language or improve an existing translation? Community translations are welcome, and you do not need to work on the rest of the application.
- Read the [step-by-step translation guide](CONTRIBUTING.md#translations).
- Browse the current [locale files](src/i18n/locales).
- Translation updates can be submitted directly as a pull request.
If you want to add a new language, open an issue first so we can confirm the language code and avoid duplicate work.
---
## ๐ฅ Download
### Windows
| Installer | Size | Best For |
|-----------|------|----------|
| [`Mouzi_0.1.6_x64-setup.exe`](https://mouzi.cc/download) | ~4.7 MB | Regular users (auto-installer) |
| [`Mouzi_0.1.6_x64_en-US.msi`](https://mouzi.cc/download) | ~7.8 MB | Enterprise / Active Directory |
| [`Mouzi_0.1.6_x64-portable.exe`](https://mouzi.cc/download) | ~18.2 MB | Power users (no install) |
> โ ๏ธ **Windows 10/11.** Requires the [Microsoft Edge WebView2 Runtime](https://developer.microsoft.com/en-us/microsoft-edge/webview2/) (pre-installed on most systems).
### Linux
| Package | Size | Best For |
|---------|------|----------|
| [`Mouzi_0.1.6_amd64.AppImage`](https://mouzi.cc/download/linux) | See release | Universal โ works on most distros |
| [`Mouzi_0.1.6_amd64.deb`](https://mouzi.cc/download/linux) | See release | Debian, Ubuntu, Mint, Pop!_OS |
| [`Mouzi-0.1.6-1.x86_64.rpm`](https://mouzi.cc/download/linux) | See release | Fedora, openSUSE, RHEL |
> ๐ง **Linux requirements:** `libwebkit2gtk-4.1` and `libayatana-appindicator3`. Most modern distros have these pre-installed.
**SHA-256 checksums:** every GitHub release includes a generated `SHA256SUMS.txt`
covering the exact published artifacts. Use that file instead of copying a checksum
from an older release.
---
## ๐ Quick Start
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 organize files manually.
4. **Right-click** the tray icon for the menu: `Organize Now`, `Settings`, `Quit`.
5. Drop a file into your `Downloads` folder and watch it disappear into the right subfolder within 2 seconds.
---
## โ๏ธ How Rules Work
Rules are evaluated top-to-bottom. The first rule that matches a file wins.
| Condition | Example Match |
|-----------|---------------|
| Extensions | `jpg`, `png`, `gif` |
| Regex pattern | `.*faktura.*` matches `faktura_2025.pdf` |
**Destination path placeholders:**
```
Downloads/Documents/{year}/{month}/
โ Downloads/Documents/2026/05/
```
---
## ๐ก๏ธ Community Use Case
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 โ](https://straycode.dev/blog/how-a-simple-downloads-organizer-is-being-used-to-stop-screenconnect-scams)
> 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.
---
## ๐ Architecture
```
+---------------------------------------------+
| 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 organization) |
| +- SQLite Database (rusqlite) |
| +- System Tray & Notifications |
+---------------------------------------------+
```
---
## ๐ ๏ธ Development
### Prerequisites
- [Rust](https://rustup.rs/) (latest stable)
- [Node.js](https://nodejs.org/) 22+
- **Windows:** Windows SDK / MSVC (Visual Studio Build Tools)
- **Linux:** `libwebkit2gtk-4.1-dev`, `libayatana-appindicator3-dev`, `fuse` (see [Tauri Linux prerequisites](https://v2.tauri.app/start/prerequisites/))
### Setup
```bash
# Clone the repo
git clone https://github.com/hsr88/mouzi.git
cd mouzi
# Install frontend dependencies
npm install
# Run in development mode (hot-reload for both frontend & Rust)
npm run tauri dev
```
### Build from Source
```bash
# Production build (MSI + NSIS installer)
npm run tauri build
```
Output will be in `src-tauri/target/release/bundle/`.
---
## ๐ Mouzi 0.1.6
### Release highlights
- Secure in-app update checks and one-click installation through the Tauri updater.
- Extensionless files recognized by their content and routed through existing rules.
- Selective batch organization for files waiting in Manual mode.
- Folder picker, quick enable/disable switch and accessible labels for rules.
- Per-rule extension normalization and custom notifications.
- Destructive rule actions now use the Recycle Bin or Trash.
- Confirmation before clearing history and clearer **Organize**/**Save** wording.
- `.mouziignore` inline comments, improved locked-file handling and updated translations.
---
## ๐ Roadmap
### Already implemented
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, secure automatic update checks, `.mouziignore`, portable version, browser temp files ignored, grace period option, file lock check, single-instance guard, first-run popup visibility, clickable and custom notifications, skip 0 KB placeholder files, Linux port, Google Takeout archive import, Wayland crash workaround, rule destination picker, quick rule toggles, extensionless-file detection, selective batches, extension normalization, Recycle Bin/Trash actions and history deletion confirmation.
### Upcoming
- [ ] Suggest mode (modal confirmation per file)
- [ ] Better error messages for invalid rules / input
- [ ] Optional screenshot cleanup: move screenshots older than a chosen number of days from system and custom screenshot folders to the Recycle Bin
- [ ] 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
---
## โ Support
If Mouzi saves you time and keeps your Downloads folder sane, consider supporting its development:
[](https://ko-fi.com/hsr)
You can also support Mouzi through [GitHub Sponsors](https://github.com/sponsors/hsr88).
Or visit the project homepage: **[mouzi.cc](https://mouzi.cc)**
---
## See Also
### [Ordir](https://github.com/landnthrn/ordir)
Order folders any way you want inside Windows File Explorer, and add custom thumbnails.
---
## ๐ License
Mouzi is released under the [MIT License](LICENSE).
---
## ๐ Acknowledgements
Built with [Tauri](https://tauri.app), [React](https://react.dev), [Tailwind CSS](https://tailwindcss.com), and [Rust](https://www.rust-lang.org).
---
Made with โค๏ธ for people who download too much stuff.