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", Inky Impression 5.7" or any other colour e-ink display, configurable
- 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.
Clone or download the tarball of this repository, then install the Python dependencies with pip:
$ cd pendower
$ pip install -r requirements.txtSave this with your configuration as config.toml in the project root directory
[display]
# Inky Impression 4"
width = 640
height = 400
# Inky Impression 5.7"
# width = 600
# height = 448
[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.pyNB If you change the configuration other than the display section, 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
- display config
- configurable weather data source preference
- moon phase
- tides
- wave heights