Host 27620
Please note: Due to the many changes it may take some time before the documentation is updated. I think that I will be able to do this within the next week.
Creates a new Logfile in the Log folder with every start, so you have a history.
Writes a Crashreport when a heavy crash happen.
Changes the Colorpicker for Textcolor. Also this setting now uses Hex values internally. So if you want to change the textcolor via API, send a Hex value instead of RGB Value.
Adds 2 new switchanimation with a dropdown menu
Adds information about the Java Enviroment in the Host status like used RAM or CPU usage (Screenshot of my AWTRIX Pro with RPi3)

Adds some terminal commands to the startpage:
- reset settings:
Overwrites your hostsettings with the defaultsettings
- reload apps:
Checks and reloads every changes in the App directory
- update apps:
Forces all apps to update themselves
- restart:
Restarts AWTRIX, maybe this will not work on all platforms
- zip enviroment:
This will compress the whole awtrix installation directory wich you can download as a zip file. This could be very useful if you want to move your installation to another platform, for ccomplete Backup,or for me, if i need a look at special errors to your enviroment, so i can debug it 1:1.
- reset controller:
This will reset the controller. All Wifi settings will be deleted and you can setup it again.
- reboot controller:
Performes a reboot of the controller
Adds E1.31 (like Artnet) protocol as a premiumfunction. With xLight for example you need to add a new Controller with 2 universes with 384 channels each. Also add a new matrix layout with 8 strings รก 32 Strands and top left starting position. When you start to send data, AWTRIX will stop its normal operation and shows your data. 5s after you stop sending data, AWTRIX will return to normal operation.
- Adds Hue Bridge Emulation for controlling AWTRIX via Amazon Alexa as a premiumfunction. This only emualtes a Phillips Hue lamp, so you can control the textolor, brightness and on/off. (The integrated emulation server uses Port 80, make sure it is not used by any other programm). Tested on Windows and Raspberry Pi3 with a Echo Dot Gen.3
- Adds Multicolortext for Notifications. (Needs Controller v0.24). Instead of "text" use "multiColorText". Define an Array of textareas with a given RGB color values (Array of Integer) .e.g:
{
"force":true,
"icon":6,
"moveIcon":true,
"repeat":2,
"soundfile":1,
"multiColorText":[{"text":"Totally ","color":[0,255,0]},{"text":"Awseome","color":[255,0,0]}]
}
You can send now HEX or RGB Values to the SettingsAPI to change the Textcolor
You can now shows a barchart in your notification.
- Send your data values as an Array e.g
"barchart":[20,50,80,100,50,20,60]
- All Datapoints will be scaled automatically in width, height and position. The highest Value will be used as the maximum for calculating the scaling.
- You can only send text OR barchart
- The maximum of datapoints without an given icon is 16. With Icon its 13. Any further datapoints will be cut off.
Like barcharts you can also send linecharts
- send your data values as an Array e.g
"linechart":[20,50,80,100,50,20,60]
- its not perfect due some scaling problems on this ammount of pixels

Adds the possibility to save icons locally for private usage:
- You have a new saving option for that in AWTRIXER
- To use it, just write the iconname as ID (String instead of Integer) in your API request
- All Icons will be saved in a readable textfile (config->privatIcons), so you can edit/add/remove icons manually.
- AWTRIX does not recognize any change to that file. To reload your private Icons, simply execute
reload icons
from the terminal on the mainpage. While saving your Icons via AWTRIXER it will reload automatically.
- Like the community Icons youre not able to reload your Icons in AWTRIXER for editing. Use "Save as .awtrixer file" to backup your icon.
- Your private Icons will not be shown in the Icondatabase.
- Despite this feature it is of course still nice to share common icons with the community.
You can reset your apploop in the apploop customizer (Top right button)
Sends MQTT messages when apps are enabled or disabled
Adds a new sidebar item that is displayed when there are some critical errors that could be caught safely. You can clear this list at any time

Executed awtrix-terminal commands are listed in the log
You can get AppSettings via Basic API e.g{"appSetting":"Time"}
Sends MQTT messages when apps are enabled or disabled from the webinterface
Adds the possibility to start awtrix directly with different Ports via arguments
(e.g java -jar awtrix.jar hostport 7001 matrixport 7002
)
Merges matrix and host settings into one page
Seperate premiumsection into a own site
Changes most of the configfiles to jsons. AWTRIX should convert all existing files automatically when they are first used.
Shows current app on homepage
Adds "about" page
Adds special setup screen for the animation app
Fixes some smaller bugs
prevents non-ASCII characters, spaces, and existing names in AWTRIXER
Adds animations if you switch awtrix off or on
Adds multi-language support
- You can help to translate on poeditor
- place your translated json in the languages folder, select it in the host settings and restart AWTRIX
- New and completely translated languages will be added to the next host updates
- All translations only affects the webinterface, not apps or API
Adds Rainbow text. This will fade every text in rainbow colors. Custom settings will be ignored. You can change the speed via the rainbowdivider
Changes some oAuth2 routines to make apps like Spotify more stable (you may logout and login again)
You can logout from oAuth2 apps like Spotify
Deleting oAuth2 apps like Spotify will also delete the token completely
You can switch between apps with arrow keys instead of clicking buttons in webinterface
Sidebar improvments
There is no restart required if you change the timezone
You can now show up to 4 Icons in your notification. Text is disabled with this function
(jsonkeys: "icon","icon2","icon3","icon4")
Some internal changes of the AWTRIX App loader
Adds the possibility to start the premium sleepmode when its dark (via LDR) instead of a timespan
Rollback the internal serial library to still support older hardware like the PiZero
Adds python runtime so you can write python apps for awtrix
AWTRIX uses the Java ScriptEngine Nashorn together with jython for that. Because the awtrix runnable jar contains the jython library, the file size is now 54mb.
Place your python file in the apps folder and restart awtrix. all python apps will be loaded like regular native apps.
Notes:
- Accessing a pythonscript will block awtrixs mainthread. That means if your python function contains heavy loops or other time-consuming things like downloads, Awtrix stops for that time. So keep your processings fast, otherwise unexpected side effects may occur
- All python apps will be loaded as a modul. The python import system uses a cache, so if you change something in your python app, it will be not loaded since the module is already cached. Until i find a solution for that, you can rename your app as a workaround.
- You need premium to use python apps
Example of an app.py:
All variable names and function names must remain exactly as they are
import urllib, json
Version = 1.0
Author = "Blueforcer"
Description = "AWTRIX app written in python"
HowToSetup = "Example Text"
Covericon = 1164
Repeat=2
MoveIcon=True
CustomScreen=False #not working yet
Settings = {"Prefix": "MissionName: "} #Usersettings
#Dont modfiy this
def init():
return [Version,Author,Description,HowToSetup,Covericon,Repeat,MoveIcon,CustomScreen]
def started():
print("App started")
def running():
print("App running")
def finished():
print("App finished")
def getSettings():
return Settings
#This function is called when AWTRIX trigger all apps to do their downloads.
#Unlike native apps you will need to return the iconID and Text wich should be show
#You also will get a map of the Userettings to work with
def getData(settings):
url = "https://api.spacexdata.com/v3/launches/next"
response = urllib.urlopen(url)
data = json.loads(response.read())
SpaceXMission = data["mission_name"]
return [1164,settings["Prefix"] + SpaceXMission]
Adds new languages (German, English, French, Polish, Chinese, Turkish)
- If you want to change some text strings you can do this here
In the past it was only possible to control AWTRIX from your Smarthome. Now you can also control your Smarthome with AWTRIX via MQTT!
- create a mqtt.json inside the config folder e.g:
[
{
"name": "Light1 On",
"topic": "schlafzimmer/licht/cmd",
"payload": "on"
},
{
"name": "Washingmachine Off",
"topic": "keller/Washingmachine/cmd",
"payload": "off"
}
]
- You can add as many options as you like.
- You dont need to restart awtrix if you made changes to the json, just reload the menu.
- Enter AWTRIX menu via touchbuttons (long middle push).
- Navigate to the MQTT option (left or right button) and select it (short middle push).
- Choose your option from your mqtt.json by name via left or right button, and acitvate it (short middle push). AWTRIX will send the payload to the given topic.
- You can exit the menu by holding the middle button.
Fixes a bug in the timer where it flickers over other apps
Fixes some bugs in the basics api
Fixes a bug while downloading new Apps
Fixes some bugs in basics api. See here
Fixes a bug in the logger function
Fixes a bug wich causes a crash when sending a faulty JSON via MQTT
Fixes a bug where AWTRIX loses the premiumkey at startup
Fixes a bug where app icons are not animated anymore. (hopefully ๐ค)
Fixes the icon database viewer
Fixes a crash in boot process
Fixes a bug in autobrightness
Fixes a bug where the premium settings are not saved
Controller 0.26
- Adds the possibility to draw filled rectangles wich is needed for barchart
- You can reset the controller by holding left and right touchbutton for 6s while powering on.
- Adds Multicolortext