Play real-time multiplayer Chess and Tic-Tac-Toe, or challenge yourself with Snake straight from your terminal. No installs, no accounts needed. Just SSH and play.
- Three Games: Switch between Chess, Tic-Tac-Toe, and Snake.
- Zero Install: It runs over SSH. If you have a terminal, you can play.
- Instant Multiplayer: Create a room, get a 4-letter code, and share it.
- Single-Player Snake: Pick a difficulty and chase your high score.
- Spectator Mode: Watch live games by joining a full room.
- Slick TUI: A responsive, colorful terminal interface built with Bubble Tea.
- Cross-Platform State: Game state lives in Firebase, so you can reconnect if your wifi drops.
Timeline.1.mov
The public server is coming soon! Once live, you'll be able to jump in with:
ssh termplay.me
Want to host your own server? Here's how.
You'll need a Firebase project (Realtime Database).
- Go to Project Settings > Service Accounts in Firebase Console.
- Generate a Private Key and save it as
serviceAccount.json. - Grab your Database URL from the Realtime Database section.
- Clone the repo and drop your
serviceAccount.jsonin the root folder. - Create a
.envfile:FIREBASE_DB_URL=https://YOUR-PROJECT-ID-default-rtdb.firebaseio.com GOOGLE_APPLICATION_CREDENTIALS=./serviceAccount.json
- Run it:
make run
- Connect in a new tab:
ssh -p 2324 localhost
docker run -d -p 2324:2324 \
-e FIREBASE_DB_URL="https://YOUR-DB-URL.firebaseio.com" \
-e GOOGLE_APPLICATION_CREDENTIALS="/app/serviceAccount.json" \
-v "$(pwd)/serviceAccount.json:/app/serviceAccount.json" \
ghcr.io/aminshahid573/termplay:latest
Built with Go, Bubble Tea, and Wish by Charmbracelet.
