About Mouzi

Getting Started

1. Download and install Mouzi using the auto-installer (.exe) or MSI package from the homepage.

2. Launch Mouzi. It starts automatically and places an icon in your system tray.

3. Left-click the tray icon to open the popup - see recent actions, weekly 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.

Features

Silent by Design - Runs quietly in the background. No pop-ups, no interruptions - just a subtle toast when files are organized.

Smart Rules Engine - Define custom rules with extensions, regex patterns, and dynamic paths like {year}/{month}.

History & Undo - Every action is logged locally. Made a mistake? Undo any move with a single click. You can also Revert All from the History tab.

5 Languages - Auto-detects your system language. English, Polish, Italian, German, and French supported.

Dark Mode - Follows your Windows theme or switch manually between Light, Dark, and System.

Autostart - Mouzi registers itself to start with Windows automatically. Toggle this in Settings → General.

Configuration

Open Settings from the tray menu to customize Mouzi.

Watched Folders - Add or remove folders that Mouzi monitors. By default, only your Downloads folder is watched.

Rules - Create rules based on file extensions, regex patterns, or wildcards. Set custom destination folders with placeholders:

• {year} - current year (e.g. 2026)
• {month} - current month (e.g. 05)
• {filename} - original file name without extension

General - Change language, theme, and autostart behavior.

Ignore Rules

Mouzi can skip specific files or folders using ignore rules. You can set them up in Settings → Ignore, or create a .mouziignore file manually in any watched folder.

How it works. When Mouzi detects a new file, it first checks the .mouziignore file in that folder. If the file name matches any rule, Mouzi leaves it alone. Simple as that.

Adding rules in the app. Open Settings → Ignore, select a watched folder, and type your pattern in the input field. Press Enter or click Add, then Save. Mouzi will create (or update) the .mouziignore file automatically.

Writing rules manually. Create a plain text file named .mouziignore in the folder you want to control. Write one rule per line. Lines starting with # are comments and ignored.

Rule types:

• Exact name — desktop.ini ignores only that exact file.
• Wildcard — *.tmp ignores all files ending with .tmp. ~$* ignores all Office temp files.
• Folder — node_modules/ (with a trailing slash) ignores that folder entirely.

Common examples:

# Ignore Office temp files
~$*

# Ignore all .tmp files
*.tmp

# Ignore the node_modules folder
node_modules/

# Ignore macOS system files
.DS_Store

# Ignore Windows thumbnails
Thumbs.db

Tips:

• Rules are case-insensitive on Windows.
• Each watched folder can have its own .mouziignore file.
• If you delete the .mouziignore file, all files in that folder become eligible for sorting again.
• System files like desktop.ini are already ignored by default — you do not need to add them.

Privacy & Security

Mouzi is built on a local-first philosophy. This means:

• Zero cloud connections
• Zero telemetry or analytics
• All data stored in a local SQLite database
• No accounts or registration required

VirusTotal - You can verify Mouzi's safety on VirusTotal. Any detections are false positives from heuristic engines due to the app being new and unsigned.

SmartScreen - Windows may show a warning because Mouzi is not signed with a code certificate (which costs ~$400/year). Click "More info" → "Run anyway" to install.

FAQ

How does Mouzi work?
Mouzi sits in your system tray and watches selected folders. When a new file appears, it waits 2 seconds to ensure the download is complete, then moves it based on your rules.

Is my data sent anywhere?
No. Mouzi is 100% offline. Nothing ever leaves your computer.

Can I customize the rules?
Absolutely. Open Settings → Rules to create custom sorting logic.

What if Mouzi moves a file to the wrong place?
Open Settings → History. Every action can be undone with one click.

Does it start automatically with Windows?
Yes. You can toggle this in Settings → General.

Is it really free?
Yes. MIT License. Use it, modify it, build your own version.

Troubleshooting

Mouzi does not sort files.
Make sure the folder is added to Watched Folders and that at least one rule matches the file extension.

Undo does not work.
The destination file must still exist. If you moved or deleted it manually, undo cannot restore it.

Windows SmartScreen blocks the installer.
This is expected for unsigned apps. Click "More info" → "Run anyway".

High CPU or RAM usage.
Mouzi is designed to be lightweight. If you experience issues, check your Watched Folders - monitoring network drives or folders with thousands of files can cause load.