A terminal-based morse code practice game built with Deno. Improve your morse code translation skills through interactive gameplay with multiple difficulty levels and comprehensive statistics tracking.

Features

Multiple Difficulty Modes
- 🟢 Easy: Single letters (A-Z)
- 🟡 Medium: Single numbers (0-9)
- 🟣 Hard: Common words
- 🔴 Expert: Short phrases
Interactive TUI Interface
- Beautiful terminal UI with colors and tables
- Real-time timer for each round
- Immediate feedback on answers
- Progress tracking with streak counter
Statistics Tracking
- Overall accuracy and performance metrics
- Mode-specific statistics
- Best streak tracking
- Historical game data
- Average time per round
Flexible CLI
- Interactive menu mode (default)
- Quick play mode with command-line arguments
- Stats viewer
- Built-in morse code reference

Installation

Make sure you have Deno installed.

# Clone or download this repository
cd morse-game

# Make the script executable (optional)
chmod +x main.ts

Usage

Interactive Mode (Default)

Run the game and navigate through the menu:

deno task start
# or
deno run --allow-read --allow-write --allow-env main.ts

Quick Play Mode

Start a game directly with custom settings:

# Play 5 rounds of letters mode with 20 seconds per round
deno task start play --mode letters --rounds 5 --time 20

# Play expert mode
deno task start play --mode phrases --rounds 10 --time 45

Options:

-m, --mode <mode> - Game mode: letters, numbers, words, or phrases (default: letters)
-r, --rounds <number> - Number of rounds (default: 10)
-t, --time <seconds> - Seconds per round (default: 30)

View Statistics

deno task start stats

Show Reference

Display a morse code reference chart:

deno task start reference

Reset Statistics

deno task start reset

How to Play

Select a difficulty mode - Choose from letters, numbers, words, or phrases
Configure your game - Set the number of rounds and time per round
Translate to morse code - You'll be shown a challenge (letter, number, word, or phrase)
Enter your answer - Type the morse code using:
- . (dot) for short signals
- - (dash) for long signals
- Space to separate letters
- / to separate words
Get instant feedback - See if you got it right and track your streak
Review your performance - After all rounds, view detailed statistics

Morse Code Basics

Use . for dots and - for dashes
Separate letters with spaces
Use / for word boundaries
Example: HELLO = .... . .-.. .-.. ---
Example: SOS = ... --- ...

Statistics

The game tracks:

Total games played
Total rounds completed
Correct and incorrect answers
Overall accuracy percentage
Average time per round
Best streak (consecutive correct answers)
Per-mode statistics

Stats are saved to ~/.morse-game/stats.json

Development

# Run in watch mode for development
deno task dev

# Run with specific permissions
deno run --allow-read --allow-write --allow-env main.ts

Project Structure

morse-game/
├── main.ts          # CLI entry point and command parser
├── game.ts          # Game logic and session management
├── morse.ts         # Morse code translation utilities
├── stats.ts         # Statistics tracking and persistence
├── ui.ts            # TUI interface and menus
├── deno.json        # Deno configuration and dependencies
└── README.md        # This file

Dependencies

@cliffy/command - CLI framework
@cliffy/prompt - Interactive prompts
@cliffy/ansi - ANSI colors and formatting
@cliffy/table - Table rendering
@std/path - Path utilities
@std/fs - File system utilities

License

MIT

Contributing

Feel free to open issues or submit pull requests!

73 (Best regards in morse code) 📡