harababurel / telereads

Find books on Goodreads and share them quickly in Telegram chats.

Telereads = Telegram + Goodreads

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

Demo

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

Contributions are welcome. You can also help by reporting or fixing bugs.