A little life on your desk. PixelPet by Dloper brings animated pixel-art companions to Stream Deck keys, the Stream Deck Neo Infobar, and rotary dial displays. Choose built-in companions, interact with snacks and petting, roll toy balls on rotary encoders, and import custom Codex Pet packages.
Requirements & Compatibility
- Stream Deck App: Version 7.6 or later.
- Operating System: macOS 13 or later (Ventura, Sonoma, Sequoia) or Windows 10 / Windows 11 x64.
- Hardware Surfaces:
- Standard LCD Keys: Stream Deck Mini, Stream Deck Mk.2, Stream Deck XL, Stream Deck Mobile.
- Infobar Ribbon: Stream Deck Neo (232 × 50 display).
- Rotary Dials & Touchstrips: Stream Deck +, Corsair Galleon 100 SD, and compatible encoder devices.
Install and Get Started
- Visit the PixelPet Plugin Page or find PixelPet Pro / PixelPet Lite on Elgato Marketplace.
- Choose Open in Stream Deck. Stream Deck downloads and installs the plugin automatically.
- Locate the PixelPet Pro or PixelPet Lite category in the Stream Deck actions sidebar.
- Drag an action onto your canvas:
- Pet Habitat Key onto any standard LCD key.
- Roaming Infobar Pet onto the Neo Infobar.
- Pet Playground & Dial onto an encoder slot on Stream Deck +.
- Click the action to open its Property Inspector, choose your companion (Dog, Cat, or Fox), select a theme, and give your pet a custom name!
Choose Your Companion
Open the action settings and select Dog (Boba), Cat (Mochi), or Fox (Maple) from the companion preview grid. The active pet displays a checkmark. You can customize the name in the same settings panel.
| Feature |
PixelPet Lite |
PixelPet Pro |
| Boba the Dog & Mochi the Cat |
Included |
Included |
| Maple the Fox |
Visible, locked (shows upgrade prompt) |
Included |
| Pet Habitat Key & Neo Infobar Wandering |
Included |
Included |
| Dial Treats & Touch Display Interactions |
Included |
Included |
| Meadow, Moonlit Garden, and Cozy Room Themes |
Included |
Included |
| Adjacent-Dial Panorama & Auto-Sleep |
Included |
Included |
| Dial Toy Ball (Encoder Rotation) |
Pro upgrade |
Included |
| Compatible Custom Codex Pet Imports |
Pro upgrade |
Included |
Shared Device State: Feed, Pet, and Sleep interactions affect all visible PixelPet habitats on the same physical Stream Deck device so your companions react together.
Actions Guide
1. Pet Habitat Key
Place this action on any standard LCD key. Your companion rests or wanders inside its habitat tile.
- Press Action: Dispenses a treat by default and triggers a joyful heart reaction. You can change this in settings to pet your companion or toggle sleep instead.
- Settings Panel: Change your companion, select themes, and customize interaction behaviors.
2. Roaming Infobar Pet
Place this action on the Stream Deck Neo Infobar. Your pet freely explores the wide 232 × 50 pixel ribbon, pausing, turning around, and resting at the edges.
Note: Neo's page navigation touch points remain reserved for hardware profile switching; use your Habitat Key or action settings for direct pet feeding and sleeping.
3. Pet Playground & Dial
Assign this action to any rotary dial on a Stream Deck + or supported encoder device:
| Control |
Behavior |
| Push the dial |
Drops a tasty snack into the habitat for your companion to eat. |
| Rotate the dial (Pro) |
Rolls a colorful toy ball back and forth across the screen for your pet to chase! |
| Tap the touch display |
In Pro: tapping your pet makes it leap with joy; tapping empty space drops a ball. In Lite: tapping triggers a happy reaction. |
Adjacent Dial Panorama: Place PixelPet on adjacent encoder dials and enable "Join adjacent PixelPet dials into one habitat" in each instance's settings. With matching companion and theme selections, your dials merge into one continuous panoramic roaming playground!
Appearance, Audio & Rest
- Themes: Choose between Meadow (daylight grass & flowers), Moonlit Garden (twilight night sky), or Cozy Room (warm indoor decor).
- Soft Petting Audio: When petting your companion, a gentle synthesized purr plays through your system speakers. This can be silenced at any time by toggling "Soft sound when petting" off in settings.
- Automatic Sleep: Using your computer's native idle detection, PixelPet will automatically curl up and take a nap after 5 minutes of computer inactivity. Wiggle your mouse or press any key to wake your pet up! Automatic sleep can also be disabled in settings if you prefer them to stay awake.
Importing Custom Pets in Pro
PixelPet Pro allows you to import third-party sprite sheets from codex-pets.net or custom packages with zero cloud lock-in.
- Download a compatible pet ZIP from codex-pets.net, or prepare a folder containing
pet.json and a sprite sheet.
- Select a PixelPet Pro action in Stream Deck and scroll to the Custom Pets section.
- Click Choose ZIP or Choose Folder (or drag and drop your package into the upload box).
- Wait for the validation confirmation. Your imported companion appears in the selection grid ready to use!
Package Specifications:
- The package must contain exactly one
pet.json file with an id, name, and relative spritesheetPath.
- The sprite sheet must be a transparent PNG or WebP with 8 columns, 9–11 rows, and 192 × 208-pixel cells (total dimensions: 1536 px wide by 1872, 2080, or 2288 px high).
- ZIP archives must be 20 MB or smaller, containing at most 64 entries and expanding to no more than 24 MB.
Privacy Guarantee: All imported artwork is stored 100% locally on your machine. PixelPet does not require or connect to ChatGPT, OpenAI, or Codex accounts.
Troubleshooting & FAQs
My pet is not moving
- Check if the pet is asleep. Press your Habitat Key or use the Sleep control in the settings panel to wake it up.
- If automatic sleep is enabled, move your mouse or press a key to reset computer idle time.
- Confirm the action is on an active profile and visible page. Hidden actions pause drawing.
- Switch to Dog or Cat to verify if the issue is specific to a custom sprite sheet.
Maple shows a locked message
Maple the Fox is an exclusive companion in PixelPet Pro. In PixelPet Lite, clicking Maple keeps your current companion active and displays an upgrade link. Purchasing Pro will install the full PixelPet Pro action set.
Custom pet import failed
- Dimensions: Verify the sprite sheet is exactly 8 columns by 9–11 rows with 192 × 208 px cells. A single frame will not import.
- Structure: Ensure
pet.json is located at the root of the ZIP and points correctly to the image file without changing folder paths.
- Local Files: Make sure the ZIP file is stored on a local drive (e.g. your Downloads folder) and not in an unloaded cloud storage container.
The pet flashes or clips on screen
PixelPet automatically fits the 192 × 208 cell to your display aspect ratio. If custom artwork leaves excess transparent margins inside individual cells, the pet may appear smaller. Unused transparent frames at the end of animation cycles are automatically skipped.
Need Further Assistance?
If you encounter an issue not covered in this guide, reach out to our team: