ledblast 1.0.0

LED BLASTER — terminal colour-shooter game

LED BLASTER

A fast-paced terminal colour-shooter. Orbs fall down the strip — shoot the matching colour beam to destroy them before they reach the bottom.

pip install ledblast
ledblast

Controls

Key	Action
R	Fire RED beam
G	Fire GREEN beam
B	Fire BLUE beam
Y	Fire YELLOW beam (unlocks at level 4)
M	Fire MAGENTA beam (unlocks at level 7)
C	Fire CYAN beam (unlocks at level 10)
P	Pause / unpause
Q	Quit

How to play

• Orbs (●) fall down the strip in one of up to 6 colours
• Press the matching colour key to fire a beam (▲) upward
• Hit an orb with the same colour → destroy it, score points
• Hit an orb with the wrong colour → lose a life
• Miss an orb (it reaches the bottom) → lose a life
• You have 3 lives — don't waste them
• Build combos by hitting orbs back-to-back for bonus points

Difficulty

Select before starting with 1 / 2 / 3:

• Easy — slower orbs, generous spawn rate
• Normal — default balance
• Hard — fast orbs, rapid spawns

Progression

• Levels up every 6 points — orbs get faster and spawn quicker
• New colour lanes unlock at levels 4, 7, and 10
• Your best score is saved between sessions (~/.ledblast_best)

Requirements

• Python 3.8+
• A terminal with colour and Unicode support
• On Windows: use Windows Terminal for best results (windows-curses is installed automatically)

Install from source

git clone https://github.com/tombribowei01/ledblast
cd ledblast
pip install -e .
ledblast