telme/README.md

56 lines
1.9 KiB
Markdown
Raw Normal View History

2020-03-19 18:51:24 +00:00
# **telme**
#### CLI inline telegram bot notifications
## TL;DR
1. Get a bot token ( [BotFather](https://telegram.me/botfather) )
2020-03-19 19:57:26 +00:00
2. `$ npm install -g node-telme`
2020-03-19 18:51:24 +00:00
3. `$ telme --init`
4. Need help? `$ telme --help`
2020-03-19 18:51:24 +00:00
## How do i get a bot token?
- Get a telegram bot token from the botFather
- Just talk to [BotFather](https://telegram.me/botfather) and follow a few simple steps. Once you've created a bot and received your authorization token, copy it for later
## Configure `telme`
Simply run `$ telme --init` and follow 2 easy steps. You will need the bot token at this stage.
2020-03-19 18:51:24 +00:00
This will help you generate a `.telmeconfig` file in your home directory. You can always run `--init` again to override values or just edit the file yourself.
## Profiles
You can set multiple profiles, that will target different bots and/or different chats.
> You can use the same bot in all profiles if you like, But the target chat can be different
To initialize a new profile:
```shell
$ telme --init --profile <profile_name>
```
2020-03-19 18:51:24 +00:00
## Examples:
###### Simple message
```shell
2020-03-19 18:51:24 +00:00
$ telme --m "Message to send"
```
In the next example a message will be sent every time the user `user` logs in to a tty.
> Added the next lines at the bottom of `~/.profile` file
```shell
# Telme on login
telme --m "A new Login:\n\`\`\` user: $(whoami) | hostname: $(hostname) | remote ip $(who | cut -d'(' -f2 | cut -d')' -f1)\`\`\` Hope this is you!"
```
2020-03-19 18:51:24 +00:00
###### Task message
Task messages are a simple way to receive a message from your bot once a command has been finished. It will also let you know if you had any errors.
```shell
2020-03-19 18:51:24 +00:00
$ telme docker build . -t my-image/build/that/takes/for/ever
```
In this example, once the docker build has finished you will receive a message.
As mentioned before - you can also specify a profile.
2020-03-19 18:51:24 +00:00
```shell
$ telme -p movie-club curl https://example.com/large/file/download.mp4
2020-03-19 18:51:24 +00:00
```
this will send the message to the `movie-club` profile chat. (By the `movie-club` bot)