https://github.com/meinside/telegram-d2-bot
A Telegram Bot which replies to messages with D2-generated .svg files in .png format.
https://github.com/meinside/telegram-d2-bot
d2 telegram-bot
Last synced: 20 days ago
JSON representation
A Telegram Bot which replies to messages with D2-generated .svg files in .png format.
- Host: GitHub
- URL: https://github.com/meinside/telegram-d2-bot
- Owner: meinside
- License: other
- Created: 2022-11-24T09:29:42.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2025-04-17T00:05:32.000Z (about 1 month ago)
- Last Synced: 2025-04-17T13:15:00.540Z (about 1 month ago)
- Topics: d2, telegram-bot
- Language: Go
- Homepage:
- Size: 296 KB
- Stars: 12
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# telegram-d2-bot
A telegram bot which answers with rendered `.svg` files in `.png` format.
Using [terrastruct/d2](https://github.com/terrastruct/d2) for generating .svg files from messages.
## Configuration
```bash
$ cp config.json.sample config.json
```
and edit:
```json
{
"allowed_ids": ["telegram_username_1", "telegram_username_2"],
"monitor_interval": 5,
"theme_id": 0,
"sketch": false,
"is_verbose": false,
"bot_token": "xxxxxxxxyyyyyyyy-1234567"
}
```
* `bot_token` can be obtained from [bot father](https://t.me/botfather)
* `allowed_ids` are ids of allowed telegram users who can get responses from this bot
* `monitor_interval` is the polling interval (in seconds) from telegram API
* `theme_id` can be retrieved from [these files](https://github.com/terrastruct/d2/tree/master/d2themes/d2themescatalog) (= 0 for default)
* `sketch` is whether to render results in sketched style
* `is_verbose` is whether to print verbose messages
### Using Infisical
You can use [Infisical](https://infisical.com/) for retrieving your bot token and api key:
```json
{
"allowed_ids": ["telegram_username_1", "telegram_username_2"],
"monitor_interval": 5,
"theme_id": 0,
"sketch": false,
"is_verbose": false,
"infisical": {
"client_id": "012345-abcdefg-987654321",
"client_secret": "aAbBcCdDeEfFgG0123456789xyzwXYZW",
"project_id": "012345abcdefg",
"environment": "dev",
"secret_type": "shared",
"bot_token_key_path": "/path/to/your/KEY_TO_BOT_TOKEN",
}
}
```
## Other Dependencies
[Playwright](https://github.com/playwright-community/playwright-go) is needed for exporting .png files:
```bash
$ npx playwright install-deps
```
## Build and Run
```bash
$ go build
$ ./telegram-d2-bot config.json
```
## Run as a service
### systemd
Create a file named `/etc/systemd/system/telegram-d2-bot.service`:
```
[Unit]
Description=Telegram D2 Bot
After=syslog.target
After=network.target
[Service]
Type=simple
User=ubuntu
Group=ubuntu
WorkingDirectory=/dir/to/telegram-d2-bot
ExecStart=/dir/to/telegram-d2-bot/telegram-d2-bot [CONFIG_FILEPATH]
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
```
and make it run automatically on booting:
```bash
$ sudo systemctl enable telegram-d2-bot.service
$ sudo systemctl start telegram-d2-bot.service
```
## Todos
- [ ] Add more configurable options.
- [x] Support uploading .d2 files.
- [x] Respond with .png files. (Playwright is needed)