From 8eb8961e5076778585920b42866dc3d7e03e40c6 Mon Sep 17 00:00:00 2001 From: Unbewohnte Date: Fri, 3 Dec 2021 23:47:33 +0300 Subject: [PATCH] README --- README.md | 75 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..f788894 --- /dev/null +++ b/README.md @@ -0,0 +1,75 @@ +# fumosay +## Like cowsay, but with soft friends (ᗜˬᗜ) +``` + __ __ <⑨ There are no buses in Gensokyo ⑨> + | \ / | () + | \____/ | () + |__// V \\__| + /|| ᗜ ᗜ || \ + \_\\_︶_//_/ + jj⑨lll + ()_/@V@V@V\_() + /@V@V@V@V\ + (_)-----(_) +``` +--- + +# Installation + +## "Compile it yourself" way +clone this repository +- `git clone https://github.com/Unbewohnte/fumosay` + +cd into cloned repo +- `cd fumosay/` + +compile +- `make` or `g++ -static -O2 src/fumosay.cpp -o fumosay` + + +**or** + +## "Download a pre-compiled version (Linux amd64 only)" way +- [Download a version of your choice](https://github.com/Unbewohnte/fumosay/releases) + +unzip +- `unzip [zip_archive_name]` + +cd into unzipped directory +- `cd fumosay/` + +## After compilation|downloading + +run installation script +- `chmod +x install.sh && sudo ./install.sh` or `sudo make install` + +**Now you have fumosay installed !** + +--- + +# Use +``` +fumosay message_here +``` +prints a message with a default fumo.fumo template + +``` +fumosay -f mini.fumo message_here +``` +prints a message with a mini.fumo template. You can add your own fumofiles +in /usr/local/share/fumosay/fumofiles/ and use them with -f flag + +``` +fumosay -d path/to/your/fumofiles/ -f your_fumo.fumo fumofumo +``` +uses a non-default path to fumofiles and a custom fumofile + +--- + +# TODO list + +- Add more fumos +- ~~Make it possible to use other fumos~~ +- Improve message {box|bubble} +- ~~Embed fumofiles or take care of ways of locating them~~ +- ~~Make an `install.sh` script~~