Astronomy Weather Setup

Overview

The weather app is an cross-platform Avalonia UI sample app meant to connect to Open Meteo stations and display real-time weather data. It was born from the collaboration between Xcalibur Systems, and UXDivers.

This application can run as a desktop app, on Mac or Windows, or it can run on a low-power device like a Raspberry PI.

Setup API Keys

In order for the application to work properly api credentials need to be set in preferences.json file, which will be created after the first time you run the application.

Astronomy Weather uses the following free API’s:

APIDescriptionNeeds API Key
Open MeteoThis is used for most of the weather data.No
ipgeolocation Astronomy APIThis is used for advanced sun/moon data.Yes
geocod.ioThis is used for the location lookup function.Yes

    You will need to update your preferences.json located in:

    <AppFolder>/Settings/preferences.json
    

    To add these API keys to your preferences.json, look for the entries below and enter each key as a string.

    {   
        "ip_geo_api_key": "<APIKEY>",
        "geocodio_api_key": "<APIKEY>"
    }
    

    Run in Fullscreen, no Titlebar

    If you wish to run the application in fullscreen mode without a titlebar (ideal as a DRM alternative), you can do this by setting the following in preferences.json:

    {   
        "is_desktop_mode": false
    }
    

    Run in DRM

    We offer a DRM mode for those that wish to setup kiosks. If you wish to do this in Linux you can execute by the following:

    ./Xcalibur.Weather --drm
    

    Run on Raspberry Pi

    In the case you want to run this app on your Raspberry Pi and wish to have access to the onscreen keyboard Squeekboard, set the following in preferences.json:

    {   
        "is_raspberry_pi": true
    }