Why it is worth attention

It uniquely combines a jailbroken Kindle e-ink display with a modern cloud backend and Telegram chat input, supporting offline caching, live SSE updates, and flexible message parsing with an AI fallback.

Who it is for

Kindle power users who jailbreak their devices
Developers interested in e-ink dashboard projects
Self-hosting enthusiasts seeking a personal planner backend
People who want a Telegram-based task manager with a physical display

Use cases

Daily planner overview on an e-ink screen
Adding groceries or tasks via Telegram chat
Syncing Apple Health data to the dashboard
Offline-capable dashboard for low-power settings

Strengths

Native C++ renderer for fast e-ink display updates
Offline cache and graceful degradation when network fails
Flexible message parsing with AI (OpenAI) and deterministic fallback
Live SSE event-driven updates for real-time change detection

Considerations

Requires a jailbroken Kindle with KUAL installed
Depends on a third-party backend service (InsForge)
No touch framework; tap handling is manual coordinate-based
iOS companion app only; no Android Health sync supported

README quick start

Kindle Planner Dashboard

Monochrome, Kindle-friendly planner dashboard with Telegram bot updates.

Requirements

A jailbroken Kindle with KUAL installed for the native dashboard.
Node.js 20+ and npm for scripts, checks, and backend bootstrapping.
An InsForge account for the database, edge functions, and secrets.
A Telegram bot token from BotFather for chat-based planner updates.
Optional: an OpenAI API key for natural-language message parsing. Without it, the webhook uses the built-in command parser.
Optional: Zig or a Kindle-compatible ARM cross compiler to rebuild the KUAL package.
Optional: Xcode and a real iPhone for the Health Sync companion app.

Setup Instructions

This repo can be published as a bring-your-own-backend kit. Each owner runs their own InsForge project, Telegram bot, and KUAL package config instead of connecting to this checkout's production backend.

Start with docs/INSTALL_FOR_USERS.md.

If you are using a coding assistant for setup, use docs/SETUP_WITH_ASSISTANT.md.

Project Structure

functions/: InsForge edge functions for dashboard JSON, live events, item toggles, Telegram parsing/actions, version checks, and Health Sync uploads.
migrations/: Postgres schema and optional sample-data migrations used by the bring-your-own-backend setup.
kindle/native/: Native C++ e-ink dashboard renderer, local render check, and KUAL package build targets.
kindle/kual/kindle-dashboard/: KUAL extension files, shell launchers, placeholder assets, and config.sh.example.
kindle/launch-dashboard.sh: Kindle-side launcher used by installed shortcuts and native install helpers.
ios/HealthSyncCompanion/: Optional iOS app that reads Apple Health daily aggregates and posts them to the health-sync function.
scripts/: Setup and maintenance helpers for InsForge bootstrapping, Telegram webhook configuration, Kindle native install, and Kindle proof checks.
docs/: Human and coding-assistant setup guides.

Technical Breakdown

The Stack

Renderer: Native C++ app

Backend: InsForge

Inputs: Telegram bot + iOS HealthKit

Code entry points:

Native app: kindle/native/src/kindle_dashboard.cpp
Backend functions: functions/
Health companion: [`ios/

Related repositories

Similar projects matched by category, topics, and programming language.

ammaarreshi

Generals-Mac-iOS-iPad

This repository ports Command & Conquer Generals: Zero Hour to run natively on Apple Silicon Macs, iPhones, and iPads without emulation, adding touch controls and modern rendering.

C++

1,523

MSNightmare

LegacyHive

This repository contains a proof-of-concept for a Windows User Profile Service elevation-of-privilege vulnerability that loads an arbitrary hive into the current user's classes root.

C++

275

kigner

audio.cpp-webui

audio.cpp is a high-performance C++ audio inference framework built on ggml that provides a unified local runtime for TTS, ASR, voice cloning, and other audio tasks, with a WebUI, CLI, server, and performance optimizations for CUDA.

C++

245