Matewave

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

Installation

1. Download the APK for the version you want from the Releases page.
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):

adb install Matewawe-v1.0.42.apk

Verifying a download

Compare the SHA-256 checksum against the value listed in CHANGELOG.md:

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:

./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

.
├── 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
├── tools/               # Helper scripts (sound effect generation)
├── 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, not stored in this repository.

License

This project is licensed under the GNU General Public License v3.0 — see the LICENSE file for details.