Skip to content

Latest commit

 

History

History
54 lines (35 loc) · 1.93 KB

README.md

File metadata and controls

54 lines (35 loc) · 1.93 KB
Raw

Telereads = Telegram + Goodreads

Telegram MIT License

@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

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