KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

kindle-weatherstation

★ 43 Open GitHub ↗

Turn a Kindle Paperwhite into a server-less weatherstation with optimized battery runtime.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Kindle Weatherstation

This is a serverless implementation of a weatherstation for the Kindle (PW2)
that is also optimized for battery runtime (~ a month).

The Kindle fetches weather data from Openweathermap.org every 60 minutes, creates a SVG file
based on a template, converts the SVG to PNG, displays the newly generated PNG and
goes to sleep (STR/suspend to RAM) for the remaining time.

![screenshot](https://raw.githubusercontent.com/mattzzw/kindle-weatherstation/master/screenshot.jpg)

## What's what
* `weather2svg.py`: Queries weather data and assembles a SVG file based on template
* `create-png.sh`: Gets data, converts svg file to png and compresses png file
* `kindle-weather.sh`: Main loop, gets and displays data, suspend to RAM and wakeup
* `weather-preprocess.svg`: SVG template
* `config.xml`: KUAL config file
* `menu.json`: KUAL config file
* `sync2kindle.sh`: rsyncs all files to Kindle, helps during development/debugging
* `wifi.sh`: Wifi helper script
* `weatherstation.conf`: Upstart script

[rsvg-convert](https://github.com/ImageMagick/librsvg) and [pngcrush](https://pmt.sourceforge.io/pngcrush/) binaries and libs are included.

## Kindle preparation:
* Hack the kindle (doh!) --> [Mobileread Forum Thread](https://www.mobileread.com/forums/showthread.php?t=320564)
* Install KUAL
* Add USBnetworking and python (via MPRI)

## Installation:
* Adjust key and location in `config.py`
* Adjust SSID and passphrase in `wifi.sh`
* Create directory /mnt/us/extensions/weatherstation
* Copy everything to the newly created directory (or use sync2kindle.sh)

## Upstart script
Optionally, you can use a startup script to start the weatherstation automatically when the Kindle comes up.

* `$ mntroot rw`
* `$ cp /mnt/us/extensions/weatherstation/weatherstation.conf /etc/upstart`
* `$ mntroot ro`
* `$ start weatherstation`

## Stopping weatherstation:
* Either press button, quickly login and do a `killall kindle-weather.sh` (or if you are using the upstart script `stop weatherstation`).
* Or force reboot kindle by holding powerbutton ~10 seconds

## Credits:
* Building on ideas and code from
 * https://mpetroff.net/2012/09/kindle-weather-display/ and
 * https://github.com/nicoh88/kindle-kt3_weatherdisplay_battery-optimized

kindle-weatherstation

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README