26 releases
0.2.9 | Nov 17, 2024 |
---|---|
0.2.8 | Jul 5, 2024 |
0.2.7 | Jun 2, 2024 |
0.2.6 | Feb 27, 2024 |
0.1.7 | Jul 30, 2021 |
#66 in Command line utilities
114 downloads per month
210KB
6K
SLoC
remindee-bot
Telegram bot for managing reminders.
Installation
- Setup your bot with @botfather.
Method 1: Rust's package manager
-
Install Rust.
-
Install the crate and start the bot:
cargo install remindee-bot remindee-bot --token <BOT TOKEN> --database <FILE>
Instead of flags you can use environment variables to specify the token and the database location:
export BOT_TOKEN=<BOT TOKEN> export REMINDEE_DB=<FILE> # default is to store in the user's data directory remindee-bot
Method 2: release archive
-
Download the archive for your system architecture from the latest release page.
-
Unpack the archive:
- for Linux, you can run
tar xf remindee-bot-<version>-<architecture>.tar.gz
; - for macOS, you can use the default zip extractor or run
unzip remindee-bot-<version>-<architecture>.zip
; - for Windows, you can use the default zip extractor.
- for Linux, you can run
-
Navigate to the directory and start the bot:
cd remindee-bot-<version>-<architecture> ./remindee-bot --token <BOT TOKEN> --database <FILE>
Method 3: Docker container
-
Build the image from this repository:
docker build --tag remindee-bot 'https://github.com/magnickolas/remindee-bot.git#master'
-
Initialize and run a container from the built image:
docker run -d -v <LOCAL DATABASE DIRECTORY>:/data -e BOT_TOKEN=<BOT TOKEN> remindee-bot
See Docker's documentation for more.
Method 4: from source
-
Install Rust.
-
Clone the repository with Git:
git clone https://github.com/magnickolas/remindee-bot
-
Build the crate and start the bot:
cargo install --path remindee-bot remindee-bot --token <BOT TOKEN> --database <FILE>
Using bot
Send /start
command to the bot and follow its instructions 🤖.
Setting reminders
The formats descriptions with examples can be viewed at readthedocs or docs/index.rst.
You may also find it useful to refer to the pest grammar playground to try out some reminders and see how they are parsed (select reminder
at the bottom of the list of choices next to the second code block and play with it).
Dependencies
~86MB
~1.5M SLoC