Petit Mates
Petit Mates brings small reptile companions to your app windows and desktop. This manual covers getting started, settings, and adding your own remarks. Use the menus and settings window for everyday adjustments.
Visit the Petit Mates website to meet the characters and see them in action. Downloads and release notes are available on GitHub.
Find what you need
| What you want to do | Read |
|---|---|
| Install the app and get started | User guide: installation |
| Move, add, or remove characters, or quit | User guide |
| Change size, startup counts, speech, or weather | Settings reference |
| Add your own remarks | Customization |
| Understand movement or look up detailed values | State transitions and behavior parameters |
Getting started
Petit Mates supports macOS 13 or later on Apple Silicon and Intel Macs, and Windows 11 on x86-64 PCs. Choose the download for your OS and processor. On Mac, copy the app to Applications; on Windows, extract the ZIP and launch the app. Keep the included Settings.exe in the same folder on Windows.
Follow the installation instructions for details. Screen Recording permission is not required on Mac.
Basic controls
Hold ⌘ on Mac or Ctrl on Windows while dragging to move a character. Use the Mac menu bar or Windows system tray to add or remove characters, open settings, or quit.
The user guide explains opening the menu, moving characters, and updating the app.
Settings
Choose Settings… from the menu to change size, startup counts, speech, weather, and more. Save and close the settings window; the app restarts to apply your changes.
The settings reference lists values and defaults, the user.toml location, and recovery steps for configuration errors.
Troubleshooting
Start with troubleshooting in the user guide. For configuration warnings, see recovery. If weather is missing, check weather settings.
Custom remarks and movement internals
Customization starts with adding remarks through user files. You do not need to edit files to change size or turn speech on or off.
For asset and behavior authors, see state transitions and behavior parameters. The original technical article paths are retained, with content updated to the current implementation.
About this manual
This manual is based on the v1.0.1 README, settings schema, and source code. Settings and internals were checked statically against the source; this work did not include new Windows hardware tests or live tests of customization examples. The source code is also available.