aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorFuwn <[email protected]>2024-06-24 06:19:59 -0700
committerFuwn <[email protected]>2024-06-24 06:21:15 -0700
commitac57eed9c88ef24e73068287ec0f4988eb234909 (patch)
tree8f0770ec223508843bd3aab404fc8fde0ee14f39 /README.md
downloadgigi-ac57eed9c88ef24e73068287ec0f4988eb234909.tar.xz
gigi-ac57eed9c88ef24e73068287ec0f4988eb234909.zip
feat: initial release
Diffstat (limited to 'README.md')
-rw-r--r--README.md37
1 files changed, 37 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..757155a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+# 👧️ Gigi
+
+> A Finger protocol server for risk takers
+
+Gigi is a Finger protocol server with few features.
+
+- Gigi can respond to Finger requests statically
+- Gigi can respond to Finger requests dynamically
+
+## Usage
+
+### Local
+
+```bash
+$ git clone [email protected]:Fuwn/gigi.git
+$ cd gigi
+$ tup
+```
+
+### Configuration
+
+Gigi is configured through the `./gigi` directory.
+
+Dynamic response mode is disabled by default in [`gigi.c`](./gigi.c)
+because it is very unsafe. If you wish to live on the edge, uncomment the
+`GIGI_DYNAMIC` macro.
+
+Dynamic mode runs any and all executables located at the path `./gigi/do`, and
+passes any arguments from the Finger request to the executable.
+
+Static mode is enabled by default. A Finger request for `test` will return the
+contents of `./gigi/test`. A Finger request of nothing will return the contents
+of `./gigi/default`.
+
+## Licence
+
+This project is licensed with the [GNU General Public License v3.0](./LICENSE).