Flappy Bird

A Flappy Bird clone built with Python and Pygame. Play on desktop or in your browser!

Play Online

Play directly in your browser: Play on itch.io

How to Run (Desktop)

# Install dependencies
pip install -r requirements.txt

# Run the game
python main.py

How to Build for Web

# Install pygbag
pip install pygbag

# Build web version
pygbag --build main.py

# The build will be in build/web/

Controls

• Space / Up Arrow / Click / Tap - Flap wings
• Escape - Back to menu (in settings)

Features

• Simple one-button gameplay
• Endless mode with high score tracking
• Customizable settings:
  • Bird colors: Blue, Red, Yellow, Pink, Ribbon
  • Backgrounds: Day, Night
  • Pipe colors: Green, Red
• Works on desktop and mobile browsers
• Secure score storage (tamper-resistant)

Project Structure

flappy-bird/
├── main.py              # Entry point (web + desktop)
├── flappy.py            # Alternative entry point
├── assets/
│   ├── sprites/         # Game graphics
│   └── audio/           # Sound effects
└── src/
    ├── game.py          # Main game controller
    ├── constants.py     # Game settings
    ├── entities/        # Bird, Pipe, Ground
    ├── states/          # Game states (Menu, Playing, etc.)
    ├── managers/        # Settings, Audio
    └── ui/              # Buttons, Score display

Disclaimer

This project is created for personal learning and educational purposes only.

• The original Flappy Bird game was created by Dong Nguyen / .GEARS Studios
• Some game assets (sprites and audio) are from flappy-bird-assets and belong to their original creators
• Additional assets were created by me
• This project is not affiliated with or endorsed by the original creators
• Not for commercial use