_{Your desktop tamagotchi for macOS. Lives on your screen. Needs your love.}

_{Pay what you want (even $0). 50% goes to animal shelters.
Open DMG → drag to Applications → done. macOS 12+ required.
App Store coming soon!}

---

What is Murchi?

_{A desktop tamagotchi with full SVG vector art, physics, emotions, and a life of its own}

Murchi is a desktop tamagotchi that lives on your macOS screen. It walks on your Dock, climbs screen edges, chases your cursor, reacts to music, writes diary entries, and has real emotions. Everything is rendered as smooth SVG vector art with 16-frame animations for every pose.

The entire app is a single Swift file — no Xcode project, no dependencies, no storyboards. Just compile and run.

---

Features

🏃 30+ Behaviors Walk, run, sleep, zoomies, climb edges, chase butterflies, watch birds, knock glasses, follow cursor, hide, poop, dance to music	🎵 Music Detection Detects when you play music in Apple Music or Spotify. Cat puts on headphones and vibes — or gets angry if it hates the song	⚓ Dock Physics Walks on macOS Dock as a physical platform. Real gravity, edge climbing, jumping off walls
🎨 SVG Vector Art Every pose is hand-crafted SVG with smooth 16-frame animation cycles. Breathing, tail wag, blinking, trembling, strain	💛 Emotions & Stats 6 stats: hunger, happiness, energy, social, hygiene, health. 4 moods. Gets sick, sad, or ecstatic based on care	✨ Particle Effects Music notes, hearts, stars, sparkles, tears, confetti, sleep Zs, dream bubbles, soap bubbles
🎁 Toys & Accessories Mouse toy, yarn ball, laser dot. Party hat, bow tie, crown, sunglasses, flower, halo — unlock with XP	📖 Pet Diary Cat writes a personal journal about its day. Meals, play, butterflies, sickness, milestones	😢 Sit in Corner Send the cat to the corner as punishment. It walks to the edge, sits facing the room, and cries until you forgive it

---

All Poses

_{15 unique SVG poses, each with 16-frame animation}

Pose	Animation	Trigger
Sitting	Breathing bob, tail wag, blinking	Idle, grooming, looking at cursor
Walking	4-frame walk cycle, bounce	Walking, running, chasing
Sleeping	Slow breathing, Zzz particles	Low energy / nighttime
Eating	Chomping animation	Feed from menu
Held	Dangling by scruff, sway	Click and drag
Angry	Trembling, arched back	Scratching furniture
Jumping	Squash & stretch	Random jump, stretch
Playing	Bouncy, energetic	Toys, play behavior
Climbing	Rotated 90°, paw scramble	Reaches screen edge
Bathing	Wobble, soap bubbles	Bath from menu
Music Happy	Headphones, half-closed eyes, sway	Music playing (75% chance)
Music Angry	Headphones, angry brows, tremble	Music playing (25% chance)
Hiding	Paw overlay, worried brows, sweat	Random shy behavior
Squatting	^_^ eyes, strain lines, blush	Pooping
Crying	Sobbing bob, tilt, tears	Sad mood, corner punishment

Plus: standing, lonely sitting, sick, dead, celebrating poses.

---

How it works

_{Everything lives in one file — Murchi.swift (9000+ lines)}

Murchi.swift the entire app generate-icon.swift icon generator build-app.sh .app bundle + .dmg builder run.sh compile & launch

Layer Tech Rendering SVG → NSImage (16-frame cycles) Window NSPanel borderless, above Dock Physics Custom gravity + Dock platform detection Particles 10 types, custom drawing per type Music AppleScript → Music.app / Spotify Persistence Codable JSON → ~/.murchi/ Hotkey Cmd+Shift+M global shortcut

Build from source

# Quick run (compile + launch)
./run.sh

# Or compile manually
swiftc -O -whole-module-optimization -o Murchi Murchi.swift \
  -framework AppKit -framework Foundation -framework AVFoundation \
  -framework Carbon -framework UserNotifications
./Murchi

# Build .app + .dmg
./build-app.sh

Requires Xcode command-line tools (xcode-select --install).

Note: If macOS says the app is "damaged and can't be opened", run:

xattr -cr /Applications/Murchi.app

This removes the quarantine flag added to apps downloaded from the internet.

App Store: Coming soon! For now — download the DMG and install manually.

---

Pay What You Want

_{Murchi is free forever. If you'd like to support development and help real animals — name your price.}

_{50% of all payments go to animal welfare organizations • 50% supports development}

---

9000+ lines of Swift  •  30+ behaviors  •  15+ animated poses  •  10 particle types  •  6 stats  •  5 evolution stages  •  1 file  •  0 dependencies

---

_{If you enjoy Murchi, give it a star!}

License

CC BY-NC-ND 4.0 — View source and build for personal use. Cannot commercially distribute, modify, or create derivative works. See LICENSE.

---

_{Made with love for animals everywhere}
murchi.pet
_{© 2026 Egor Fedorov}