Skip to content

Hub script updates

This page shows how to update scripts that you installed from the AWTRIX Hub, the online collection of AWTRIX scripts and icons.

How it behaves

The web UI asks the Hub for new versions of the scripts you installed from it, and shows them in the Scripts tab. Nothing is updated without your click. Only scripts installed from the Hub can be updated. An update keeps your settings, and a script you changed yourself is never overwritten. There is no version history, so keep your own backup of scripts that are important to you.

Before you start

  • Enter your Hub connection key in the web UI under AWTRIX Hub. Downloads from the Hub need it.
  • After Check for updates, each script from the Hub shows its state, for example Update available or Up to date.

Update a script

  1. Open the Scripts tab in the web UI.
  2. Click Check for updates. Scripts with a newer version on the Hub show Update available.
  3. Open the script.
  4. Click Update script and confirm.
  5. Wait until Script updated appears. A line above the editor shows each step.
  6. Check the script in the editor and in the log.

If you changed the script, or the editor holds changes you have not saved, step 4 offers Install as a new script instead. See Your own changes.

A new version counts as an update when its code changed, and also when only its sounds changed.

What an update changes

  • Settings: settings that still exist in the new version keep their values. New settings start with their default values.
  • Icons: the icons the script needs are downloaded first.
  • Sounds: this clock cannot play MP3 files, so a script's sounds are not copied. The confirmation tells you this.
  • If the new version does not start: when it cannot be compiled or started, AWTRIX restores the previous code and settings.

Your own changes

When you edit the code of a Hub script, the Scripts tab shows Changed on the clock. Renaming a script does not count as a change. The script stays linked to the Hub.

A changed script is not updated in place. To keep your changes and still get the new version, choose Install as a new script. This installs the Hub version as a separate script:

  • It starts with its own default settings.
  • Your own script and the draft in the editor are kept.
  • If installing the copy fails, the copy and everything installed for it are removed again.

Privacy

Your browser talks to the Hub directly. The Hub never contacts your AWTRIX and never receives your scripts or your device login. Like every website, the Hub can see the address of the web UI that makes the request.

When a script is removed from the Hub, the copy on your AWTRIX keeps working.

When it goes wrong

What you see What to do
A step fails Click Try again. The update continues where it stopped. What is already on AWTRIX stays.
An icon with the same name but different content already exists The update stops, so your icon is not replaced. Fix the icon under Icons, then try again. Icons downloaded before the stop may stay installed.
The script changed. Check for updates again. The script was changed while the update was prepared. Open the current script, check the change and start again.
The Hub version changed during download. Try again. Every download is checked against the Hub version. Start the update again.
Update the firmware to get script updates. Update the firmware first.
not enough memory to compile Not enough free memory for the script. See Keeping scripts small.

Good to know

  • A script that shows no state after Check for updates was not installed from the Hub. Install it again from its Hub page to get updates.
  • An error that happens later, for example in a timer or when data arrives, cannot be found during the update. Check the log after a while.
  • An update cannot undo what a script has already done, for example messages it has sent.
  • The link to the Hub only shows where a script came from. It does not prove that the script is unchanged or safe. Install only scripts you trust.

Details