-
Notifications
You must be signed in to change notification settings - Fork 8
InigoSettings.txt
To let the app know from where to download information we use a meta configuration file, this file contains all the details of your setup. By doing this we eliminate most typing on phones and tablets, this reduces most data entry on your phone, which saves you from entering long radar URLs from WeatherUnderground. I have provided an example inigo-settings.txt file, which you can save to your website in the weeWX website directory, this is usually saved as /var/www/weewx/inigo-settings.txt.
NOTE: If you make changes to the inigo-settings.txt file you need to go into settings on the app and re-save changes this is because the app caches settings.
wget -O /var/www/weewx/inigo-settings.txt https://github.com/evilbunny2008/weeWXWeatherApp/releases/download/1.0.3/inigo-settings.txt
In the weeWX Weather App you are now able to use basic http auth as part of the URL entered into the app, eg https://<username:password@example>.com/weewx/inigo-settings.txt
Once you download and save to your website you need to customise the inigo-settings.txt file, and using the default settings as a guide only. The data= line is the only required key-pair, as that pulls in all the information from your weeWX setup. The data= line needs to be the URL to the inigo-data.txt file, this is usually https://<example>.com/weewx/inigo-data.txt.
You can also specify a username and password as part of the URL if you use basic http authentication, eg https://<username:password@example>.com/weewx/inigo-data.txt.
The radtype= line is optional, and currently supports "image" and "webpage" values. With radtype=image you can specify a gif, jpg, and mjpeg URLs. Using radtype=webpage you are able to display a complete webpage and this can be used for things like mobile html pages showing rain radar, for example:
radtype=webpage
radar=http://m.bom.gov.au/nsw/sydney/radar/
The radar= line is optional, and can be pointed to a still image or an animated image gif file for weather radar which displays on the weather screen in the app. We have created a list of radar images that have been tested in the app.
radtype=image
radar=http://www.bom.gov.au/radar/IDR713.gif
The forecast= line is optional, and is used to get forecasts inside the app.
To use Yahoo Forecasts you need to specify a URL to the forecasted location. That information is then used to get forecasts from the Yahoo! Weather. Once on the site click the change location button and enter the location and once that comes up copy and paste the url into the settings file. If you want the forecast for Sydney, Australia use the following config:
fctype=yahoo
forecast=https://www.yahoo.com/news/weather/australia/sydney/sydney-23388205
If you would prefer to get forecasts from WeatherZone.com.au, you need to get the location ID from Weatherzone's website. The easiest way is to search for the town/suburb and then mouse over the RSS icon and get the lc= value. For example the location ID for Sydney, NSW, AU is 624, the important bit of the link is lc=624 part of the URI.
Once you have the ID, save it as forecast=624. Finally you need to tell the app to use weatherzone instead of Yahoo and you do this by adding fctype=weatherzone to your inigo-settings.txt
fctype=weatherzone
forecast=624
YR.no forecasts are being phased out and will no longer work from Feburary 2022. Use Met.NO forecasts instead.
You can now use forecasts from YR.no in the app, but you need to specify the full URL to the forecast.xml file. The app is able to cope with non-english forecast xml.
To find this file simply go to the yr.no website, then search for a place and then scroll down to and click on "Free Weather Data". From there you need to scroll down the page to "XML Forecast". Once there copy the URL of the forecast.xml link.
Finally paste the link in your inigo-settings.txt file and set fctype=yr.no.
fctype=yr.no
forecast=https://www.yr.no/place/Australia/New_South_Wales/Sydney/forecast.xml
or for Oslo you would do:
fctype=yr.no
forecast=https://www.yr.no/stad/Noreg/Oslo/Oslo/Oslo/varsel.xml
YR.no forecasts are being replaced with Met.NO forecasts, and people should shift as soon as possible.
Met.NO offer world wide forecasts and can be used in the app by giving your latitude, longitude and altitude (in metres), the following example is for Sydney's Airport in Australia:
fctype=met.no
forecast=https://api.met.no/weatherapi/locationforecast/2.0/compact?altitude=10&lat=-33.9401&lon=151.1759
The Australian Bureau of Meteorology publishes forecasts for many locations in Australia. To use this method firstly find your town or city, then grab the URL and paste it into the settings file. For example to get the forecast for Sydney, NSW, Australia you would use the following settings:
fctype=bom2
forecast=http://www.bom.gov.au/places/nsw/sydney/
Note: While most, if not all, places are listed, only towns in the above files have summary text forecasts.
BoM introduced a JSON based webpage about 6 months ago that offers an alternative forecast option, to utilise this forecast in the app you need to get the place code from BoM Weather Website for example for Mascot in Sydney NSW you would get the following url:
https://weather.bom.gov.au/location/r3gwbqz-mascot
You need to grab the 7 letter/number code from the URL before mascot and you can then add it to your settings file:
fctype=bom3
forecast=r3gwbqz
The WMO collates data from the various governments around the world and publishes these on their website. To use WMO's forecasts you first need to get the city ID number from the WMO's website. Once you have the city ID you can put that in your settings file.
fctype=wmo.int
forecast=300
The WMO publishes forecasts in 12 languages, go here and at the top right of screen you can select your language and then get the URL to the forecast. Then you can plug the URL into the settings file. For example, to get the forecast for Moscow, Russia you would add the following to your settings file:
fctype=wmo.int
forecast=http://worldweather.wmo.int/ru/json/206_ru.xml
NOAA produces forecasts for the US and it's territories, to get these forecasts in the app simply go to weather.gov and search for your town or city. Simple point and click on the map or use the search box at the top-left of the page. Once you have your area showing take the URL in the URL bar and paste it into the settings file. For example, to use Central Park, NYC, NY, you would use the following:
fctype=weather.gov
forecast=https://forecast.weather.gov/MapClick.php?lon=-73.96&lat=40.79
NOTE: Due to the complexity of forecast icons it isn't possible to use glyphs, so you must use the icon pack, the app will prompt you to enable icons when you have this forecast selected.
Environment Canada produces forecasts for Canada and you can get these forecasts in the app by going to weather.gc.ca and searching for your town or city. Once you have the location copy and paste the url into the settings file. For example, to have forecasts for Vancouver, BC, you would use the following:
fctype=weather.gc.ca
forecast=https://www.weather.gc.ca/city/pages/bc-74_metric_e.html
If you would like the forecast for Montreal in french you can do the following:
fctype=weather.gc.ca-fr
forecast=https://meteo.gc.ca/city/pages/qc-147_metric_f.html
The Met Office produces forecasts for the UK and you can get these forecasts in the app by going to beta.metoffice.gov.uk and click on the magnifying-glass icon, then search for your town or city. Once you have the location copy and paste the url into the settings file. For example, to have forecasts for London, England, you would use the following:
fctype=metoffice.gov.uk
forecast=https://beta.metoffice.gov.uk/weather/forecast/gcpvn15h9
La Agencia Estatal de Meteorología (AEMET) provides forecasts for Spain and you can now use these forecasts in the app. Firstly find your location and then copy the XML link on the right side at the top of the forecasts, ignore the RSS icon. For example if you wanted the forecast for Madrid you would add the following to your settings file:
fctype=aemet.es
forecast=https://www.aemet.es/xml/municipios/localidad_28079.xml
Deutscher Wetterdienst (DWD) provides forecasts for Germany and you can now use these forecasts in the app. Firstly find your location and then copy the URL from the address bar. For example if you wanted the forecast for Berlin you would add the following to your settings file:
fctype=dwd.de
forecast=https://www.dwd.de/DE/wetter/wetterundklima_vorort/berlin-brandenburg/berlin_tempelhof/_node.html
The MetService provides forecasts for New Zealand and those forecasts can be now used in the app. To do this you need to find the nearest town or city to your location that forecasts are produced, mouse over the "Towns and Cities" menu and click on a town or city. Then when the page comes up take the last part of the URL and stick it in your settings file. For example, getting the forecast for Auckland you would put in the following:
fctype=metservice.com
forecast=auckland-central
OpenWeatherMap provides world wide forecasts and these can be used in the app. To do this you firstly need to sign up and get an API key. Once you have the key you can then build the URL needed to get forecasts. For example, the URL for Sydney, Australia you would use the following URL:
fctype=openweathermap.org
forecast=https://api.openweathermap.org/data/2.5/forecast/daily?lat=-33.87&lon=151.21&appid=<api key>
Met Éireann provides forecasts for all of Ireland. To use these forecasts in the app you only need to get the latitude and longitude of your station and paste them into your settings file. To get the forecast for Dublin, Ireland, you would use the following:
fctype=met.ie
forecast=52.25,-7.09
Ilemteo provides forecasts for all of Italy. To use these forecasts in the app you only need to get the url of your location and paste them into your settings file. To get the forecast for Civitavecchia, Italy, you would use the following:
fctype=ilmeteo.it
forecast=https://www.ilmeteo.it/meteo/Civitavecchia
TempoItalia provides forecasts for all of Italy. To use these forecasts in the app you only need to get the url of your location and paste them into your settings file. To get the forecast for Civitavecchia, Italy, you would use the following:
fctype=tempoitalia.it
forecast=https://www.tempoitalia.it/meteo/civitavecchia
The webcam= line is optional, and is the url to a still jpeg image or motion jpeg file, that is then displayed in the app under the webcam tab. To save on mobile data, only one image per update period is downloaded, the app will download images regardless, be aware that this can chew up a lot of mobile data depending on your update settings.
webcam=http://mx.cafesydney.com:8888/mjpg/video.mjpg
The custom= line is optional, which is for a webpage you want to include inside the app, this can be any image or webpage you like, this page is commonly used to display information such as local dam levels. This can be generated by weeWX and saved in your weeWX directory and then found at http://<example>.com/weewx/custom.html.
You can also supply a Custom URL in the app which will override the what's specified in the inigo-settings.txt file.