Skip to content

New Share your ideas with the AWTRIX community. Keep your creations together in your account.

Sign in

Which AWTRIX do you have? Choose it once and the Hub shows what runs on it.

ScriptAWTRIX NG

ChessTimer

On an AWTRIX display
ChessTimer shown on an AWTRIX display
ChessTimer · by Q14siX

On your display

Verwandle deine Ulanzi TC001 oder TC002 in eine Schachuhr mit zwei individuell einstellbaren Spielerzeiten, Tastensteuerung, Zugwechsel, Pause und Reset.

Which AWTRIX do you have? See below where it runs, or choose your device.
Topic
Gaming
Includes
Script

Runs on

  • Runs on 32×8 (TC001 & DIY)
  • Runs on 52×16 (TC002) 52×16 (TC002) version
  • Does not run on 32×8 with AWTRIX 3 (TC001 & DIY) Made for AWTRIX NG.

Choose your display in the next step.

Send to AWTRIX

Choose your AWTRIX

ChessTimerAWTRIX NG script

Install this script on your AWTRIX NG. Its icons and sounds are installed with it.

Your AWTRIX’s local address, for example 192.168.178.39 or awtrix.local.

The name shown in your AWTRIX script list. Use letters, digits, hyphens or underscores.

Connection & device login

Connect your phone or computer to the same network as your AWTRIX. Allow local network access if your browser asks.

Use the device’s IP address, without a page path such as /#/apps.

If your AWTRIX requires a login, the username and password fields will appear when you connect.

Sign in to the Hub to install scripts. Attached files are installed separately.

Script description

♟️ Chess Timer – Digital Chess Clock for AWTRIX NG

Chess Timer


🇩🇪 Deutsch

Chess Timer – Deine Ulanzi wird zur digitalen Schachuhr!

Chess Timer verwandelt deine Ulanzi TC001 oder TC002 mit AWTRIX NG in eine vollwertige digitale Schachuhr für zwei Spieler.

Ob Blitzschach, Schnellschach oder eine gemütliche Partie: Beide Spieler erhalten einen eigenen Countdown, der direkt auf der LED-Matrix dargestellt wird. Die gesamte Partie lässt sich über die physischen Tasten der Uhr bedienen – ganz ohne Smartphone oder Computer.

Die Anwendung läuft eigenständig auf dem Gerät und benötigt während des Spiels weder eine Internetverbindung noch einen externen Server.

⏱️ Funktionen der Schachuhr

  • Zwei unabhängig konfigurierbare Spielerzeiten
  • Millisekundengenaue interne Zeitberechnung mit Sekundenanzeige
  • Frei einstellbare Bedenkzeit von 00:01 bis 99:59 Minuten
  • Unterschiedliche Zeitlimits für beide Spieler möglich
  • Schnellwahl zwischen 1, 3, 5, 10, 15 und 30 Minuten
  • Start, Pause und Fortsetzen der Partie
  • Spielerwechsel unmittelbar nach jedem Zug
  • Zurücksetzen beider Countdown-Timer
  • Automatischer Stopp bei Zeitablauf
  • Rot blinkende Anzeige bei abgelaufener Bedenkzeit
  • Farbige Kennzeichnung des aktiven Spielers
  • Optimierte LED-Darstellung für beide Ulanzi-Modelle
  • Vollständige Bedienung über die physischen Tasten
  • Zusätzliche Drehknopfsteuerung bei der TC002
  • Anpassbare Bedenkzeiten über die AWTRIX-NG-Weboberfläche

🖥️ LED-Anzeigen

Die verbleibende Bedenkzeit beider Spieler wird gleichzeitig im Format MM:SS dargestellt.

Spieler 1 – Türkis: Die linke Zeitanzeige gehört Spieler 1.

Spieler 2 – Orange: Die rechte Zeitanzeige gehört Spieler 2.

Während eine Spielerzeit herunterzählt, wird diese deutlich hervorgehoben. Die Anzeige des anderen Spielers wird abgedunkelt.

Zusätzliche LED-Indikatoren zeigen den aktuellen Betriebszustand:

  • Startbereit: Beide Spielerzeiten sind vollständig geladen.
  • Spieler 1 aktiv: Die linke Zeit läuft.
  • Spieler 2 aktiv: Die rechte Zeit läuft.
  • Pausiert: Beide Zeiten stehen still; die Pausenanzeige erscheint.
  • Zeit abgelaufen: Der Countdown stoppt und die betroffene Spielerzeit blinkt rot.

Ulanzi TC001 – 32 × 8 LEDs

Für die kompakte LED-Matrix der TC001 wurde eine besonders platzsparende Darstellung entwickelt.

Beide Countdown-Timer werden nebeneinander angezeigt. Farbige Markierungen oberhalb und unterhalb der Zeit sowie zusätzliche Statuspixel machen den aktiven Spieler erkennbar.

Ulanzi TC002 – 52 × 16 LEDs

Die TC002 erhält ein eigenständiges, auf die größere LED-Matrix abgestimmtes Layout.

Größere Zeitziffern, zusätzliche Statusmarkierungen und deutlichere Trennlinien ermöglichen eine übersichtliche Anzeige beider Spielerzeiten.

Außerdem wird der Drehknopf der TC002 für die Steuerung unterstützt.

🎮 Bedienung über die Uhr

Taste Funktion
Links kurz Zug von Spieler 1 beenden und Spieler 2 aktivieren
Rechts kurz Zug von Spieler 2 beenden und Spieler 1 aktivieren
Mitte kurz Starten, pausieren oder fortsetzen
Links lang Schachuhr zurücksetzen, wenn nicht aktiv
Rechts lang Zeitvorgabe wechseln, wenn nicht aktiv
Mitte lang Uhrenmenü öffnen bzw. Schachuhr verlassen

Ein Spielerwechsel wird nur akzeptiert, wenn der entsprechende Spieler tatsächlich am Zug ist und die Partie läuft.

Zusätzliche TC002-Steuerung:

  • Drehknopf kurz drücken: Start/Pause
  • Drehknopf drehen: Zeitvorgabe auswählen, solange die Partie nicht läuft
  • Drehknopf lang drücken: Timer zurücksetzen, solange die Partie nicht läuft

⚙️ Individuelle Zeitkontrolle

Chess Timer unterstützt unterschiedliche Bedenkzeiten für beide Spieler.

Beispiele:

  • 3 Minuten gegen 3 Minuten
  • 5 Minuten gegen 5 Minuten
  • 10 Minuten gegen 10 Minuten
  • 15 Minuten gegen 15 Minuten
  • 5 Minuten gegen 10 Minuten

Über die Weboberfläche können Minuten und Sekunden für jeden Spieler unabhängig voneinander festgelegt werden.

Die gespeicherten Zeitvorgaben lassen sich später jederzeit ändern, ohne das eigentliche Uhrenskript erneut installieren zu müssen.

Alternativ können Zeitvorgaben unmittelbar an der Uhr ausgewählt werden. Diese Auswahl kann jederzeit wieder auf die gespeicherte Webkonfiguration zurückgestellt werden.

Hinweis: Eine Änderung der gespeicherten Zeitkonfiguration setzt eine laufende Partie zurück.

🚀 Installation über GitHub

Chess Timer verfügt über einen responsiven, mehrseitigen HTML-Installationsassistenten.

▶ Chess Timer direkt installieren

Der Installationsassistent bietet:

  1. Suche und Auswahl von AWTRIX-NG-Uhren im lokalen Netzwerk
  2. Verbindung über IP-Adresse, auch bei passwortgeschützten Geräten
  3. Automatische Unterscheidung zwischen TC001 und TC002 anhand der Displayauflösung
  4. Individuelle Konfiguration der Spielerzeiten
  5. Installation auf mehreren ausgewählten Uhren
  6. Automatische Übertragung des passenden Berry-Skripts
  7. Nachträgliche Änderung der Zeitlimits ohne erneuten Skript-Upload
  8. Manuellen Skript-Export als Alternative zur direkten Installation

Die Installation erfolgt über die AWTRIX-NG-HTTP-Schnittstelle. Die Skripte werden direkt aus dem GitHub-Repository geladen.

Je nach Browser können für den Zugriff auf lokale Netzwerkgeräte zusätzliche Berechtigungen erforderlich sein.

Nach der Installation lässt sich die Schachuhr über das Scripts-Menü der Uhr starten.

🔧 Technische Eigenschaften

  • Entwickelt für AWTRIX NG mit Berry-Unterstützung
  • Separate .ax-Skripte für TC001 und TC002
  • Eigenständige On-Demand-Anwendung außerhalb der normalen App-Rotation
  • Lokale Countdown-Berechnung direkt auf der Uhr
  • Keine Cloud-Anbindung erforderlich
  • Keine zusätzliche Hardware erforderlich
  • Kein Home Assistant erforderlich
  • Kein dauerhaft laufender Computer notwendig
  • Webbasierte Installation und Konfiguration

Einschränkungen: Diese Version unterstützt noch keinen Zeitbonus pro Zug (Fischer-/Bronstein-Inkrement), keine Speicherung des Partieverlaufs und keine Wiederherstellung einer Partie nach einem Stromausfall.

🔗 Links

▶ Web-Installer starten

GitHub-Repository


🇬🇧 English

Chess Timer – Turn Your Ulanzi into a Digital Chess Clock!

Chess Timer transforms your Ulanzi TC001 or TC002 running AWTRIX NG into a fully functional two-player digital chess clock.

Whether you're playing blitz chess, rapid chess, or a casual game, each player gets an independent countdown displayed directly on the LED matrix.

The entire game can be controlled using the clock's physical buttons, without needing a smartphone or computer.

Chess Timer runs locally on the device. No cloud service, external server, or internet connection is required during a game.

⏱️ Chess Clock Features

  • Two independently configurable player timers
  • Millisecond-based internal timing with second-resolution display
  • Adjustable time controls from 00:01 to 99:59 minutes
  • Different starting times for each player
  • Quick presets for 1, 3, 5, 10, 15, and 30 minutes
  • Start, pause, and resume functionality
  • Instant player switching after each move
  • Reset both countdown timers
  • Automatic stop when time expires
  • Flashing red timeout indicator
  • Color-coded active player indication
  • Dedicated LED layouts for both Ulanzi models
  • Complete control using physical buttons
  • Additional rotary knob support for TC002
  • Configurable time limits through the AWTRIX NG web interface

🖥️ LED Display

Both players' remaining times are displayed simultaneously in MM:SS format.

Player 1 – Cyan: The left side represents player 1.

Player 2 – Orange: The right side represents player 2.

The active player's countdown is highlighted while the other player's display is dimmed.

Additional LED indicators show the current state:

  • Ready: Both countdown timers are initialized.
  • Player 1 active: The left timer is running.
  • Player 2 active: The right timer is running.
  • Paused: Both timers are stopped and a pause indicator is displayed.
  • Time expired: The game clock stops and the affected player's display flashes red.

Ulanzi TC001 – 32 × 8 LEDs

The TC001 features a dedicated compact display optimized for its 32 × 8 LED matrix.

Both countdown timers appear side by side, with color-coded highlights and additional status pixels indicating the active player and timer state.

Ulanzi TC002 – 52 × 16 LEDs

The TC002 uses a separate layout designed specifically for its larger 52 × 16 LED matrix.

Larger timer digits, additional status indicators, and clearer visual separation make both countdowns easier to read.

The TC002 also supports rotary knob controls.

🎮 Physical Button Controls

Button Action
Left – short press End player 1's turn and activate player 2
Right – short press End player 2's turn and activate player 1
Middle – short press Start, pause, or resume
Left – long press Reset while not running
Right – long press Cycle time presets while not running
Middle – long press Open device menu or exit the chess clock

Turn switching is only accepted when the corresponding player is active and the timer is running.

Additional TC002 rotary controls:

  • Short knob press: Start/Pause
  • Rotate knob: Select time preset while not running
  • Long knob press: Reset while not running

⚙️ Custom Time Controls

Chess Timer allows both players to have completely independent starting times.

Examples include:

  • 3 minutes vs. 3 minutes
  • 5 minutes vs. 5 minutes
  • 10 minutes vs. 10 minutes
  • 15 minutes vs. 15 minutes
  • 5 minutes vs. 10 minutes

Minutes and seconds can be adjusted separately for each player through the web interface.

Saved time limits can be modified later without reinstalling the clock script.

Quick presets are also available directly through the physical controls. You can switch back to the time limits saved through the web interface.

Note: Changing saved time controls resets any ongoing game.

🚀 Installation via GitHub

Chess Timer includes a responsive, multi-step HTML installation wizard.

▶ Launch Chess Timer Installer

The installation wizard supports:

  1. Discovering and selecting AWTRIX NG devices on the local network
  2. Manual IP connection and password-protected devices
  3. Automatic identification of TC001 and TC002 based on display resolution
  4. Individual player time configuration
  5. Installing Chess Timer on multiple selected devices
  6. Automatic deployment of the correct Berry script
  7. Updating time limits later without re-uploading the script
  8. Manual script export as an alternative installation method

The installer communicates with AWTRIX NG through its HTTP API and retrieves the required scripts directly from GitHub.

Some browsers may require additional permissions to access devices on the local network.

After installation, Chess Timer can be launched from the clock's Scripts menu.

🔧 Technical Details

  • Designed for AWTRIX NG with Berry scripting support
  • Separate .ax scripts for TC001 and TC002
  • Standalone on-demand application outside normal app rotation
  • Countdown calculation performed locally on the clock
  • No cloud connectivity required
  • No additional hardware required
  • No Home Assistant dependency
  • No permanently running computer needed
  • Web-based installation and configuration

Current limitations: Fischer/Bronstein increments, game-history storage, and game restoration after a power failure are not included in this version.

🔗 Links

▶ Launch Web Installer

GitHub Repository


☕ Support Development

If you enjoy Chess Timer and would like to support further development, you can buy me a coffee.

Buy Me a Coffee

Developed by Q14siX · MIT License · AWTRIX NG

More scripts in Gaming

Something wrong with this script? Report it.