Fire >_

Terminal fire animation written in Rust.

---

Language

Russian  ·  English

---

Overview

Fire CLI is a small terminal utility written in Rust. It renders a fire animation directly in the terminal using ANSI escape sequences and direct buffer writes. No heavy dependencies, no bloat. Runs fine on weak hardware.

Works on Linux, macOS, Windows, and BSD — anywhere Rust and libc are available. No GUI, no runtime — just standard output.

---

Features

Feature	Description
Customization	Control over burn speed and flame intensity.
Themes	A set of preset color palettes. Blue fire, classic fire, and others.
Monochrome mode	ASCII output without color for legacy setups.
Performance	Low resource usage. Rust does its job.

Note on color: The animation uses ANSI escape sequences. For a proper gradient, your terminal needs 24-bit TrueColor support.

---

Terminal Compatibility

On older Windows systems, cmd.exe and PowerShell.exe tend to break:

• Garbage control characters like <-[0K appear on screen.
• Frame tearing due to slow stream processing.
• No TrueColor support.

Use a terminal that handles VT sequences properly:

• Recommended: Windows Terminal, Alacritty, WezTerm
• Also fine: Kitty, Foot, Konsole, or any other emulator with 24-bit color.

If you see <-[0K or stuttering, your terminal is the problem.

---

Installation

Requires an up-to-date Rust toolchain (cargo, rustc).

Via Cargo (recommended)

cargo install fire-cli-rs

Cargo handles compilation for your platform automatically.

---

Build from Source

# Clone the repository
git clone https://github.com/horizonwiki/fire
cd fire

# Build the release binary
cargo build --release

The binary will be at target/release/fire-cli after the build.

Install System-Wide

Linux & macOS

sudo cp target/release/fire-cli /usr/local/bin/

Windows

1. Create a folder for your binaries, e.g. C:\bin, and move fire-cli.exe there from target\release\.
2. Open sysdm.cpl > Advanced > Environment Variables.
3. Edit the Path variable under your user and add the folder path.
4. Restart your terminal.

---

Pre-built Binaries

Download from the Releases page if you don't want to compile.

• Windows: Download fire-cli.exe, place it somewhere on your PATH.
• Linux/macOS: Download fire-cli, run chmod +x fire-cli, move to /usr/local/bin/.

Arch Linux (AUR)

yay -S fire-cli

Any AUR helper works.

---

Usage

fire-cli

Flags

Flag	Full Name	Description	Values
-f	--fps	Frame rate	15–120 (default: 30)
-t	--theme	Color theme	—
-n-c	--no-color	Disable colors, ASCII mode	—
-h	--help	Show help	—
-v	--version	Show version	—

Themes

Usage: -t or --theme [name]

Theme	Preview	Description
ash		Monochrome smoke and gray fire
aurora		Green-teal northern lights
blue		Blue neon fire
classic		Alternative classic fire
copper		Turquoise copper-oxide flame
crimson		Aggressive crimson-red fire
dusk		Warm orange-purple sunset fire
ember		Glowing amber coals
emerald		Deep emerald chemical fire
forest		Mystical green fire
frost		Cold blue-white icy fire
ghost		Ethereal violet magic flame
gold		Metallic golden shimmer
ice		Ice fire
magma		Molten lava glow
nebula		Cosmic pink and blue fire
pink		Pink neon fire
plasma		Electric indigo plasma
rainbow		Multicolor spectrum fire
sakura		Soft pink cherry blossom fire
solar		White-hot solar flares
std		Classic fire
sulfur		Ghostly blue flame
custom	—	User-defined theme

Custom theme format:

custom:#hex.#hex.#hex.#hex

Provide 1 to 4 hex colors separated by dots.

Examples

fire-cli -f 60
fire-cli --theme copper --fps 45
fire-cli -t custom:#ff0055.#ffcc00.#ffffff

Keybinds

• ESC or Ctrl+C — Exit.

---

Contributing

• Open an issue and label it if you can.
• If you have a fix or a change worth merging, open a pull request.

---

Screenshots

---

Maintainers

• Horizon — horizondebug@gmail.com

---

License

Apache License 2.0. View License