Tenuki - Go elsewhere, to the terminal

Tenuki is a terminal-based OGS (Online-Go Server) client built with Go and the tview UI library. It lets you escape the browser and enjoy your correspondence games right from your favorite terminal.

Features

• List your active games
• Play and chat
• Watch top live games

Limitations

Tenuki is designed primarily for correspondence games. The following limitations apply (for now):

• No support for creating or accepting challenges
• No auto match functionality

Usage

Requirements

• A terminal that supports emoji rendering and a font with good Unicode coverage

• An OGS OAuth2 Application, with Authorization grant type set to Resource owner password-based

  

Run the app

Run from binary

Download the binary from Release that are built from automated GitHub Actions, decompress, and run from your terminal.

./tenuki -help
./tenuki

Run from source

Requires Go 1.18+ (Download and install). Clone the code, enter the directory and then:

go run . -help
go run .

Screenshots

Screenshots taken on macOS using iTerm2 with the Monaco font (size 14).

Play mode with default night board theme:

Play mode with oak board theme:

Home page showing your active games:

Watch page showing top live games:

Acknowledgments

This project is inspired by and a spiritual successor to termsuji, with OGS library decoupled to googs.