Files
Matewave/README.md
T
kalarina e41c7c46dc Remove CHANGELOG.md and verify downloads by signing key
CHANGELOG.md was out of date (stopped at v1.0.42 under the old
Matewawe name), so it is removed. README now tells users to verify
the APK signing certificate instead of per-file checksums, fixes the
APK file name in the adb example, and merges duplicate feature lines.
2026-10-10 15:17:21 +00:00

107 lines
3.8 KiB
Markdown

<p align="center">
<img src="assets/icon-rounded.png" width="128" alt="Matewave icon">
</p>
<h1 align="center">Matewave</h1>
<p align="center">
<a href="https://git.skysparkle.cc/kalarina/Matewave/releases"><img src="assets/get-it-on-gitea.png" height="60" alt="Get it on Gitea"></a>
</p>
<p align="center">
<img src="https://img.shields.io/github/downloads/kalarina-bit/Matewave/latest/total?label=downloads&color=2e7d32&labelColor=1b1b1b" alt="downloads counter">
</p>
**A beautiful, open-source chess app for Android.**
Play chess against AI, solve chess puzzles, learn and practice
chess openings, or play local multiplayer games with friends
over Bluetooth and Wi-Fi/LAN.
## Features
- 🤖 AI opponent with adjustable difficulty
- 🧩 Chess puzzles and tactical training
- 📖 Opening trainer — learn and practice opening lines and their variations
- 📶 Local multiplayer over Bluetooth or Wi-Fi/LAN, with nearby player discovery
- 📲 Share the app with a nearby friend via QR code over the local network
- 🎷 Optional built-in jazz radio
- 🌙 Dark theme
- 🌍 English, Russian, German, Japanese, Lithuanian and Chinese
- 🔓 100% open source
## Screenshots
<p align="center">
<img src="assets/screenshots/5-move-count.png" width="200" alt="Make your next move count">
<img src="assets/screenshots/4-home.png" width="200" alt="Home screen">
<img src="assets/screenshots/1-friendly-matches.png" width="200" alt="From solo games to friendly matches">
<img src="assets/screenshots/3-play-together.png" width="200" alt="Play together">
<img src="assets/screenshots/2-keep-growing.png" width="200" alt="Keep growing">
</p>
## Installation
<img src="assets/icon-install.png" width="36" align="left">
1. Download the APK for the version you want from the [Releases page](https://github.com/kalarina-bit/Matewave/releases).
2. On your Android device, allow installs from unknown sources for the app you use to open the file (Settings → Apps → Special access → Install unknown apps).
3. Open the downloaded `.apk` file and confirm the install.
Or via `adb` (after downloading):
```sh
adb install Matewave-v1.0.43.apk
```
## Verifying a download
<img src="assets/icon-verify.png" width="36" align="left">
Every official APK is signed with the same key. Check the signing certificate before installing:
```sh
apksigner verify --print-certs Matewave-v1.0.43.apk
```
The `Signer #1 certificate SHA-256 digest` must be:
```
1c3e54549d099a9d3d5bbeedc563f57f6012563c888599b188b4fb17e34646a9
```
On Android you can check it with [AppVerifier](https://github.com/soupslurpr/AppVerifier) (app ID `cc.skysparkle.matewave`).
## Building from source
Open the project in Android Studio (a version that supports AGP 9.2) and run the `app` configuration, or:
```sh
./gradlew assembleDebug
./gradlew testDebugUnitTest # JVM unit tests
```
Nearby multiplayer needs two physical devices — the emulator has no real Bluetooth, and mDNS discovery is often blocked on emulator networks.
## Repository structure
<img src="assets/icon-structure.png" width="36" align="left">
```
.
├── app/ # Android app source (Kotlin, Jetpack Compose) and unit tests
├── assets/ # Icon and README images
│ └── screenshots/ # App screenshots
├── fastlane/ # F-Droid store listing, screenshots and changelogs
├── fdroid/ # Build recipe for fdroiddata
├── gradle/ # Gradle wrapper
├── LICENSE # GNU GPLv3
└── README.md
```
APK builds themselves are published as assets on the [Releases page](https://github.com/kalarina-bit/Matewave/releases), not stored in this repository.
## License
This project is licensed under the **GNU General Public License v3.0** — see the [LICENSE](LICENSE) file for details.