Claude
f8d63140e4
The Pexels forest photo is replaced by the author's own background, so its credit is dropped from the Licenses screen (all six locales) and the NonFreeAssets anti-feature is removed from the F-Droid recipe. Sound effects are replaced as well, and the old generator script in tools/ is removed. Settings no longer duplicates the opening-bar switch, which lives in Appearance. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015g6ECVSKcBG8CJPrqC3G5o
100 lines
3.5 KiB
Markdown
100 lines
3.5 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
|
|
- 📖 Chess openings — learn and practice opening lines
|
|
- ♟️ Opening practice for different variations and move sequences
|
|
- 📶 Local multiplayer over Bluetooth/LAN
|
|
- 👥 Nearby player discovery over local Wi-Fi
|
|
- 🌙 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 Matewawe-v1.0.42.apk
|
|
```
|
|
|
|
## Verifying a download
|
|
|
|
<img src="assets/icon-verify.png" width="36" align="left">
|
|
|
|
Compare the SHA-256 checksum against the value listed in [CHANGELOG.md](CHANGELOG.md):
|
|
|
|
```sh
|
|
sha256sum Matewawe-v1.0.42.apk
|
|
```
|
|
|
|
## 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
|
|
├── CHANGELOG.md # Per-version build dates, sizes and checksums (links to GitHub Releases)
|
|
├── 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.
|