← All projects
Hardware · Personal

PaperHeart

A long-distance companion device: messages and photos sent through a Telegram bot appear on a Raspberry Pi e-paper frame, alongside Kkomi — a one-eyed virtual pet whose mood quietly decays until somebody looks after it.

DjangoE-paperRaspberry PiTelegram
PaperHeart

PaperHeart

PaperHeart is a small e-paper frame that lives on someone else's desk. Messages, photos and pet interactions are sent through a Telegram bot, stored by a Django backend, and drawn on a Waveshare 4.2" display driven by a Raspberry Pi Zero 2W.

Kkomi

The frame is not only an inbox. It also holds Kkomi (꼬미), a one-eyed muscly bird monster with hunger and mood that decay on a schedule — every twelve hours for the pet, daily for the countdown — so the device asks for attention on its own rather than waiting to be given some.

Why it is built this way

The Pi holds no logic worth losing: it polls the backend for device state and renders it. Everything else — the bot handlers, the pet's state machine, the scheduled decay — lives in Django with Celery, which is also what lets the frame be power-cycled, moved, or reflashed without anybody losing a message.

It shares one backend with the rest of these projects rather than running its own, which is the reason that backend exists at all.