summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTyler Murphy <tylerm@tylerm.dev>2023-04-26 20:17:32 -0400
committerTyler Murphy <tylerm@tylerm.dev>2023-04-26 20:17:32 -0400
commit24160bdfff424c277cdfd3c2cd36e3674f404b8c (patch)
tree78622b2b10030022f94f64d5a7fb2ec6022f7244
parentinitial (diff)
downloadritfetch-24160bdfff424c277cdfd3c2cd36e3674f404b8c.tar.gz
ritfetch-24160bdfff424c277cdfd3c2cd36e3674f404b8c.tar.bz2
ritfetch-24160bdfff424c277cdfd3c2cd36e3674f404b8c.zip
make readmeHEADmain
-rw-r--r--readme.md43
1 files changed, 43 insertions, 0 deletions
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..91c229a
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,43 @@
+
+# ritfetch
+
+A fetch command that can get club information
+
+## How to
+
+`usage: ritfetch domain`
+
+ritfetch needs a `domain` to get data from its `.well-known/ritfetch` directory.
+
+### Setting up a domain
+
+To setup a domain for ritfetch create two files in `.well-known/ritfetch`
+
+#### logo
+
+Make a file called `logo` that is just ascii a image. This is to be printed just like your linux distro icon on a linux system. Also the file needs to have its anscii escape code within it such that when you curl the file, what is printed is what you will see.
+
+#### data
+
+Make a file called `data` that contains the colors, spacing, and data for the fetch. The first line is a number containing the offset which the data will be shown from the logo. The 2nd two numbers are the anscii escape code colors (without the [ and the m) for the accent highlight color and normal text color. Finally the rest of the lines will just be a line for the key and then a line for the value, for all the content shown in the fetch.
+
+## License
+
+This project is Licensed under the [GPLv3](https://www.gnu.org/licenses/gpl-3.0.en.html)
+
+## Compilation
+
+ritfetch only runs on systems with `curl` installed
+
+Make sure to have `gcc` and `make` installed, and then run
+
+```shell
+$ make # compiles the program
+$ sudo make install # installs the binary
+```
+
+If you wish to remove the program, you can run
+
+```shell
+$ sudo make uninstall # removes the binary
+```