Smart Game Viewer

A beautiful terminal-based viewer for SGF (Smart Game Format) files, designed for watching professional Go games.

Features

• Parse and display SGF (Smart Game Format) files
• Navigate through game moves with keyboard controls
• Auto-play mode for watching games
• Display game information (players, move coordinates)
• Support for 9x9, 13x13, and 19x19 boards
• Clean Unicode-based board rendering with stones on intersections
• Example games included (AlphaGo vs Lee Sedol)

Usage

# Run with an SGF file
cargo run -- examples/AlphaGo_LeeSedol_game4.sgf

# Or after building
./target/release/smartgameviewer examples/AlphaGo_LeeSedol_game4.sgf

Controls

• ← / →: Step backward/forward through moves
• Home: Jump to start of game
• End: Jump to end of game
• Space: Toggle auto-play (automatically advance moves)
• Q / Esc: Quit

Development

This project uses devenv for development environment management.

Recommended Setup

# Install devenv (if not already installed)
# See https://devenv.sh/getting-started/

# All cargo commands should be run through devenv shell:
devenv shell cargo build
devenv shell cargo test
devenv shell cargo run -- examples/AlphaGo_LeeSedol_game4.sgf

Common Development Commands

# Run with example
devenv shell cargo run -- examples/AlphaGo_LeeSedol_game4.sgf

# Run tests
devenv shell cargo test

# Format code
devenv shell cargo fmt

# Run linter
devenv shell cargo clippy

# Build release version
devenv shell cargo build --release

Note: Using devenv shell ensures you have the correct Rust toolchain and all dependencies available.

Roadmap

• Polish: Colors, gradients, shine effects
• Sound: Stone placement sounds
• GUI version (Tauri/egui)
• Web version
• AI engine integration

License

MIT

Author

ApisMellow