Files
Matewave/README.md
T

5.1 KiB

Matewave icon

Matewave

A beautiful, open-source chess app for Android.
Play against the AI, solve puzzles, learn openings, or play friends nearby over Bluetooth and Wi-Fi/LAN.

Important

Matewave is coming to Google Play! The app is now in closed testing there ahead of the public release. Ideas, wishes and suggestions for improvement are very welcome — send them wherever is easiest for you: an issue on Gitea or GitHub, or an email to cuken107@proton.me.

Note

Looking for designers! Matewave is looking for volunteer designers to help with icons, logos, animations, cover art (store graphics) and UI design. This is unpaid help for an open-source project. If you're interested, write to cuken107@proton.me.

Latest release

Get it on F-Droid Get it on Obtainium Get it on GitHub Get it on Gitea

Play, learn, solveHome screen Play AI or a friend Puzzles for your rating

Tip

If you find Matewave useful, please consider giving it a ⭐ — it helps others discover the project.

✨ Features

  • 🤖 AI opponent with adjustable difficulty
  • 🧩 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
  • 👀 Watch friends play — up to 20 spectators on the same Wi-Fi can follow a live LAN game
  • 📲 Share the app with a nearby friend via QR code over the local network
  • 🎷 Optional jazz radio
  • 🌙 Dark theme
  • 🌍 Six languages — English, Russian, German, Japanese, Lithuanian and Chinese

Installation

  • F-Droid — install and update through the F-Droid client.
  • Obtainium — installs the APK straight from Gitea releases and keeps it up to date.
  • Manually — download the latest APK from GitHub or Gitea, allow installs from unknown sources for the app you open it with (Settings → Apps → Special access → Install unknown apps), then open the .apk and confirm.

Verifying a download

Every official APK is signed with the same key. Check it before installing:

apksigner verify --print-certs Matewave-v<version>.apk

The SHA-256 fingerprint of the signing certificate must be:

1C:3E:54:54:9D:09:9A:9D:3D:5B:BE:ED:C5:63:F5:7F:60:12:56:3C:88:85:99:B1:88:B4:FB:17:E3:46:46:A9

apksigner prints the same value in lowercase without colons. On Android you can check it with AppVerifier (app ID cc.skysparkle.matewave).

Building from source

Requires JDK 17+ and Android Studio with AGP 9.2 support.

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

🤝 Contributing

Bug reports, puzzle and opening fixes, translation fixes and pull requests are welcome in the issue tracker. Please read CONTRIBUTING.md first — it explains what fits the project and how to send changes. To open an issue or a pull request, create an account on this Gitea.

📄 License

GNU General Public License v3.0 or later.