Telereads = Telegram + Goodreads

@TelereadsBot is an inline bot that allows you to search for books and quickly share them in a conversation.

Demo

Search by book title

Search by ISBN

Deploy your own

You can deploy your own instance of this bot. You will need a few things:

A Telegram bot token. Contact @BotFather in order to create a new bot and receive a token.
A Goodreads API key. Apply for one here.
A working installation of Rust.

Once you have both of these keys, you need to store them as environment variables:

$ export TELEGRAM_TOKEN="123456789:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
$ export GOODREADS_TOKEN="XXXXXXXXXXXXXXXXXXXX"

And then install and run TelereadsBot:

From GitHub

$ git clone https://github.com/harababurel/telereads.git
$ cd telereads
$ RUST_LOG=info cargo run --release

Aditionally, this repo includes a systemd service file (telereads.service) which can be used to deploy the bot. After setting the proper variables in the service file:

$ systemctl start telereads

From crates.io

$ cargo install telereads
$ RUST_LOG=info telereads

Contributing