Skip to content
evilbunny2008 edited this page Feb 29, 2024 · 74 revisions

weeWXWeatherApp -- A weather app for weeWX users

Unlike general weather apps, which get information from third party websites, this app gets information from personal weather stations running weeWX.

Screen Shots


Concise Instructions

In case you want the short version, below is the concise steps:

Step 1, install the Inigo extension for weeWX.

For imperial on weeWX 4.x or lower

wget -O inigo-imperial.tar.gz https://github.com/evilbunny2008/weeWXWeatherApp/releases/download/1.0.17/inigo-imperial.tar.gz
sudo wee_extension --install inigo-imperial.tar.gz

For imperial on weeWX 5.x and above

wget -O inigo-imperial.tar.gz https://github.com/evilbunny2008/weeWXWeatherApp/releases/download/1.0.17/inigo-imperial.tar.gz
sudo weectl extension install inigo-imperial.tar.gz

For metric on weeWX 4.x or lower

wget -O inigo-metric.tar.gz https://github.com/evilbunny2008/weeWXWeatherApp/releases/download/1.0.17/inigo-metric.tar.gz
sudo wee_extension --install inigo-metric.tar.gz

For metric on weeWX 5.x or above

wget -O inigo-metric.tar.gz https://github.com/evilbunny2008/weeWXWeatherApp/releases/download/1.0.17/inigo-metric.tar.gz
sudo weectl extension install inigo-metric.tar.gz

Step 2, Almanac (optional)

If you would like to see moon rise/set in the app, you just need to install pyephem.

sudo apt -y install python3-ephem

Step 3, Restarting weeWX

You need to restart weeWX to make the above changes work.

sudo systemctl restart weewx

Step 4, create inigo-settings.txt

sudo wget -O /var/www/weewx/inigo-settings.txt https://github.com/evilbunny2008/weeWXWeatherApp/releases/download/1.0.3/inigo-settings.txt
sudo nano /var/www/weewx/inigo-settings.txt

You need to change the inigo-settings.txt to provide details about your weather stations. Full details are available in the wiki

Once you're happy with your changes press ctrl+x to exit and save.

Step 5, using offset rain times (optional)

Historically rainfall is measured in Australia at 9am, so it's useful for comparison reasons to be able to display rain records matching time of day with the Bureau of Meteorology. To enable this simply edit /etc/weewx/since.tmpl and paste the following into it:

#if $varExists('since')
$since($hour=9).rain.sum.formatted|$since($hour=9,$today=False).rain.sum.formatted|9am|#slurp
#else
|||#slurp
#end if

Step 6, installing the app

You can now get the app from Google Play.

On first boot the app will prompt you for the URL to your inigo-settings.txt file, this is usually http://<example>.com/weewx/inigo-settings.txt, once entered click save and in a few seconds you should be up and running.

Once saved the settings are cached by the app. If you need to tell the app to re-download the settings, you swipe from the left side of any screen to open the settings pane.

Expanded Installation Instructions

Preparing weeWX

Before you can use the app, you need to prepare weeWX with an extension and a meta config file telling the app where to get data, radar images and forecasts. To find out more about setting up and running weeWX, you can find more details on the weeWX website.

weeWX 3.9

Starting in 3.9 a default unit option was introduced in weeWX. Please visit the upgrading to 3.9 section of weeWX documentation for more details.

weeWX 4.0

I've been testing weeWX 4.0 using python 3 and haven't needed any changes to keep the Inigo skin working.

weeWX 4.6

Need a new copy of Since.py, grab the extension again and reinstall it over the top

weeWX 5.0

So far everything seems to work fine under weeWX 5.0.x

Almanac (optional)

There is a python plugin for getting more almanac information beyond the simple sunrise and sunset, for more details on this check out this link. To get this add-on simply run the following command to enable it.

sudo apt -y install python3-ephem

Installing the Inigo data extension

Firstly you need to install the Inigo data extension, this will automatically create the inigo-data.txt.tmpl and make suitable changes to weewx.conf which will then generate the inigo-data.txt file needed by the app.

For imperial on weeWX 4.x or lower

wget -O inigo-imperial.tar.gz https://github.com/evilbunny2008/weeWXWeatherApp/releases/download/1.0.17/inigo-imperial.tar.gz
sudo wee_extension --install inigo-imperial.tar.gz

For imperial on weeWX 5.x and above

wget -O inigo-imperial.tar.gz https://github.com/evilbunny2008/weeWXWeatherApp/releases/download/1.0.17/inigo-imperial.tar.gz
sudo weectl extension install inigo-imperial.tar.gz

For metric on weeWX 4.x or lower

wget -O inigo-metric.tar.gz https://github.com/evilbunny2008/weeWXWeatherApp/releases/download/1.0.17/inigo-metric.tar.gz
sudo wee_extension --install inigo-metric.tar.gz

For metric on weeWX 5.x or above

wget -O inigo-metric.tar.gz https://github.com/evilbunny2008/weeWXWeatherApp/releases/download/1.0.17/inigo-metric.tar.gz
sudo weectl extension install inigo-metric.tar.gz

Using offset rain times (optional)

Historically rainfall is measured in Australia at 9am, so it's useful for comparison reasons to be able to display rain records matching time of day with the Bureau of Meteorology. To enable this simply edit /etc/weewx/since.tmpl and paste the following into it:

#if $varExists('since')
$since($hour=9).rain.sum.formatted|$since($hour=9,$today=False).rain.sum.formatted|9am|#slurp
#else
|||#slurp
#end if

Inigo-Settings.txt

sudo wget -O /var/www/weewx/inigo-settings.txt https://github.com/evilbunny2008/weeWXWeatherApp/releases/download/1.0.3/inigo-settings.txt
sudo nano /var/www/weewx/inigo-settings.txt

You need to change the inigo-settings.txt to provide details about your weather stations. Full details are available in the wiki

Once you're happy with your changes press ctrl+x to exit and save.

Restarting weeWX

To make the above changes live you need to restart weeWX.

sudo systemctl restart weewx

Setting up the app

Once you install and run the app from Google Play the settings box will appear on first boot asking for the URL to the inigo-settings.txt file, if you saved this in the weewx directory this will usually be http://<example>.com/weewx/inigo-settings.txt. Simply enter in the URL and click 'Save Settings', the app will then check to make sure the details in inigo-settings.txt is valid and will trigger a download of your weather information, once downloaded the app will then display the weather information.

Once saved the settings are cached by the app. If you need to tell the app to re-download the settings, you swipe from the left side of any screen to open the settings pane.

Notes about manual data updates in the app

If you wish to do manual updates you can refresh the app screens by swiping down. Current version can check for a WiFi connection before automatically updating. Forcing a refresh on any of the screens will download fresh data regardless of how you are connected to the internet.

Home Screen Widget

If you wish to have weather information on your home screen you can do this by pressing and holding on a blank area of your home screen, then select widgets, finally scroll down to weeWX Weather App, and it's a 2x1 widget. If you want up to date weather information you need to allow background downloading enabled in the app, otherwise the widget will only update when the app is running. Auto updates are enabled by default.

License

Source code is made available under the GPLv3 license, in the hope the code might be useful to others. See LICENSE for details.

Credits

Inigo Owen Jones was a meteorologist and farmer in Queensland, Australia.

Big thanks to the weeWX project, as this app wouldn't be possible otherwise.

Thanks to Gary for creating the since.py file.

Weather Icons from WeatherIcons.io and FlatIcon and is licensed under CC 3.0 BY

Forecast credits are available on the InigoSettings wiki page.

This app is by OdiousApps.