🌐 Language / 语言选择

• English
• 中文

---

English

Important

I'm currently a high school student, with studies coming first! Responses to issues/PRs, frequency of releasing may be slow (usually 1-4 weeks). Feel free to submit PRs to help fix bugs or discuss in Discussions. Thanks for your understanding and support! 🚀

Mate-Engine-Linux-Port

This is an unofficial Linux port of shinyflvre's MateEngine - A free Desktop Mate alternative with a lightweight interface and custom VRM support. Tested on Ubuntu 24.04 LTS.

Usage

Simply grab a prebuilt one in Releases page. Then, run the launch.sh script in the output directory (This script is necessary for window transparency. For KDE, you also need to disable "Allow applications to block compositing" in systemsettings).

Requirements

• A common GNU/Linux distro
• A common X11 desktop environment which supports compositing (such as KDE, Xfce, GNOME, etc.)
• At least 1 GiB of swap space (optional)
• libpulse and pipewire-pulse (if you are using Pipewire as audio server)
• libgtk-3-dev libglib2.0-dev libayatana-appindicator
• libx11-6 libxext6 libxrender1 libxdamage1

On Ubuntu and other Debian-based Linux:

sudo apt install libpulse-dev libgtk-3-0t64 libglib2.0-0t64 libayatana-appindicator3-1 libx11-6 libxext6 libxrender1 libxdamage1

On Fedora:

sudo dnf install pulseaudio-libs gtk3 glib2 libX11 libXext libXrender-devel libXdamage libayatana-appindicator-gtk3

On Arch Linux:

sudo pacman -S libpulse gtk3 glib2 libx11 libxext libxrender libxdamage libayatana-appindicator

Note that if you use GNOME, you will need AppIndicator and KStatusNotifierItem Support extension to show tray icon.

How to build / compile

• For security reasons, you need to compile StandaloneFileBrowser plugin manually (just use make command under Mate-Engine-Linux-Port/Plugins/Linux/StandaloneFileBrowser, then copy libStandaloneFileBrowser.so to Mate-Engine-Linux-Port/Assets/MATE ENGINE - Packages/StandaloneFileBrowser/Plugins/Linux/x86_64)
• Then open the project in Unity 6000.2.6f2 and build the player with executable name "MateEngineX.x86_64"

Ported Features & Highlights

• Model visuals, alarm, screensaver, Chibi mode (they always work, any external libraries are not required for them)
• Transparent background with cutoff
• Set window always on top
• Dancing (experimental, require pulseaudio or pipewire-pulse for audio program detection)
• AI Chat (require Meta-Llama-3.1-8B-Instruct-Q4_K_M.gguf, case-sensitive)
• Mouse tracking (hand holding and eyes tracking)
• Discord RPC
• Custom VRM importing
• Simplified Chinese localization
• Event-based Messages
• Lower RAM usage than Windows version (Memory trimming enabled)

Known Issues

• Window snapping and dock sitting are still kind of buggy, and they don't work on XWayland Interface
• Crashes at low system performance (pa_mainloop_iterate)
• Limited window moving in Mutter (GNOME)
• PulseAudio sometimes returns an empty audio program name
• Mods do not load correctly

Removed

• Steam API (no workshop support)
• NAudio
• UniWindowController

This project lacks further testing and updates. Feel free to make PRs to contribute!

---

中文

Important

我是高二学生，学业很忙！ Issues/PR 回复与版本发布较慢，欢迎提交 PR 或去 Discussions 讨论。谢谢理解！

Note

项目仍在维护，但优先级在高考前会降低。

Mate-Engine-Linux-Port

这是一个非官方的MateEngine Linux移植版 - 一个免费的Desktop Mate替代品（桌宠软件），具有轻量级界面和自定义VRM支持。 已在Ubuntu 24.04 LTS上测试。

用法

在Releases页面获取预构建版本。必须运行输出目录中的launch.sh，否则 MateEngne 将缺少透明窗口背景（对于 KDE Plasma 桌面环境，你还需要在 KDE 系统设置中禁用“允许应用程序阻止显示特效合成”）。

系统要求

• 一个常见的 GNU/Linux 发行版
• 一个常见的 X11 桌面环境，支持显示特效合成（compositing） ，比如KDE，Xfce，GNOME等
• 至少 1 GiB 的交换空间（可选）
• libpulse-dev 和 pipewire-pulse (如果你在用 Pipewire 作为音频服务器)
• libgtk-3-dev libglib2.0-dev libappindicator3-dev
• libx11-6 libxext6 libxrender1 libxdamage1
• libayatana-appindicator

以下命令适用于 Ubuntu 和别的基于 Debian 的 Linux:

sudo apt install libpulse-dev libgtk-3-0t64 libglib2.0-0t64 libayatana-appindicator3-1 libx11-6 libxext6 libxrender1 libxdamage1

以下命令适用于 Fedora:

sudo dnf install pulseaudio-libs-devel gtk3-devel glib2-devel libX11-devel libXext-devel libXrender-devel libXdamage-devel libayatana-appindicator

以下命令适用于 Arch Linux:

sudo pacman -S libpulse gtk3 glib2 libx11 libxext libxrender libxdamage libayatana-appindicator

如果你使用 GNOME 桌面环境，你还需要安装 AppIndicator and KStatusNotifierItem Support extension 以显示托盘图标。

如何编译

• 出于安全原因，你需要手动编译 StandaloneFilebrowser 插件（只需在Mate-Engine-Linux-Port/Plugins/Linux/StandaloneFileBrowser下使用make命令，然后将libStandaloneFileBrowser.so复制到Mate-Engine-Linux-Port/Asset/MATE ENGINE - Packages/StandaloneFileBrowser/Plugins/Linux/x86_64）
• 然后使用 Unity 6000.2.6f2 打开此项目然后构建Player，将可执行文件重命名为"MateEngineX.x86_64"。

移植的功能与亮点

• 模型视觉效果、闹钟、屏保、Q版模式（它们不需要任何外部库，因此始终工作）
• 带 Cutoff 的透明背景
• 窗口置顶
• 跳舞（实验性，需要PulseAudio或Pipewire-Pulse用于音频程序检测）
• AI聊天（需要Meta-Llama-3.1-8B-Instruct-Q4_K_M.gguf，文件名区分大小写）
• 鼠标跟踪（手持和眼睛跟踪）
• Discord RPC
• 自定义 VRM 模型导入
• 简体中文版汉化
• 基于事件的提示信息
• 与 Windows 版相比，使用更少内存（已启用内存削减）

已知问题

• 坐在窗口和程序坞上仍然有点bug
• 系统性能较低时崩溃（pa_mainloop_iterate）
• Mutter 合成器（GNOME）中窗口的移动范围有限
• PulseAudio有时会返回空的音频程序名称
• Mod 不会正常加载

已删除

• Steam API (无创意工坊支持)
• NAudio
• UniWindowController

该项目缺乏进一步的测试和更新。请随时通过Pull Requests来贡献！