diff options
author | Santo Cariotti <santo@dcariotti.me> | 2021-08-11 11:10:16 +0200 |
---|---|---|
committer | Santo Cariotti <santo@dcariotti.me> | 2021-08-11 11:10:47 +0200 |
commit | 655e487deb427c5b46e47aab50b761be78a1eb90 (patch) | |
tree | d1de9d36d6cc2201a6e588c61d4a4f13cfb4031f | |
parent | 7de7e53436df4f5abf131870a1f02f2d91379bf3 (diff) |
docs: create readme file
-rw-r--r-- | README.md | 38 |
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`. |