{"id":28858086,"url":"https://github.com/pirmax/catmagotchi","last_synced_at":"2026-05-02T05:08:53.673Z","repository":{"id":294858005,"uuid":"987065421","full_name":"pirmax/catmagotchi","owner":"pirmax","description":"🐾 Catmagotchi – Animated Cat on Raspberry Pi E-Paper Display","archived":false,"fork":false,"pushed_at":"2025-09-30T09:50:38.000Z","size":70,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-12T08:08:13.408Z","etag":null,"topics":["animation","cat","catmagotchi","python","raspberry-pi","raspberry-pi-zero-w","raspberry-pi-zero-wh"],"latest_commit_sha":null,"homepage":"https://dev.to/pirmax/build-a-minimalist-virtual-cat-on-a-raspberry-pi-zero-with-an-e-ink-display-4mip","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pirmax.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-20T14:20:37.000Z","updated_at":"2025-09-30T09:50:42.000Z","dependencies_parsed_at":"2025-05-26T03:03:19.959Z","dependency_job_id":null,"html_url":"https://github.com/pirmax/catmagotchi","commit_stats":null,"previous_names":["pirmax/catmagotchi"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pirmax/catmagotchi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirmax%2Fcatmagotchi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirmax%2Fcatmagotchi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirmax%2Fcatmagotchi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirmax%2Fcatmagotchi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pirmax","download_url":"https://codeload.github.com/pirmax/catmagotchi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirmax%2Fcatmagotchi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32523480,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T01:12:54.858Z","status":"online","status_checked_at":"2026-05-02T02:00:05.923Z","response_time":132,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["animation","cat","catmagotchi","python","raspberry-pi","raspberry-pi-zero-w","raspberry-pi-zero-wh"],"created_at":"2025-06-20T02:04:45.975Z","updated_at":"2026-05-02T05:08:53.668Z","avatar_url":"https://github.com/pirmax.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🐱 Catmagotchi\n\nA minimalist animated cat running on a Raspberry Pi Zero 2 WH with a 2.13\" Waveshare Touch e-Paper display (250×122).  \nThe cat idles, walks, sleeps, and reacts over time with smooth transitions and a cozy e-ink aesthetic.\n\n---\n\n## 🧰 Requirements\n\n- Raspberry Pi Zero 2 WH (or any Pi with GPIO and Python 3)\n- Waveshare 2.13\" Touch e-Paper display (250×122)\n- Raspberry Pi OS (Bookworm or Bullseye recommended)\n- Python 3.9+\n- A set of `.png` animation frames exported from `.gif` files\n\nDirectory structure:\n\n```\ncatmagotchi/\n   ├── animations/\n   │   ├── idle/\n   │   ├── sleep/\n   │   └── …\n   ├── lib/\n   │   └── waveshare_epd/\n   ├── main.py\n   ├── requirements.txt\n   └── README.md\n```\n\n---\n\n## ⚙️ Installation (on Raspberry Pi)\n\n### 1. Update and install system packages\n\n```bash\nsudo apt update\nsudo apt install -y python3 python3-pip python3-pil python3-pil.imagetk python3-numpy python3-spidev python3-tk git\n```\n\n\u003e Pillow, NumPy and SPI support are installed via APT for performance and compatibility reasons.\n\n### 2. Clone the Waveshare e-Paper driver\n\n```bash\ngit clone https://github.com/waveshare/e-Paper\ncd e-Paper/RaspberryPi_JetsonNano/python\n```\n\nInstead of installing the driver with setup.py, copy it manually to the project:\n\n```bash\nmkdir -p ~/catmagotchi/lib\ncp -r lib/waveshare_epd ~/catmagotchi/lib/\n```\n\n### 3. Add Python dependencies (for desktop preview only)\n\nIf you’re using the preview mode on macOS or a Linux desktop:\n\n```bash\npip3 install -r requirements.txt --break-system-packages\n```\n\nOr use a virtualenv:\n\n```bash\npython3 -m venv cat-env\nsource cat-env/bin/activate\npip install -r requirements.txt\n```\n\n### 4. Run the project\n\nTo run on the e-Paper display:\n\n```bash\ncd ~/catmagotchi\npython3 main.py\n```\n\nTo run desktop preview mode (for development on macOS/Linux):\n\n```bash\npython3 main.py --preview\n```\n\n## 📦 requirements.txt (provided)\n\n```\nPillow\nspidev\nnumpy\n```\n\nNote: numpy, spidev, and pillow are preferably installed via apt for best performance on Raspberry Pi.\n\n## 🧠 Future plans\n\n- Add touch support (wake, play, feed)\n- Integrate a basic UI with bubbles or reactions\n- Trigger behaviors based on time of day or sensors\n\n## 🐾 Credits\n\nBuilt with ❤️ and Python by Maxence Rose, inspired by Tamagotchis, e-ink magic, and cozy low-power interfaces.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpirmax%2Fcatmagotchi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpirmax%2Fcatmagotchi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpirmax%2Fcatmagotchi/lists"}