<!-- markdownlint-configure-file {
  "MD013": {
    "code_blocks": false,
    "tables": false
  },
  "MD033": false,
  "MD041": false
} -->

<div align="center">

# AWTRIX LIGHT

![GitHub all releases](https://img.shields.io/github/downloads/blueforcer/awtrix-light/total?style=flat-square)
![GitHub Sponsors](https://img.shields.io/github/sponsors/blueforcer?style=flat-square)
![Discord](https://img.shields.io/discord/546407049148366859?label=Discord&style=flat-square)
[![Compile](https://github.com/Blueforcer/awtrix-light/actions/workflows/main.yml/badge.svg?branch=main)](https://github.com/Blueforcer/awtrix-light/actions/workflows/main.yml)
    
<a href="http://www.youtube.com/watch?feature=player_embedded&v=N0NKPJzGHuA" target="_blank">
 <img src="http://img.youtube.com/vi/N0NKPJzGHuA/mqdefault.jpg" alt="Watch the video" height="280" border="10" />
</a>  
</div>  

AWTRIX Light is a open‑source custom firmware for the [Ulanzi Smart Pixel clock TC001](https://www.ulanzi.com/products/ulanzi-pixel-smart-clock-2882)  
  
AWL meant to be a companion for your smarthome like HomeAssistant, IOBroker, NodeRed and so on.    
Even if you don't have a Smarthome system, but would like to experiment with NodeRed or N8N, you are still welcome to join us.  
There are many users who are willing to help you!  

It is ready to use straight out of the box, with time, date, temperature, and humidity pages pre-installed. You don't need to do anything other than turning it on to start using these features.    

However, for those with more advanced skills, the customization options available with customapps and mqtt commands allows you to take Awtrix Light to its full potential.
Just send all your customapps from your smarthome via MQTT and update it in realtime.
The powerful icon system bring your ideas to life and enjoy a hassle-free experience   

Join the thousands of satisfied awtrix users who have already chosen Awtrix 2 and Awtrix Light and experience the difference today! 

# Features
- Easy to setup
- Homeassistant discovery
- Onscreen menu where you can change your settings directly on the device
- Pre-installed Apps like time, date, temperature, humidity and battery
- Add customapps without recompiling straight from your Smarthome.
- Notification support
- Animated icons
- Custom icons without recompiling
- Easy to use icon system
- Powerful MQTT commands
- HTTP API
- RTTTL melody player
- Integrated filebrowser
- No cloud 
- No telemetry

# Getting Started

Starting is easy as 1-2-3
[with the documentation](https://blueforcer.github.io/awtrix-light/)

# Contributors 
<a href="https://github.com/Blueforcer/awtrix-light/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=Blueforcer/awtrix-light" />
</a>

# Community  
Join the discord channel with over 1500 Users  
https://discord.gg/cyBCpdx  

# Support  
If you like my work, please consider supporting the project.  
https://github.com/sponsors/Blueforcer  
