Getting started

Mouzi is a local tray application for organizing files with rules. It does not require an account or send your file names or rules to a server.

These docs describe the latest public release shown in the sidebar. Features that are already in the source code but not yet in that release are marked explicitly.

Install Mouzi

Windows: download the installer for the simplest setup. An MSI and a portable executable are also available. Read the Windows guide before using the portable build.

Linux: download the AppImage, DEB or RPM. All current Linux builds are for x86_64. For an AppImage:

chmod +x Mouzi_*.AppImage
./Mouzi_*.AppImage

Mouzi runs in the system tray. Open its window by clicking the tray icon.

What happens on first run

Mouzi adds your Downloads folder in Silent mode, creates a starter set of rules and enables Start with system. Because Silent mode is automatic, existing top-level files in Downloads may be organized when watching starts.

If you want to explore without moving real files:

1. Create an empty folder such as Mouzi test.
2. Add it under Settings → Folders.
3. Set Downloads to Paused, or remove it temporarily.
4. Put copies of a few files in the test folder.
5. Use Manual mode until the results look right.

Create your first rule

Rules are shared by every watched folder. A relative destination is resolved inside the folder containing the matched file.

1. Open Settings → Rules and choose Add rule.
2. Enter an extension such as pdf.
3. Set the destination to Documents/{year}/{month}.
4. Save the rule.
5. Drop a PDF into the top level of your test folder.

In Silent mode, Mouzi waits for the configured grace period and then moves the file. In Manual or Suggest mode, choose Organize, review the matched files and destinations, then confirm selected operations. The result will look like Documents/2026/08/report.pdf.

Important limits

• Mouzi watches the top level of each selected folder, not nested subfolders.
• Rules are global, not assigned to individual watched folders.
• Rules can move, rename, ignore or send files to the system Recycle Bin/Trash. Automatic permanent deletion is not offered.
• Existing files are never overwritten; planned names use a numeric suffix, and later conflicts require a refreshed preview.
• The updater checks GitHub and offers installation after confirmation. Automatic checks can be disabled in General settings.

Continue with folders and modes, then read the full rules guide.