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

This version

2

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-2.tar.gz (31.4 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-2-py3-none-any.whl (37.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: kindle_dashboard-2.tar.gz
  • Upload date:
  • Size: 31.4 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-2.tar.gz
Algorithm Hash digest
SHA256 7e9a9dc030a7aa311a82fed0840124c092f1c5ea7fe034d4ded731054a444715
MD5 c2e64af596ce85a0b9c88cba8636c64f
BLAKE2b-256 1f7a0e15e29b63825303fb81078ffd1da67c74d45fbbd62528de8c206b93517f

See more details on using hashes here.

File details

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

File metadata

  • Download URL: kindle_dashboard-2-py3-none-any.whl
  • Upload date:
  • Size: 37.0 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-2-py3-none-any.whl
Algorithm Hash digest
SHA256 dc4caf14390fa482f3ebd64f2512dcccae37433ac646a5f7f7fe48ccfad7eb49
MD5 ebf835af7cf476bfd252153bc6511727
BLAKE2b-256 8d3259f95caed10358c449085c0001de8fe4fb10aaf563dbf6cc13b3d5168958

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