Mouzi on Linux — Mouzi docs

Install the AppImage, DEB or RPM and solve common tray, Wayland and data-location questions.

Public release: Mouzi v0.2.1. Features planned for a later version are labelled on the page.

Mouzi ships official x86_64 Linux builds as AppImage, DEB and RPM packages.

AppImage

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

The current release workflow also tests AppImage integration with AppManager. If an older artifact fails to integrate, run it directly and download the newest public release before reporting the problem.

Debian, Ubuntu and Mint

sudo apt install ./Mouzi_*_amd64.deb

Fedora

sudo dnf install ./Mouzi-*.x86_64.rpm

Other RPM-based distributions may use their own package manager.

Runtime libraries

Mouzi relies on WebKitGTK 4.1 and Ayatana AppIndicator libraries. Package names vary by distribution; common names include libwebkit2gtk-4.1 and libayatana-appindicator3 or their distribution-specific equivalents.

Tray icon

Mouzi is designed to stay in the system tray. GNOME commonly needs an AppIndicator/KStatusNotifierItem extension. Install the extension using your distribution’s package manager or GNOME Extensions, then sign out and back in if the icon still does not appear.

Wayland

Mouzi sets WEBKIT_DISABLE_DMABUF_RENDERER=1 on Linux to avoid a known WebKitGTK/Wayland rendering failure. This is built into the application; you do not need to export it yourself.

Tray support still depends on the desktop environment. A missing tray host is separate from the Wayland rendering workaround.

If Settings is gray or blank, collect terminal output and compare GDK_BACKEND=x11 ./Mouzi_*.AppImage. GPU-specific EGL issues can remain. Do not use WEBKIT_DISABLE_COMPOSITING_MODE=1 as a general fix: it caused EGL_BAD_PARAMETER on the reported RDNA 4 / Mesa / Hyprland system. Include distribution, session and GPU information in a report.

Data locations

The SQLite database contains settings, rules, watched folders and history:

$XDG_DATA_HOME/mouzi/mouzi.db

When XDG_DATA_HOME is not set, this is normally:

~/.local/share/mouzi/mouzi.db

Archive imports use $XDG_CACHE_HOME/mouzi/archive-imports, normally ~/.cache/mouzi/archive-imports.

macOS

macOS is not officially supported. Experimental builds are tracked in issue #46, outside the official Windows/Linux release.