Pendower

A simple app for displaying local tide and surf conditions.

• High and low tides over the next few days
• Wave heights (combined swell and wind waves)
• Sunrise and sunset, with nautical twilight

Designed for

• Raspberry Pi Zero
• Inky Impression 4" e-ink display
• Pendower Beach, Cornwall - my local beach, great for swimming and very occasionally surfable :)
• ...but can be configured for other locations

Data from the fantastic stormglass.io API. It only makes three requests per day, so is well under the limit for the free non-commercial plan.

Installation

Clone or download the tarball of this repository, then install the Python dependencies with pip:

$ cd pendower
$ pip install -r requirements.txt

Configuration

Save this with your configuration as config.toml in the project root directory

[spot]
name = "Pendower Beach"
latitude = 50.204553
longitude = -4.947837

[stormglass]
api_key = "(your stormglass.io API key)"
data_source_preference = ["meto", "noaa", "sg"]

Test the configuration with

$ python scripts/refresh.py

NB If you change the configuration delete the .json files in the data directory before refreshing the display.

To refresh the display every 15 minutes with cron, run crontab -e and add a line like:

*/15 * * * * /your/path/to/pendower/scripts/refresh.py

Version History

1.2

• configurable weather data source preference

1.1

• moon phase

1.0

• tides
• wave heights