tflap

A classic Flappy Bird game in your terminal 🐦

Play the addictive Flappy Bird game directly in your terminal with smooth animations, persistent high scores, and simple controls.

Features

• 🎮 Smooth terminal-based gameplay
• 🏆 Persistent high score tracking
• 🎨 Colorful ASCII graphics
• ⌨️ Simple keyboard controls
• 🚀 Cross-platform (macOS, Linux, Windows)
• 💾 Auto-save high scores to ~/.tflap_highscore

Installation

Using Cargo

cargo install tflap

Usage

Simply run the command to start playing:

tflap

Controls

• Space: Jump (during gameplay)
• R: Retry (after game over)
• Q / Esc: Quit the game
• Ctrl+C: Force quit

Gameplay

• Navigate the bird through the pipes by tapping Space to jump
• Avoid hitting the pipes or the ground
• Score points by passing through pipes
• Try to beat your high score!

How to Play

1. Press Space to make the bird jump
2. Avoid colliding with pipes or boundaries
3. Each pipe you pass increases your score by 1
4. When you set a new record, you'll see a special celebration screen!

Requirements

• Rust 1.70 or later
• A terminal with Unicode support

License

Licensed under either of MIT or Apache-2.0 at your option. See LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.