Desktop Pet — 南波万の小家园#

A pixel-art desktop pet built with Python + Tkinter. Features a mini floating character on the desktop and a full home-garden mode with four explorable scenes.

Features#

• Mini mode: Transparent floating pixel character with walk animation (128px, white oval background)

• Garden mode: 850×560 window with four scenes connected by doorways

  • 🏠 Indoor (1F) — cozy room with furniture
  • 🪜 Upstairs (2F) — mirrored warm-tone layout
  • 🌿 Outdoor — front yard with fence
  • 🌳 Forest — large woodland area

• Care system: Hunger / Mood / Cleanliness / Health with decay and recovery

• Controls: Arrow keys or WASD to walk, E to interact with doorways, T for debug mode

• Right-click menu: Feed 🍔 / Bathe 🛁 / Play 🎮 / Medicine 💊

Deployment#

1. Copy scripts/desktop_pet.py to target directory
2. Copy all files from assets/ into an assets/ subdirectory next to desktop_pet.py
3. Run:

bash

cd <target-dir>
pip install Pillow
TK_SILENCE_DEPRECATION=1 python3 desktop_pet.py

File structure after deployment#

text

target-dir/
├── desktop_pet.py
└── assets/
    ├── room_bg.png        # Indoor scene (1F)
    ├── upstairs_bg.png    # Upstairs scene (2F, mirrored + warm)
    ├── exterior_bg.png    # Outdoor scene
    ├── forest_bg.png      # Forest scene
    ├── walk_right.gif     # Character walk right (8 frames, 32×32)
    └── walk_left.gif      # Character walk left (8 frames, 32×32)

macOS notes#

• Uses overrideredirect(True) + systemTransparent for floating mini window
• PhotoImage doesn't render on transparent canvas → white oval workaround
• Set TK_SILENCE_DEPRECATION=1 to suppress Tk warnings

Scene transitions#

FromTriggerToIndoor 1FWalk to staircase (top-left) + EUpstairs 2FIndoor 1FWalk to carpet (bottom-right) + EOutdoorUpstairs 2FWalk to staircase (top-right) + EIndoor 1FOutdoorWalk to left edge + EForestOutdoorWalk to door + EIndoor 1FForestWalk to right edge + EOutdoor

Customization#

• Backgrounds: Replace PNG files in assets/ (850×526px recommended)
• Character: Replace GIF files (32×32 per frame, 8 frames)
• Care decay rate: Search frame%600 in code (higher = slower decay)
• Collision walls: Edit _INDOOR_WALLS / _OUTDOOR_WALLS arrays
• Window sizes: W_M, H_M for mini mode, W_G, H_G for garden mode

Credits#

• Character sprites: Cozy People (free pixel art)
• Background tiles: CraftPix (free top-down pixel art)