The Alternative Interface (ai.cmx)

An Alternative (additional) Interface

IMPORTANT NOTICE

Due to issues with Alpaca Forms and the AI please DO NOT use any of the following AI pages to configure your station:

Configuration Wizard,   Program Setup,         Station Setup,        Internet Setup, 
Third Party Settings,   Extra Sensor Settings, Calibration Settings, NOAA Settings,
MySQL Settings,         Custom Logs,           Custom Alarms,        Display Options or
Locale Settings.

This issue has been resolved for the upcoming release of CumulusMX. 

Overview

The Alternative Interface (AI) is currently provided as an addition to the existing Interface for CumulusMX. At the current time, it should NOT be used as an alternative. In the near future this may be possible.

The AI is built using the same technology as the alternative public website and is intended to be flexible and responsive on all screen resolutions. It is modular and designed so that end users can make changes to the way page content is displayed without too much knowledge of html coding. It comes with themes that allow its colour to be changed to suit your personal preferences and a configuration page so that you can do this easily.

The current version is for CumulusMX 3.28.1 and can be downloaded form AI2 for v3.28.01 build 32693. Updated December 2023.

Installation

Download the above package and extract it to somewhere other than your CumulusMX files.

The package contains a second zip file and documentation which you should read to understand what it does and what you can do with it.

Unzip the second zip file, again away from CumulusMX. This is to ensure that you don't accidentally overwrite critical files in the existing Interface.

You should now have a folder called ai2. This can be copied as is into the Interface folder so that it is a sub-folder of the Interface folder. You can rename the AI2 folder if you wish.

To use the AI, you should now use the url: localhost:8998/ai2/
If you renamed the folder then use the new name rather than ai2.
If you access the normal CumulusMX interface from a different computer then use the IP address of the machine running CumulusMX rather than localhost.
If you run CumulusMX through a different port then use that port rather than 8998.
If you already have the AI running on your system then please don't try to merge the two - keep them separate as files will change with each release and this will cause you issues.  Technically you could simply create new folders for each AI release and run any of them in conjunction with the existing Interface.

General Features

This is a list of the features that the AI provides

  • It has a large number of themes that can be used to change the colours used throughout the site
  • The Header and Footer can be fixed (default) or scroll, the footer is always at the bottom of the screen when page content is short and always scrolls on small screens.
  • The fonts used are fully responsive.
  • The menu has been adapted to have fewer top level entries and focus on managing your weather station. It provides a link back to the default Interface if required. (See not at top of the page).
  • All pages use a feature called flex-boxes so can be re-organised simply by changing the order style for each panel.
  • The Utility pages have been combined into one page although the Latest Errors page is still available.

Significant, but not exhaustive improvements have been added for accessibility. Anyone requiring these features with knowledge of how to improve the AI2 should contact me.

The Menu

As far as possible, the menu has been split between those pages that simply allow you to view information provided by your weather station and those that allow you to edit them.

Viewing Data

There are three top level menu items at the left to enable this. These are Dashboard, Weather Data and Extra Sensors.

The Dashboard menu item is always visible in both large and small screen, other menu items collapse until you expand the menu with the classic hamburger item.

The Weather data menu contains links for all other pages that allow you to view rather than edit data except for the NOAA reports pages which can still be used to regenerate the current or all missing reports.

The Extra sensors' menu provides access for any extra sensors that are attached or linked to your weather station.

Editing Data

There are four top level menu items to the right of the diamond that give access to either setting or editing your weather station. These are: Logs, Settings, Edit and Utilities.

These mirror the same menu items as on the default Interface. One feature of the AI is that the Settings Menu is a drop down panel with columns. This makes it easier to access all items even on spall screens.

The Default Interface

Access is provided to this via the last top level menu at the extreme right of the menu. It will open the Interface in a new Window.

Using the AI Settings Page

The AI Settings page enables you to make global changes to the way the Interface looks. Things you can change are:

  • Page Geometry
    Use this to alter the gaps between the Header & Page content, and the Page content & Footer.
    Change the units used to measure those gaps. The site used the Font Height, The screen height or pixels. Pixels are fixed, the others are responsive.
    Make the Header scroll with the page (Only if the page is long enough)
    Make the Footer scroll with the page (only on long pages). The Footer will always scroll on small screens.
  • The Theme
    There are approximately 14 light themes
    There are the same number of dark themes
    There is one High Contrast theme.
  • The Seagull Animation
    The default is None (however, the seagull does still fade in at its default position).
    You can choose:
    Float down the screen, or
    Slide across the screen
    If you chose an animation you can adjust the speed in seconds
    Regardless of any animation you can force the seagull to hide behind page content if preferred.

As you make changes to any of these settings it will be reflected in the current page only. To use the current selection you must click the bottom Use this Configuration. To restore the default settings as programmed into the AI use the button Restore default.

Beneath these buttons you will see the values used in the CMXConfig object to store these settings. If your browser does not allow the setting to be stored, you can copy this directly into the ai-pagemanager.js file replacing what is already there.