Run your codex-pets.net desktop companions on Windows 11.
Loads any .codex-pet.zip file and animates the sprite on your desktop: transparent, always-on-top, draggable, and able to wander around the screen.
- Windows 11
- Python 3.10+
Pillowfor WebP spritesheet loadingPySide6for the transparent desktop window
Open PowerShell in this repository and run:
.\install_win.ps1If PowerShell blocks local scripts, run this once for the current terminal:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\install_win.ps1Pets are loaded from two directories. Both are created by the installer.
| Directory | Notes |
|---|---|
%USERPROFILE%\pets\ |
Primary library |
%USERPROFILE%\.codex\pets\ |
Secondary library |
- Download any
.codex-pet.zipfrom codex-pets.net - Drop the file into
%USERPROFILE%\pets\ - It will appear automatically in the right-click menu
# Launch with the first pet found in your pets folder
%USERPROFILE%\.local\bin\codex-pet-win.cmd
# Launch a specific pet
%USERPROFILE%\.local\bin\codex-pet-win.cmd %USERPROFILE%\pets\grogu-kid.codex-pet.zip
# Larger size; default scale is 0.5
%USERPROFILE%\.local\bin\codex-pet-win.cmd --scale 0.75| Action | Result |
|---|---|
| Left-click | Trigger waving animation |
| Left-drag | Pick up and move the pet |
| Right-click | Context menu |
- Pet list: switch instantly between pets in your library
- Enable movement: pet wanders around the screen using Run Right / Run Left animations
- Run on startup: creates/removes a Startup folder launcher
- Keep screen awake: asks Windows to keep the display and system awake while the app is running
- Quit
The .codex-pet.zip format from codex-pets.net contains:
pet.json # metadata: id, displayName, spritesheetPath
spritesheet.webp # RGBA spritesheet: 192x208px tiles, 8 cols x 9 rows
| Row | Animation | When used |
|---|---|---|
| 0 | Idle | Standing still |
| 1 | Run Right | Moving right |
| 2 | Run Left | Moving left |
| 3 | Waving | Left-click / drop |
| 4 | Jumping | Dragging |
| 5 | Failed | Sleeping after 60 seconds idle |
| 6 | Waiting | Moving vertically |
| 7 | Running | Reserved |
| 8 | Review | Rare special event |
Blank frames at the end of each row are detected and skipped automatically.