Repository navigation
Akiba 1.0
Akiba v1.0 - Chess Arbiter Monitoring System
π First Release!
Welcome to Akiba β a powerful monitoring system designed specifically for chess arbiters. This is the initial release (version 1.0) of this project.
π What Is Akiba?
Akiba automatically monitors chess games in real-time and alerts arbiters about important situations that require attention, such as draw claims according to FIDE regulations. Think of it as an independent tool, based on live chess broadcasts, that helps arbiters make informed decisions during tournaments.
π Why "Akiba"?
The name Akiba honors Akiba Rubinstein (1880β1961), a legendary Polish Grandmaster who represented Poland with great success in the Chess Olympiads, including winning a historic team gold medal in 1930.
Additionally, "Akiba" carries multiple meaningful interpretations:
- "To follow" β rooted in the name's traditional meaning, symbolizing how the program continuously follows, tracks, and monitors chess games in real-time.
- "To protect" β rooted in the name's traditional meaning, representing the program's commitment to protecting the integrity of the game by providing chess arbiters with precise, data-driven support for fair decision-making.
- Geek district β a nod to Akihabara (affectionately abbreviated as Akiba) in Tokyo, the world-famous district for technology, symbolizing innovation and software precision.
β¨ Key Features
π Claims Monitoring β Automatically detects:
- 3-fold repetition (claimable draw)
- 5-fold repetition (automatic game end)
- 50-move rule (claimable draw)
- 75-move rule (automatic game end)
- Checkmate, stalemate, and dead position (automatic game end)
β‘ Live Monitoring β All sources update in real-time every 4 seconds:
- Web URLs (PGN files on websites)
- Local files (monitors PGN file changes)
- LiveChessCloud platform support (via API, with round selection)
π Board Viewer β Visual representation of key positions:
- Green border highlights critical repetition positions (3rd/5th occurrence)
- Red border indicates illegal moves detected in the game
- Yellow highlight shows last executed move
π Notifications & Reminders β Alerts for:
- Two-fold repetition & 45-move markers
- Time control, players low on time & flag fall
- New scoresheet reminders
- Sofia rule violations
- First illegal move detection
π How Akiba Differs from the Original Chess Claim Tool
Akiba evolved from the excellent Chess Claim Tool by Athanasios Serntedakis (original author), which itself had a fork at tditm/chess-claim-tool. After extensive modifications and new features, this has become a completely reimagined project:
| Feature | Original Chess Claim Tool | Akiba v1.0 |
|---|---|---|
| Data Sources | Local files & Web URLs | β Plus LiveChessCloud platform support |
| Board Visualization | None | β Full Board Viewer with color-coded positions |
| Game Filtering | None | β Search by player name/board number, active games filter |
| Reminders System | No | β Time control, low time, scoresheet reminder, Sofia rule, two-fold, 45-moves, flag fall, illegal move |
| Notifications | Yes | β Option to enable or disable system notifications |
| ACK System | No | β Acknowledge and clear resolved claims |
| UI/UX | PyQt5 | β PyQt6 modern interface with improved workflow |
π Documentation
Full user documentation is available in English and Polish:
π Quick Start
- Download
Akiba.exefrom the Assets section below. - Run without installation β it's completely portable!
- Add your data sources (URLs, local files, or LiveChessCloud links).
- Click "Start" and let Akiba monitor the games for you.
π Acknowledgments
This project is built upon the foundation of Chess Claim Tool by Athanasios Serntedakis (@dedekind125). Special thanks to the original author for creating an excellent tool that serves chess arbiters worldwide. Akiba continues this legacy with enhanced features and modern improvements.
- Original project: https://github.com/dedekind125/chess-claim-tool
- Fork reference: https://github.com/tditm/chess-claim-tool
π License
GNU General Public License v3.0 (GPL-3.0)
Akiba v1.0 β Open-source tool for chess arbiters, made with βοΈ passion.