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.

telereads's Issues

Mismatched links

In some cases the message link + preview point to a different book than the one selected from the dropdown list. Example:

This happens because the Goodreads book links guidelines are ambiguous. One possible solution is to create link based on title + author, but this might cause other problems.

unwrap() panic

Sometimes the bot crashes when trying to unwrap() an Option<T>::None. The stack trace didn't provide any insight towards finding the cause/location of this.

No response

Is this still active?