News Media Aggregator¶
Collect and organize media from news channels automatically. Perfect for media monitoring and journalism.
Use Case¶
Perfect For
- Journalists and media professionals
- Researchers and analysts
- Media monitoring services
- News archival projects
Key Features¶
- Multi-Channel Aggregation: Monitor multiple news sources simultaneously
- Media Type Filtering: Images, videos, and documents
- Date-Based Organization: Filter by publication date
- Real-Time Monitoring: Continuous updates from news channels
Quick Start¶
Create docker-compose.yml:¶
version: '3.8'
services:
telegram-downloader:
image: rfsbraz/telegram-downloader:latest
container_name: telegram-news-aggregator
restart: unless-stopped
environment:
# Telegram API credentials
- TDL_API_ID=YOUR_API_ID
- TDL_API_HASH=YOUR_API_HASH
- TDL_PHONE_NUMBER=YOUR_PHONE_NUMBER
# Daemon configuration
- TDL_DAEMON_ENABLED=true
- TDL_DAEMON_CHECK_INTERVAL=180 # Check every 3 minutes for news
# Notifications
- TDL_NOTIFICATIONS_ENABLED=true
- TDL_NOTIFICATIONS_DISCORD_WEBHOOK_URL=YOUR_WEBHOOK_URL
- TDL_NOTIFICATIONS_DETAIL_LEVEL=summary
# Source 1: Breaking News Channel
- TDL_SOURCES_0_URL=https://t.me/breaking_news_channel
- TDL_SOURCES_0_NAME=Breaking News
- TDL_SOURCES_0_FILTERS_EXTENSIONS=.jpg,.png,.mp4,.pdf
- TDL_SOURCES_0_FILTERS_MIN_DATE=2026-01-01
# Source 2: Tech News Channel
- TDL_SOURCES_1_URL=https://t.me/tech_news_channel
- TDL_SOURCES_1_NAME=Tech News
- TDL_SOURCES_1_FILTERS_EXTENSIONS=.jpg,.png,.mp4
# Source 3: Local News Channel
- TDL_SOURCES_2_URL=https://t.me/local_news_channel
- TDL_SOURCES_2_NAME=Local News
- TDL_SOURCES_2_FILTERS_EXTENSIONS=.jpg,.png,.mp4,.pdf
volumes:
- ./news_media:/downloads
- ./sessions:/app/.sessions
healthcheck:
test: ["CMD", "python3", "/app/healthcheck.py"]
interval: 2m
timeout: 10s
Deploy:¶
mkdir telegram-news-aggregator && cd telegram-news-aggregator
mkdir news_media sessions
# Create docker-compose.yml with configuration above
docker compose up -d
docker compose logs -f # Authenticate on first run
Configuration Highlights¶
Fast Updates¶
Balance Performance
Faster checks = more API usage. Monitor for FloodWait errors.
Date Filtering¶
Media Types¶
# Images and videos only
- TDL_SOURCES_0_FILTERS_EXTENSIONS=.jpg,.png,.mp4,.webm
# Include documents
- TDL_SOURCES_1_FILTERS_EXTENSIONS=.jpg,.png,.mp4,.pdf,.doc,.docx
Expected Results¶
Folder Structure¶
news_media/
├── Breaking News/
│ ├── 2026-01-21_breaking_story.jpg
│ ├── 2026-01-21_video_report.mp4
│ └── 2026-01-21_press_release.pdf
├── Tech News/
│ ├── product_launch.jpg
│ └── keynote_video.mp4
└── Local News/
├── local_event.jpg
└── community_report.pdf
Notifications¶
Discord alerts for:
- New media from monitored channels
- Missing or deleted posts
- Daily summary of collected media
Customization¶
Topic-Based Filtering¶
# Only download content about specific topics
- TDL_SOURCES_0_FILTERS_PATTERNS=*breaking*,*urgent*,*alert*
# Filter out certain topics
- TDL_SOURCES_1_FILTERS_PATTERNS=*election*,*politics*
Size Limits for Storage Management¶
# Limit individual file sizes
- TDL_SOURCES_0_FILTERS_MIN_SIZE=50KB
- TDL_SOURCES_0_FILTERS_MAX_SIZE=50MB
Multiple Detail Levels¶
# Minimal: Just counts
- TDL_NOTIFICATIONS_DETAIL_LEVEL=minimal
# Summary: Counts + source info (recommended for news)
- TDL_NOTIFICATIONS_DETAIL_LEVEL=summary
# Detailed: Full file listings
- TDL_NOTIFICATIONS_DETAIL_LEVEL=detailed
Use Cases¶
Media Monitoring¶
Monitor competitor coverage or brand mentions across news channels.
Research & Analysis¶
Collect media for academic research or trend analysis.
Archival Projects¶
Build comprehensive archives of historical news coverage.
Journalism¶
Track breaking stories across multiple sources in real-time.
Performance Tips¶
Optimize for News
- Faster checks: 2-3 minutes for breaking news
- Date filtering: Only recent posts to reduce processing
- Multiple sources: Aggregate from 5-10 channels effectively
- Storage monitoring: News media accumulates quickly
Troubleshooting¶
Too Many Files
Use date filtering to limit scope:
Rate Limiting
If checking many sources rapidly, increase interval:
See Troubleshooting Guide for more help.