Skip to content

fuerbringer/tldr-telegram

Repository files navigation

Bot Icon

tldr-telegram

The tldr pages client for Telegram Messenger.

This free/libre code is currently running at @tldr_pages_bot. Try it out and share it in your group chats!

Screenshot

tldr pages bot

Installing / Getting started

This bot can be run with Docker or simply npm start. In both cases .env needs to be populated with the following environment variables:

NODE_ENV=production
BOT_TOKEN=<TELEGRAMBOTFATHERTOKEN>
BOT_USERNAME=<TELEGRAMBOTUSERNAME>
GITHUB_TOKEN=<GITHUBTOKEN>
REDIS_HOST=<REDISIP>
REDIS_PORT=<REDISPORT>
LOG_FILE=<LOGFILENAME>

Note that REDIS_HOST and REDIS_PORT are optional if you're using docker-compose to start the bot.

Docker installation

With the .env file done you're ready to launch your selfhosted tldr-telegram bot. Use docker run -d fuerbringer/tldr-telegram to get up and running quickly. Alternatively you can clone this repository and execute docker-compose up -d for a more unified solution with both the bot and redis containerized.

Useful links

Licensing

Code

The executable source code is freely available under the GNU Affero General Public License v3.0.

Icon

The icon files are licensed under the Creative Commons Attribution-ShareAlike 4.0 International License.

Privacy

The development of this bot attempts to follow the Telegram API Terms of Service as closely as possible to guard the users' privacy. Logger code only retains information necessary to find bugs and keep a high uptime.

Releases

No releases published

Packages

No packages published