A minimalist PNG dashboard shown as an always-on screensaver on Kindle e-readers.

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for QasimK from gravatar.com QasimK

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License Expression: AGPL-3.0-or-later
    SPDX License Expression
  • Author: QasimK
  • Tags kindle , dashboard , screensaver , epaper , ereader
  • Requires: Python >=3.14
Classifiers
Report project as malware

Project description

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

Kindle Dashboard screenshot

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

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for QasimK from gravatar.com QasimK

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License Expression: AGPL-3.0-or-later
    SPDX License Expression
  • Author: QasimK
  • Tags kindle , dashboard , screensaver , epaper , ereader
  • Requires: Python >=3.14
Classifiers

Release history Release notifications | RSS feed

3

2

This version

1.0.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kindle_dashboard-1.0.0.tar.gz (31.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kindle_dashboard-1.0.0-py3-none-any.whl (36.4 kB view details)

Uploaded Python 3

File details

Details for the file kindle_dashboard-1.0.0.tar.gz.

File metadata

  • Download URL: kindle_dashboard-1.0.0.tar.gz
  • Upload date:
  • Size: 31.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for kindle_dashboard-1.0.0.tar.gz
Algorithm Hash digest
SHA256 517fdd7839cc393e726881320514d6a847cf7def853862234c4b8cc3c43869e7
MD5 ef17876e0e48448bce6249ff037ce2cf
BLAKE2b-256 f396ed3a40e46179398da43d0718885709e3bf040ea185716f374b90da5cec54

See more details on using hashes here.

File details

Details for the file kindle_dashboard-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: kindle_dashboard-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 36.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for kindle_dashboard-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 49750b89ccba6312d99a8d7c9faa16f64a9b62ddf566046caf34deb0916270f0
MD5 33883bbb705d45328f28af10164eca4a
BLAKE2b-256 2d8319efbfed23d44470c7ec4528e384337882112edd138b70d9c12ec65d641e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page