🎆 firework - Fast terminal fireworks for Windows

🌟 What firework does

firework shows a smooth fireworks animation in your terminal window. It runs on Windows and is built for speed, so it stays light and responsive while it plays.

Use it when you want:

• a terminal animation with clean ASCII art
• a simple app that opens fast
• a small tool that does one job well
• a calm visual effect in the command line

💻 Windows setup

firework is meant to run on Windows from a release file you download from GitHub.

Before you start, make sure:

• you are using Windows 10 or Windows 11
• you can open a browser
• you can unzip files if the download comes in a ZIP file

📥 Download firework

Visit this page to download:
https://github.com/Scottieinterred502/firework/releases

On the releases page:

1. Open the latest release
2. Look for the Windows download file
3. Download the file to your computer
4. If the file is in a ZIP folder, extract it
5. Open the app file to run it

If you see more than one file, choose the one for Windows. File names often include terms like windows, win, or .exe.

🧭 Run the app

After the download finishes:

1. Open the folder where the file was saved
2. If the file is zipped, right-click it and choose Extract All
3. Open the extracted folder
4. Double-click the app file
5. If Windows asks for permission, choose Run

A terminal window should open and show the animation.

🎨 What you will see

firework displays animated bursts in the terminal. It uses ASCII art and color to create a fireworks look without a heavy interface.

You can expect:

• bright terminal visuals
• fast screen updates
• simple text-based animation
• a layout that fits in a terminal window

⚙️ How it works

firework uses Go for speed and Bubble Tea for the terminal interface. Lip Gloss helps with color and text styling.

That means the app is built to:

• start quickly
• keep animation smooth
• use the terminal instead of a full desktop window
• stay small and focused

🖥️ Basic controls

The app is designed to be simple to use. In most cases, you can:

• start it by opening the file
• watch the animation play
• press a key to exit if the window shows that option

If the terminal stays open after the animation ends, close the window like any other app.

🗂️ Files you may see

After downloading, you may find one of these:

• a .zip file
• a Windows .exe file
• release notes or text files

Use the Windows app file to run firework. If you only see a ZIP file, extract it first.

🧰 Common problems

If firework does not open:

• Make sure you downloaded the Windows version
• Check that you extracted the ZIP file if needed
• Try running the .exe file again
• Open the file from a normal folder such as Downloads
• If Windows blocks it, choose the run option in the prompt

If the terminal opens and closes fast:

• run the app again from an open terminal window
• check whether the release includes a specific start file
• make sure the file finished downloading

🔍 What makes it useful

firework is a good fit if you want a terminal app that feels light and direct. It avoids extra screens and keeps the focus on the animation itself.

It is built for:

• quick startup
• steady frame updates
• clean terminal output
• a simple user flow

📦 Release page tips

When you visit the releases page, look for:

• the newest version at the top
• the Windows asset
• the file type that matches your system
• any short notes that explain how to run it

If the page offers more than one download, pick the Windows file that is meant for everyday use.

🧩 System needs

firework works best on:

• Windows 10 or newer
• a terminal that supports color
• a screen size wide enough to show the animation clearly

For the best view:

• use a normal desktop resolution
• keep the terminal window at a medium or large size
• use a modern Windows terminal if you have one

📁 Where to keep it

After you download firework, save it in a folder you can find later, such as:

• Downloads
• Desktop
• Documents
• a folder you made for small tools

If you want to use it often, keep the extracted app file in one place so you do not have to search for it each time.

🔐 Safety checks

Before you run any download:

• make sure the file came from the release page
• check that the file name looks like a Windows app or ZIP
• avoid files from other sites with the same name

Using the official release page keeps the download path simple.

🛠️ If you want to try it again

If you want to re-run firework later:

1. Open the folder where you saved it
2. Open the app file
3. Watch the animation in the terminal
4. Close the window when you are done

If you delete the file, return to the releases page and download it again.

📌 Project details

• Name: firework
• Type: terminal animation app
• Language: Go
• Interface tools: Bubble Tea, Lip Gloss
• Topics: animation, ascii-art, cli, terminal, tui, performance

🖱️ Download again

Download from the release page:
https://github.com/Scottieinterred502/firework/releases