clrsrc Bot, the Android app
A small Android app that brings the games of our Lichess bot @clrsrc_lc0 reliably to your phone: the running game as a live board and a notification the moment a new game starts or one ends – even when the app is closed. Open source, with no login at all.
The APK does not come from the Play Store, so you need to allow installation from unknown sources once; it is signed with the debug key. Requires Android 8.0 or newer.
What the app does
The main features – deliberately in plain language.
Live board
The running game of clrsrc_lc0 in real time: moves as they happen, the last
move highlighted, both clocks (the side to move ticks down by the second) and the detected
opening. The board flips automatically to the bot's side.
Background watcher
A service keeps watching the bot even when the app is closed and sends a notification the moment a new game starts or one ends (with the result). So you never miss a game without constantly checking.
History & record
A dedicated tab lists the recent games chronologically (result, opponent with Elo, time control, rated/casual, date & time) and aggregates them per opponent into a record – wins, draws, losses and the Elo balance at a glance.
Survives a reboot
If the watcher was active, it comes back on its own after a device restart – no need to switch it on again.
Freely configurable
By default the app follows clrsrc_lc0, but the watched bot can be changed at
any time. So it works with any Lichess bot. Plus options such as keeping the display
on during a game.
Portrait and landscape
Built with Jetpack Compose and Material 3. In landscape the board uses the full height, with controls and game info beside it – without the live stream dropping when you rotate.
How it works
Public interfaces only – no credentials, no account needed.
Public Lichess API
The app uses only the public Lichess API – no login, no OAuth. It polls for the current game every 15 seconds, reads its positions move by move from Lichess's live data stream and fetches the result at the end. The history comes from the bot's public game export.
Reliable in the background
The watcher runs as a foreground service with a persistent, quiet status notification – that is how Android is kept from killing it. For maximum reliability, exempt the app from battery optimization in the system settings.
License: the app is licensed – like the clrsrc engine – under GPL-3.0. It is a pure client of the public Lichess API and contains no Lichess server code. All the source code is open on GitHub: github.com/clrsrc/clrsrc-bot-app ↗. You can watch the bot playing on the live page →