Skip to content

hsr88/mouzi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

11 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

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.

Windows Tauri Rust React License


๐Ÿ“ธ Screenshots

Zrzut ekranu 2026-05-09 184947 Zrzut ekranu 2026-05-09 185013

โœจ 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

๐Ÿ“ 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

๐Ÿ“œ History & Undo

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

๐ŸŒ Multi-language

Auto-detects your Windows system language. Supported:

  • ๐Ÿ‡ฌ๐Ÿ‡ง English
  • ๐Ÿ‡ต๐Ÿ‡ฑ Polish
  • ๐Ÿ‡ฎ๐Ÿ‡น Italian
  • ๐Ÿ‡ฉ๐Ÿ‡ช German
  • ๐Ÿ‡ซ๐Ÿ‡ท French

(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
  • All data stored locally in your user profile folder

๐Ÿ“ฅ Download

Installer Size Best For
Mouzi_0.1.0_x64-setup.exe ~3.3 MB Regular users (auto-installer)
Mouzi_0.1.0_x64_en-US.msi ~4.7 MB Enterprise / Active Directory

โš ๏ธ Windows 10/11 only. Requires the Microsoft Edge WebView2 Runtime (pre-installed on most systems).


๐Ÿš€ Quick Start

  1. Download & install Mouzi using the installer above.
  2. Mouzi starts automatically and places an icon in your system tray (๐Ÿ“‚).
  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.

โš™๏ธ 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/

๐Ÿ—๏ธ Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  Frontend (React 19 + TypeScript + Tailwind) โ”‚
โ”‚  โ”œโ”€โ”€ Popup window (300ร—420, frameless)       โ”‚
โ”‚  โ””โ”€โ”€ Settings window (900ร—650)               โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  Tauri 2.x Bridge                           โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  Backend (Rust)                             โ”‚
โ”‚  โ”œโ”€โ”€ File Watcher (notify crate)            โ”‚
โ”‚  โ”œโ”€โ”€ Rules Engine                           โ”‚
โ”‚  โ”œโ”€โ”€ SQLite Database (rusqlite)             โ”‚
โ”‚  โ””โ”€โ”€ System Tray & Notifications            โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ› ๏ธ Development

Prerequisites

  • Rust (latest stable)
  • Node.js 20+
  • Windows SDK / MSVC (Visual Studio Build Tools)

Setup

# 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

Build from Source

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

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


๐Ÿ“‹ Roadmap

  • MVP with default rules
  • Multi-language support
  • Dark mode
  • History & undo
  • Suggest mode (modal confirmation per file)
  • Start with Windows (registry Run key)
  • Local AI tagging (ONNX runtime for content classification)
  • Rule learning from user manual moves
  • macOS & Linux ports

โ˜• Support

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

ko-fi

Or visit the project homepage: mouzi.cc


๐Ÿ“„ License

Mouzi is released under the MIT License.


๐Ÿ™ Acknowledgements

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


Made with โค๏ธ for people who download too much stuff.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors