Skip to content
evilbunny2008 edited this page May 5, 2020 · 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.

Contents

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

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

For metric

wget -O inigo-metric.tar.gz https://github.com/evilbunny2008/weeWXWeatherApp/releases/download/0.7.1/inigo-metric.tar.gz
wee_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-get -y install python-dev python-pip
sudo pip install pyephem

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

wget -O /var/www/weewx/inigo-settings.txt https://github.com/evilbunny2008/weeWXWeatherApp/releases/download/0.7.1/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.

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.x

Starting in 3.9.x 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.

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-get -y install python-dev python-pip
sudo pip install pyephem

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

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

For metric

wget -O inigo-metric.tar.gz https://github.com/evilbunny2008/weeWXWeatherApp/releases/download/0.7.1/inigo-metric.tar.gz
wee_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

wget -O /var/www/weewx/inigo-settings.txt https://github.com/evilbunny2008/weeWXWeatherApp/releases/download/0.7.1/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-data.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.

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.

Clone this wiki locally