From 3210c4d5ec638f34a7085dc7806acb5bd88f9f71 Mon Sep 17 00:00:00 2001 From: Kied Llaentenn <32681240+Kiedtl@users.noreply.github.com> Date: Fri, 13 Dec 2019 09:47:49 -0500 Subject: [PATCH] add README --- README.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..62ca0a5 --- /dev/null +++ b/README.md @@ -0,0 +1,59 @@ +# fire + +> The ancient DOOM fire animation in the terminal! + +### what? +`fire` is a remake of the PSX DOOM fire animation in the terminal, +as seen in the [ly](https://github.com/cylgom/ly) display manager. +It's described nicely by Fabien Sanglard on his +[blog](https://fabiensanglard.net/doom_fire_psx/index.html). + +### where? +#### supported platforms +- Linux (musl/glibc) (*tested and supported*) +- Windows (*should work, but not tested*) +- (Dragonfly|Net|Free|Open)BSD: (*not tested, might work*) + +#### building from source +You will need: +- `git` +- a c99 compiler (gcc or clang) +- GNU Make (unknown if other `make`s will work) + +Clone the source via `git`: +``` +$ git --recurse clone https://github.com/lptstr/fire +``` + +Build: +``` +$ make +``` + +and install: +``` +# make install +``` + +Uninstall, if you wish: +``` +# rm -f /usr/bin/fire +``` + +### how? +simply run `./fire` (or `fire`, if you installed) and enjoy. +``` +$ fire +``` + +### why? +I'm bored + +### credits +Thanks to @cylgom, for inspiring me to make this project. +More thanks to @cylgom, from whose repositories I sto^Hborrowed a lot +of stuff :) + +### license +This project is licensed under the MIT license. View the LICENSE.md file +for more information.