ChessTimer
On your display
Verwandle deine Ulanzi TC001 oder TC002 in eine Schachuhr mit zwei individuell einstellbaren Spielerzeiten, Tastensteuerung, Zugwechsel, Pause und Reset.
- Topic
- Gaming
- Includes
- Script
Runs on
- Runs on 32×8 (TC001 & DIY) 32×8 (TC001 & DIY) version
- Runs on 52×16 (TC002)
- Does not run on 32×8 with AWTRIX 3 (TC001 & DIY) Made for AWTRIX NG.
Choose your display in the next step.
Script description
♟️ Chess Timer – Digital Chess Clock for AWTRIX NG

🇩🇪 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:
- Suche und Auswahl von AWTRIX-NG-Uhren im lokalen Netzwerk
- Verbindung über IP-Adresse, auch bei passwortgeschützten Geräten
- Automatische Unterscheidung zwischen TC001 und TC002 anhand der Displayauflösung
- Individuelle Konfiguration der Spielerzeiten
- Installation auf mehreren ausgewählten Uhren
- Automatische Übertragung des passenden Berry-Skripts
- Nachträgliche Änderung der Zeitlimits ohne erneuten Skript-Upload
- 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
🇬🇧 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:
- Discovering and selecting AWTRIX NG devices on the local network
- Manual IP connection and password-protected devices
- Automatic identification of TC001 and TC002 based on display resolution
- Individual player time configuration
- Installing Chess Timer on multiple selected devices
- Automatic deployment of the correct Berry script
- Updating time limits later without re-uploading the script
- 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
.axscripts 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
☕ Support Development
If you enjoy Chess Timer and would like to support further development, you can buy me a coffee.
Developed by Q14siX · MIT License · AWTRIX NG
Sign in to view and copy the code of this script.
Discussion 0
Ask a question, suggest a change or share how you use it.
No comments yet. Start the conversation.

Have an idea?
Sign in to ask questions and join the conversation.