Fork of https://github.com/const-void/DOOM-fire-zig

DOOMFIRE#

Test your TTY's might!#

The doom-fire algo can push upwards of 180k a frame - results may vary! It is, to my surprise, a nice TTY stress test.

As a comparison, this is the younger sibling of a node variant ( https://github.com/const-void/DOOM-fire-node ).

INSTALL#

$ git clone https://tangled.org/m17e.co/doom
$ cd doom
$ zig build run -Doptimize=ReleaseFast
...

Build Requirements:

• all platforms - libc
• all platforms - x64 (for now)
• windows - kernel32

This fork only tests on Linux amd64 and arm64 and MacOS arm64 (Apple Silicon).

Results#

Start your favorite terminal, maximize it, then launch DOOM-fire-zig! Test your terminal's might.

Definitions#

<=   5 avg fps = very poor
<=  24 avg fps = poor
   ... avg fps = ok
>= 100 avg fps = great

MacOS / Apple Note#

The default MacOS / Apple terminal reports an avg 30-40 fps, however visually, it appears to be drop frames, resulting in a very choppy effect.

Results are for fun#

As our approach is unscientific, we only indicate avg fps for underpeformers, to set expectations; results will vary based on - os+platform, GPU, terminal size (function of font size, monitor resolution, zoom %, etc), specific terminal configuration, terminal version -- even zig itself is a factor.

We don't test every terminal with each merge request; the majority come from the community. One report is enough! This is for fun, to encourage terminals to be great out-of-the-box, and us to learn - to explore what our terminals can do, and share configuration that gives fps a boost (at potential cost elsewhere...).

180kb a frame at 100+fps is...great!!! Amazing.

Inspiration / Credits#

• Thanks to contributors for your support!

• doom fire - algorithm, flames

• color layout

• ansi codes

• str, zig

• emit

• term sz, zig

• osx term sz

• px char

Repo Guidance#

This fork will attempt to stay up to date with the latest master branch Zig releases. This fork will not generate releases.

License#

Copyright 2022-2025, const-void, released under GPL3.

DOOM-fire-zig is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.