summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSanto Cariotti <santo@dcariotti.me>2021-08-11 11:10:16 +0200
committerSanto Cariotti <santo@dcariotti.me>2021-08-11 11:10:47 +0200
commit655e487deb427c5b46e47aab50b761be78a1eb90 (patch)
treed1de9d36d6cc2201a6e588c61d4a4f13cfb4031f
parent7de7e53436df4f5abf131870a1f02f2d91379bf3 (diff)
docs: create readme file
-rw-r--r--README.md38
1 files changed, 38 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8e077e7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,38 @@
+# Unict reservation Telegram bot
+
+This _UNDER DEVELOPMENT_ project is used for the students of University of
+Catania to book a space for study into the campus.
+
+With this self-hosted bot you can use your Telegram app to reserve a seat into
+your favority study room/library.
+
+## Setup
+Clone this repository into your VM
+```
+git clone https://github.com/dcariotti/unict-reservation
+```
+
+Setup the `.env` file or environment
+```
+cf=
+password=
+driver_url=
+username=
+TELOXIDE_TOKEN=
+```
+
+Where `cf` is the username of Smartedu, `password` is the password of that
+account, `driver_url` is the location where geckodriver is running, `username` is
+your Telegram username and `TELOXIDE_TOKEN` is the Telegram bot API token.
+
+This bot uses [geckodriver](https://github.com/mozilla/geckodriver/releases) to
+create an instance of browser.
+If you want to run a geckodriver instance in your local machine and use that (so
+the `driver_url=http://localhost:<port>` you have to run (in parallel)
+```
+geckodriver --port=<port>
+```
+
+## Run
+Now you can create the build of the project (`cargo build` and then execute the
+binary file) or just run the software with `cargo run`.