selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

El Monitorro logo

Self-host El Monitorro

0.14.0

Telegram bot that reads RSS, Atom, and JSON feeds

BetaOpen SourceMIT
Updated4 months ago
LanguageRust
Setup difficultyModerate
Stars
215
Requires
PostgreSQL
Docker
ayratbadykov/el_monitorro
Install with Docker

What is El Monitorro?

This feed reader operates as a Telegram bot, parsing RSS, Atom, and JSON feeds to deliver updates directly in chat. Users can customize how items appear using Handlebars templates with helpers for formatting, set keyword filters to include or exclude posts, and adjust timezones per account. The system separates concerns into distinct processes for commands, feed polling, message delivery, and database cleanup, though these can merge into one binary. A PostgreSQL database and Telegram bot token are required. You can deploy via Docker, Docker Compose, or by building from source with Cargo.

Should you self-host El Monitorro?

El Monitorro scores 45/100 on selfhost.directory (how scoring works) and ranks #48 of 85 in Feed Reader. It has 215 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Rust.

Its closest alternative on selfhost.directory is RSSHub (85/100, 46 703 stars). It scores higher overall, so compare the two before you pick. See El Monitorro vs RSSHub side by side.

Features

  • Admin Commands
  • Content hash customization
  • Customizable Templates
  • Global templates and filters
  • Keyword filters
  • Multi-process architecture
  • Preview toggle
  • RSS/Atom/JSON feed parsing
  • Subscription limits
  • Telegram bot delivery
  • Timezone Support

El Monitorro README

How to install El Monitorro

Install El Monitorro with Docker

Environment variables
DATABASE_URL, TELEGRAM_BOT_TOKEN, DATABASE_POOL_SIZE, ALL_BINARIES, TELEGRAM_BOT_HANDLE, SUBSCRIPTION_LIMIT, FILTER_LIMIT, SYNC_INTERVAL_SECONDS, SYNC_WORKERS_NUMBER, DELIVER_INTERVAL_SECONDS, DELIVER_WORKERS_NUMBER, CLEAN_INTERVAL_SECONDS, CLEAN_WORKERS_NUMBER, OWNER_TELEGRAM_ID, REQUEST_TIMEOUT, ADMIN_TELEGRAM_ID, SETUP_DB, RUN_MIGRATION, BOT_BINARY

docker run --env-file ./.env --network host -t ayratbadykov/el_monitorro:latest

Requires .env file with DATABASE_URL and TELEGRAM_BOT_TOKEN. Use --network host for local PostgreSQL.

El Monitorro releases & version history

More in Feed Reader

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…