chess-meshtastic

KO | EN

gitlite — search

#javascript #typescript #llm #golang #go #android #rust #macos #java #windows #cli #vue #awesome-list #ios

chess-meshtastic

(★ 36)

Play a chess game over Meshtastic using a Web Serial or Bluetooth connection

chess-meshtastic Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Meshtastic Web Chess

Play a chess game over Meshtastic using Web Serial or Web Bluetooth. The UI runs
in the browser and exchanges moves directly between radios.

This project is mostly vibe coded.

[Play now](https://kb1jdx.com/chess-meshtastic/)

[Buy me a coffee](https://buymeacoffee.com/compuvin)

[![Meshtastic](https://img.shields.io/badge/mesh-meshtastic-0b8a5a?style=flat)](https://meshtastic.org)
[![Web Serial](https://img.shields.io/badge/web-serial-3367d6?style=flat)](https://developer.mozilla.org/en-US/docs/Web/API/Serial)
[![Web Bluetooth](https://img.shields.io/badge/web-bluetooth-5a67d8?style=flat)](https://developer.mozilla.org/en-US/docs/Web/API/Web_Bluetooth_API)
[![Status](https://img.shields.io/badge/status-experimental-f39c12?style=flat)](https://raw.githubusercontent.com/compuvin/chess-meshtastic/main/)

## Why it is fun
- Zero server. Pure radio-to-radio chess.
- Random handshake picks colors and a shared game ID.
- Move-count sync to detect stalls and recover missing moves.

## Features
- Web Serial and Web Bluetooth connections
- Lobby channel with matchmaking and direct connect fallback
- Random handshake to pick colors and a shared game ID
- Move-count sync and reconnect checks
- Single-page app with modular game views (loaded at runtime)

## Requirements
- A browser with Web Serial or Web Bluetooth support (Chromium-based)
- Two Meshtastic radios on the same mesh
- Recommended: add the `GameLobby` channel before playing

## Quick start
1. Serve the folder with any static file server.
2. Open `index.html` in your browser, or play it at https://kb1jdx.com/chess-meshtastic/.
3. Click **Connect Serial** or **Connect Bluetooth** to pair with your radio.
4. Use the lobby to invite or direct connect to an opponent.
5. Wait for the handshake to assign colors, then play.

## Usage
- After connecting, the app performs a handshake to pick colors and start a game.
- Moves are transmitted over the mesh.
- If a move is missing, the app uses move counts to retry and resync.

## Files
- `index.html`: Lobby, connection, and game loader
- `games/chess.html`: Chess UI fragment (loaded into the page)
- `games/chess.js`: Chess UI logic (board, moves, status)
- `games/`: Game view fragments and modules
- `lobby.css`: App styling
- `meshtastic-chess.js`: Serial framing + Meshtastic protobuf handling
- `meshtastic_bundle.json`: Protobuf schema bundle
- `vendor/protobuf.min.js`: Protobuf runtime
- `js/meshtastic.bundle.js`: @meshtastic/js bundle (BLE)
- `js/meshtastic.js`: bundle loader
- `img/GameLobby.png`: QR code for the lobby channel

## Notes
- The opponent node ID can be entered as `0x...`, `!...`, or decimal.
- If you need to reset a game, use **Reset Game**.
- This is a lightweight experimental project, not a full client.
- To add a new game, create `games/<name>.html` (UI fragment) and `games/<name>.js` (UI logic), then register it in the loader.
- Lobby channel details:
  - Name: `GameLobby`
  - PSK: `OpLah30Ci9oMvUDbXRGVcw3C55TOgUpQ23fxnYPpq2I=`
  - Recommended to add it before playing for smooth matchmaking.
  - QR code: `img/GameLobby.png`
- Licensing: the app uses the original third-party sources by default.
  If you want offline copies, download these into `lib/`:
  - https://code.jquery.com/jquery-1.12.4.min.js
  - https://cdnjs.cloudflare.com/ajax/libs/chess.js/0.10.3/chess.min.js
  - https://cdnjs.cloudflare.com/ajax/libs/chessboard-js/1.0.0/chessboard-1.0.0.min.js
  - https://cdnjs.cloudflare.com/ajax/libs/chessboard-js/1.0.0/chessboard-1.0.0.min.css

## Troubleshooting
- If the handshake never completes, confirm both radios are on the same channel
  and the opponent node ID is correct.
- If moves do not transmit, reconnect and try again to re-run the handshake.
- If you see "Connection lost. Retrying...", the app is re-syncing move counts.

## Acknowledgements
- Meshtastic team and community
- Chessboard.js and Chess.js
- @meshtastic/js (GPLv3)

[![CodeFactor](https://www.codefactor.io/repository/github/compuvin/chess-meshtastic/badge?s=86272db5d82ae02637bf412de630592c0d49cdbb)](https://www.codefactor.io/repository/github/compuvin/chess-meshtastic)

chess-meshtastic

chess-meshtastic Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

chess-meshtastic

chess-meshtastic Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README