Repository navigation
Releases
Akiba 1.1
Akiba v1.1 - Release Notes
Release Date: 2026-11-10
Version: 1.1
Type: Major Feature Release
Overview
Akiba v1.1 is a significant update that introduces preliminary Fair-Play Analysis capabilities, fixes two bugs, and improves the overall user experience with enhanced visual feedback and move highlighting.
New Features
🛡️ Fair-Play Analysis Module
The flagship feature of v1.1 - a preliminary fair-play assessment tool for chess arbiters.
Key Capabilities:
- Levels: Three-tier (LOW/MEDIUM/HIGH) with color-coded indicators
- Elo-Adjusted Thresholds: Thresholds automatically adjusted based on player ratings
- SPI (Sigmoidal Precision Index): Score that can independently trigger alerts
Metrics Displayed:
| Metric | Description | Range / Unit |
|---|---|---|
| T1 (Top Match Rate) | Percentage of moves matching Stockfish's top choice | 0-100% |
| BR (Blunder Resistance) | Resistance to blunders based on move accuracy | 0-100% |
| APL (Average Point Loss) | Average error margin in centipawns (100 centipawns = 1 pawn) | Centipawns |
| SPI (Sigmoidal Precision Index) | Statistical precision index where ~50 represents the human norm | ~30-90+ |
How to Use:
- Open a Board Viewer
- Right-click on any game in the game list
- Select "Fair-Play Analysis" from the context menu
- View results with level indicators for both players
Level Indicators
| Level | Color | Action |
|---|---|---|
| LOW | 🟢 Green | None |
| MEDIUM | 🟠 Orange | Routine observation recommended |
| HIGH | 🔴 Red | Further review recommended |
Technical Specifications:
- Engine: Stockfish (integrated) with depth=20, time=2.0s per position
- Hash Size: 16MB
- MultiPV: 3 (top 3 engine lines)
- Analysis starts from move 11 (opening moves excluded)
- Late endgames with < 6 pieces excluded
🔍 Incorrect Result Checker
New reminder type that detects discrepancies between declared game results and Stockfish evaluation of the final position.
When it triggers:
- Recorded result in PGN headers (1-0, 0-1, 1/2-1/2) significantly differs from the engine's evaluation
- Example: Game recorded as win for White, but final position shows Black advantage
Alert Message: "Result verification - position evaluation suggests a different outcome"
Bug Fixes
Claim Detection Fixes
| Issue | Fix |
|---|---|
| 5-fold repetition crash | Fixed crash in 5-fold checker when detecting automatic game end |
| Flag fall trigger | Fixed incorrect flag fall detection timing |
Duplicate Elimination
Fixed duplicate entries in multiple claim types:
- ✅ 2-fold repetition duplicates eliminated
- ✅ 50-move rule duplicates eliminated
- ✅ 75-move rule duplicates eliminated
Move Highlighting Fixes
Fixed move highlighting issues across all reminder types:
- ✅ Time control warning highlights
- ✅ Low time warning highlights
- ✅ Scoresheet change warning highlights
- ✅ Sofia rule violation highlights
- ✅ 45-move reminder highlights
- ✅ Incorrect result checker highlights
Visual Improvements
Board Viewer Enhancements
| Improvement | Description |
|---|---|
| Move Coloring | Improved color scheme for better visibility of move history |
| Chessboard Border | Enhanced border coloring for clearer board boundaries |
| Move Highlights | Better visual indication of active/current move position |
| Icon Rounding | Improved icon rendering with proper rounding |
UI/UX Improvements
- Reorganized menu structure for better navigation
Technical Changes
Code Quality
- Eliminated code duplication in claim checkers
- Improved error handling in edge cases
Performance
- Optimized Stockfish analysis for Fair-Play module
- Reduced memory footprint during live monitoring
- Faster duplicate detection algorithms
Documentation Updates
| Document | Changes |
|---|---|
| README.md | Added Fair-Play Analysis section with usage instructions |
| USER_DOCUMENTATION.md | Comprehensive Fair-Play Analysis guide in English |
| DOKUMENTACJA_UZYTKOWNIKA.md | Complete Polish translation of new features |
Known Issues
None at this time. All critical bugs from v1.0 have been addressed.
Upgrade Notes
For Existing Users
No migration required. Simply download v1.1 and run the application.
New Features to Explore
- Fair-Play Analysis - Right-click any game in Board Viewer
- Incorrect Result Checker - Automatically enabled, no configuration needed
- Enhanced Move Highlighting - Visible across all claim/reminder types
Changelog Summary
| Category | Count |
|---|---|
| New Features | 2 major (Fair-Play, Incorrect Result) |
| Bug Fixes | 2 fixes |
| Visual Improvements | 5 enhancements |
| Documentation | 3 updated documents |
Credits
Akiba v1.1 was developed with AI-assisted workflows to ensure high code quality and optimal performance.
Original Foundation: Based on Chess Claim Tool by Athanasios Serntedakis (@dedekind125)
Akiba v1.1 - Chess Arbiter Monitoring System
An open-source tool for chess arbiters.
License: GPL-3.0
Contributors
Assets 3
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.