mirror of
https://github.com/kalarina-bit/Matewave.git
synced 2026-11-22 08:06:09 +00:00
Restructure README
This commit is contained in:
@@ -4,6 +4,8 @@
|
|||||||
|
|
||||||
<h1 align="center">Matewave</h1>
|
<h1 align="center">Matewave</h1>
|
||||||
|
|
||||||
|
<p align="center"><b>A beautiful, open-source chess app for Android.</b></p>
|
||||||
|
|
||||||
<p align="center">
|
<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>
|
<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>
|
||||||
@@ -11,25 +13,21 @@
|
|||||||
<p align="center">
|
<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">
|
<img src="https://img.shields.io/github/downloads/kalarina-bit/Matewave/latest/total?label=downloads&color=2e7d32&labelColor=1b1b1b" alt="downloads counter">
|
||||||
<img src="https://img.shields.io/badge/Android-8.0%2B-2e7d32?logo=android&logoColor=white&labelColor=1b1b1b" alt="Android 8.0+">
|
<img src="https://img.shields.io/badge/Android-8.0%2B-2e7d32?logo=android&logoColor=white&labelColor=1b1b1b" alt="Android 8.0+">
|
||||||
|
<img src="https://img.shields.io/badge/License-GPL--3.0--or--later-2e7d32?labelColor=1b1b1b" alt="GPL-3.0-or-later">
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
**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.
|
||||||
|
|
||||||
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
|
## Features
|
||||||
|
|
||||||
- 🤖 AI opponent with adjustable difficulty
|
- 🤖 **AI opponent** with adjustable difficulty
|
||||||
- 🧩 Chess puzzles and tactical training
|
- 🧩 **Puzzles** and tactical training
|
||||||
- 📖 Opening trainer — learn and practice opening lines and their variations
|
- 📖 **Opening trainer** — learn and practice opening lines and their variations
|
||||||
- 📶 Local multiplayer over Bluetooth or Wi-Fi/LAN, with nearby player discovery
|
- 📶 **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
|
- 📲 **Share the app** with a nearby friend via QR code over the local network
|
||||||
- 🎷 Optional built-in jazz radio
|
- 🎷 **Optional jazz radio**
|
||||||
- 🌙 Dark theme
|
- 🌙 **Dark theme**
|
||||||
- 🌍 English, Russian, German, Japanese, Lithuanian and Chinese
|
- 🌍 **Six languages** — English, Russian, German, Japanese, Lithuanian and Chinese
|
||||||
- 🔓 100% open source
|
|
||||||
|
|
||||||
## Screenshots
|
## Screenshots
|
||||||
|
|
||||||
@@ -47,24 +45,18 @@ over Bluetooth and Wi-Fi/LAN.
|
|||||||
|
|
||||||
Requires **Android 8.0 (API 26) or newer**.
|
Requires **Android 8.0 (API 26) or newer**.
|
||||||
|
|
||||||
1. Download the APK for the version you want from the [Releases page](https://github.com/kalarina-bit/Matewave/releases).
|
1. Download the latest APK from the [Releases page](https://git.skysparkle.cc/kalarina/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).
|
2. Allow installs from unknown sources for the app you open it with (Settings → Apps → Special access → Install unknown apps).
|
||||||
3. Open the downloaded `.apk` file and confirm the install.
|
3. Open the `.apk` file and confirm the install.
|
||||||
|
|
||||||
Or via `adb` (after downloading):
|
|
||||||
|
|
||||||
```sh
|
|
||||||
adb install Matewave-v1.0.43.apk
|
|
||||||
```
|
|
||||||
|
|
||||||
## Verifying a download
|
## Verifying a download
|
||||||
|
|
||||||
<img src="assets/icon-verify.png" width="36" align="left">
|
<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:
|
Every official APK is signed with the same key. Check it before installing:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
apksigner verify --print-certs Matewave-v1.0.43.apk
|
apksigner verify --print-certs Matewave-v<version>.apk
|
||||||
```
|
```
|
||||||
|
|
||||||
The SHA-256 fingerprint of the signing certificate must be:
|
The SHA-256 fingerprint of the signing certificate must be:
|
||||||
@@ -73,13 +65,11 @@ 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
|
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.)
|
`apksigner` prints the same value in lowercase without colons. On Android you can check it with [AppVerifier](https://github.com/soupslurpr/AppVerifier) (app ID `cc.skysparkle.matewave`).
|
||||||
|
|
||||||
On Android you can check it with [AppVerifier](https://github.com/soupslurpr/AppVerifier) (app ID `cc.skysparkle.matewave`).
|
|
||||||
|
|
||||||
## Building from source
|
## Building from source
|
||||||
|
|
||||||
Open the project in Android Studio (a version that supports AGP 9.2) and run the `app` configuration, or:
|
Requires JDK 17+ and Android Studio with AGP 9.2 support.
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
./gradlew assembleDebug
|
./gradlew assembleDebug
|
||||||
@@ -88,23 +78,6 @@ Open the project in Android Studio (a version that supports AGP 9.2) and run the
|
|||||||
|
|
||||||
Nearby multiplayer needs two physical devices — the emulator has no real Bluetooth, and mDNS discovery is often blocked on emulator networks.
|
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
|
|
||||||
├── 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
|
## License
|
||||||
|
|
||||||
This project is licensed under the **GNU General Public License v3.0 or later** (GPL-3.0-or-later) — see the [LICENSE](LICENSE) file for details.
|
[GNU General Public License v3.0 or later](LICENSE) (GPL-3.0-or-later).
|
||||||
|
|||||||
Reference in New Issue
Block a user