paputok

Filipino terminal fireworks - kwitis, watusi, luces, at iba pa!

A terminal animation CLI celebrating Filipino New Year traditions with ASCII art fireworks and a special tribute to Manny Pacquiao.

Installation

# Run directly with bunx
bunx paputok

# Or install globally
bun install -g paputok

Usage

# Play default animation (manny) 20 times
paputok

# Play specific animation
paputok kwitis
paputok apoy
paputok manny

# Set number of loops
paputok kwitis 5

# Loop infinitely (Ctrl+C to stop)
paputok apoy -1

# Play random animation
paputok --random
paputok --random 10

Animations

| Name | Description | |------|-------------| | manny | Manny Pacquiao with fireworks (default) | | kwitis | Classic Filipino skyrocket fireworks | | apoy | Fire/flame animation |

Requirements

• Bun runtime
• Terminal with ANSI color support (256-color and true color)

Development

# Clone the repo
git clone https://github.com/pataputok/paputok.git
cd paputok

# Install dependencies
bun install

# Run in development mode
bun run dev

# Run directly
bun run start

Acknowledgments

Forked from firew0rks by Addy Osmani.

License

MIT