Welcome to PiWeatherRock


Welcome to the documentation for PiWeatherRock! I’m glad you have decided to check it out and sincerely hope you find it useful.

PiWeatherRock is packaged as a series of Python packages that can be installed from PyPI. To maximize the usefulness of these packages it helps if the program runs as a service. To facilitate this, along with the installation of all prerequisite software, I have taken advantage of the open source automation tools from Puppet.


PiWeatherRock has three screens that it cycles through to show you a daily forecast, a hourly forecast, and an information screen. Here are examples of each:

Daily forecastHourly forecastInfo screen

Data for these forecasts is pulled from Dark Sky via their free API.

Ready to get started?

Find out how to install PiWeatherRock in Getting Started.

Ready to update?

Check out the Getting Updates section for details on how to upgrade to the latest version.

Got feedback?

Head over to the Contributing section to learn how to share your thoughts on PiWeatherRock or to the documentation on this site.

Getting Started

Installation and configuration information

Getting Updates

How to get the latest version of PiWeatherRock

Usage Information

Information such as keyboard interactions

Troubleshooting Information

Things to try when stuff isn’t working as expected


Ways to get help

Influence and Credit

Ways to get help


How to contribute ideas, code changes, documentation, or anything else