Kindle Dashboard

A minimalist Python web service that renders a greyscale PNG dashboard for Kindle-sized screens.

(The Kindle Basic 7th Generation has a 16-level greyscale display.)

Usage Guide

The Dashboard

Depending on your online screensaver configuration, the information will be out-of-date slightly.

• The time and battery is shown in the top-right
• The temperature is shown as a line graph, with the daily lows and highs marked
• Rainfall & Snow ("precipitation") is shown in bars at the bottom, with the peak marked

Quick guide to standing in rain for one hour:

• 0.1mm: you'll be dry
• 0.3mm: you'll be damp
• 0.5mm: you'll be wet
• 0.7mm: you'll be soaked
• 0.9mm: you'll be dripping

Prerequisites

• python
• uv

On Your Kindle

Put the dashboard on your kindle using https://github.com/FalconFour/onlinescreensaverPW2.

Running the Server

The simplest way is using uv.

Run without installing: uvx kindle-dashboard.

Or, install for your user, and run from there:

uv tool install kindle-dashboard
kindle-dashboard

The server serves the dashboard image on http://127.0.0.1:42137/, by default.

There is an example systemd service file.

Configuration

• HOST (default: 127.0.0.1)
• PORT (default: 42137)
• IMAGE_WIDTH (default: 600)
• IMAGE_HEIGHT (default: 800)
• RENDER_SUPERSAMPLE_SCALE (default: 2)
• WEATHER_UPDATE_SECS (default: 1800, every half an hour)
• WEATHER_LATITUDE (optional; must be set together with WEATHER_LONGITUDE)
• WEATHER_LONGITUDE (optional; must be set together with WEATHER_LATITUDE)
• LOG_LEVEL (default: INFO; standard Python logging levels)
• LOG_SYSTEMD (optional; set 1/true to force systemd log format, 0/false to disable auto-detect)

Weather data is requested from Open-Meteo in the forecast location's local timezone.
Precipitation bars represent the hour interval ending at the API timestamp (for example, a value at 16:00 is drawn for 15:00-16:00). When JOURNAL_STREAM is present (typical under systemd), logging automatically switches to systemd-compatible output.

Development Guide

Development

uv sync

• bin/check runs linting, type checks, and release validation (uv build and uv publish --dry-run).
• bin/fix applies automatic Ruff fixes.
• bin/test runs the test suite.

uv run kindle-dashboard

Build and publish

bin/publish