Home

Welcome to the matechat wiki! This will detail initial installation instructions, and how to configure it for use.

Current version 1.2.1.

If there is a newer version on the Releases page, poke Drezzer on the Discord server to get this updated.

🎀 Installation

The default location for install is C:\Program Files (x86)\Steam\steamapps\common
If you have a different location, adjust the rest of the instructions to match.
Run Desktop Mate once and exit out of the game by righ clicking on the character and selecting Quit from the popup menu.

Download .NET for Windows here and run the installer.
- you can use version 8 or 9, they will both work.
Download the Microsoft Visual C++ package from here and run the installer.
- Both of these are links to the official MS source pages.
Download MelonLoader.Installer.exe. – Here
Run MelonLoader.Installer.exe.
Desktop Mate should show up in the list. If it does, click on Desktop Mate.
On the next screen, ensure that Version is 0.6.6.
Click Install at the bottom of the window.
Click OK and close the MelonLoader installer

Click Add Game Manually at the bottom of the window.
The default location for install is C:\Program Files (x86)\Steam\steamapps\common\Desktop Mate
Select Desktop Mate.exe in the folder.
Click Open at the bottom of the window.
On the next screen, ensure that Version is 0.6.6.
Click Install at the bottom of the window.
Click OK and close the MelonLoader installer

Download the latest Desktop.Mate.zip from the Releases page.
Extract the contents to match your Steam installation directory. Default is C:\Program Files (x86)\Steam\steamapps\common
- Double click the zip file to open it in File Explorer.
- Click 'Extract All' at the top of the window.
- Change the folder to extract to, to C:\Program Files (x86)\Steam\steamapps\common\ and click Extract.
- If it pops up a window that says 'Replace or Skip Files', select 'Replace the files in the destination'.
The extracted folder should contain:
- Desktop Mate\ directory
- Mods/ directory with the MateChat dll
- UserLibs/ with required libraries

Start Desktop Mate from Steam.
It will take a minute or two to load the first time, as MelonLoader has to decompile the Desktop Mate exe.
You'll see a white screen and possibly a terminal window with debug info.
Right-click on the character and select MateChat from the menu.
Click 'Open Config' in the window that pops up.
Configure your settings following the information at API Configuration
Close the terminal window
Click 'Reload Config' in the MateChat window that should still be open.
If you need to edit the configuration later, you can find the configuration file at UserData/MateChat.cfg in the Desktop Mate folder.

Below this line has not been updated yet.

Setup Text-to-Speech (Optional)
- Clone GPT-SoVITS repository
- Install pretrained models
- Run pip install -r requirements.txt
- Place a reference audio clip (<10s) in the root directory as reference.wav
- Start the TTS server: python api_v2.py