Punkdoku

개요

punkdoku 는 macOS, Linux에서 즐기는 터미널 스도쿠 게임입니다. Go로 작성되었고 Bubble Tea와 Lipgloss로 보기 좋은 TUI를 제공합니다. 퍼즐은 난이도별로 생성되며, 4개의 난이도 모드는 밀리초 기반 시드를 사용해 퍼즐을 생성하고, Daily 모드는 UTC 날짜 기반 시드를 사용해 모든 사용자가 동일한 퍼즐을 받습니다. 입력 애니메이션, Undo, Auto‑Check, 타이머 등을 지원합니다.

Overview

punkdoku is a terminal Sudoku game that runs identically on macOS and Linux. It is written in Go and provides a visually appealing TUI built with Bubble Tea and Lipgloss. Puzzles are generated per difficulty level: the four difficulty modes use a millisecond-based seed to create unique puzzles, while Daily mode uses a UTC date-based seed so that all players receive the same puzzle. The game supports input animations, undo, auto-check, and a timer.

Quick Start

Option 1: 🍺 Homebrew (Recommended)

# Download
brew install daypunk/tap/punkdoku

# Run 🧩
punkdoku

Option 2: Manual Download

macOS

# Download
curl -L -o punkdoku https://github.com/daypunk/punkdoku/releases/latest/download/punkdoku-macos-$(uname -m | sed 's/x86_64/amd64/')

# Make it executable
chmod +x punkdoku

# Move to your PATH
sudo mv punkdoku /usr/local/bin/

# Run 🧩
punkdoku

Linux

# Download
curl -L -o punkdoku https://github.com/daypunk/punkdoku/releases/latest/download/punkdoku-linux

# Make it executable
chmod +x punkdoku

# Move to your PATH
sudo mv punkdoku /usr/local/bin/

# Run 🧩
punkdoku

How to Play

Run punkdoku in your terminal and use:

• Arrow keys to navigate
• 1-9 to place numbers
• 0 or Space to clear cells
• u to undo
• a to toggle auto-check
• t to toggle timer
• m to return to menu
• q to quit

Game Modes

• 🍼 Easy - Good for beginners
• 🌞 Normal - Balanced challenge
• 🌚 Hard - Requires strategy
• 🥀 Lunatic - Expert level
• 🌞 Daily(=Normal) - Same puzzle for everyone, changes daily

Features

• Cute! minimalist interface
• Daily puzzles with shared seeds
• Smart puzzle generation (unique solutions only)
• Undo/redo functionality
• Real-time error checking
• Built-in timer
• No external dependencies

Development

# Run locally
go run ./cmd/punkdoku

# Build binary
go build -o punkdoku ./cmd/punkdoku

Requires Go 1.23+ and works best with terminals that support Unicode and true color.

License

MIT License - feel free to use and modify as needed.