From 655e487deb427c5b46e47aab50b761be78a1eb90 Mon Sep 17 00:00:00 2001 From: Santo Cariotti Date: Wed, 11 Aug 2021 11:10:16 +0200 Subject: docs: create readme file --- README.md | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 README.md 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:` you have to run (in parallel) +``` +geckodriver --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`. -- cgit v1.2.3-18-g5258