How simpnick6703/disgram works
Disgram periodically scrapes configured public Telegram channels in short-lived workers, prepares message text and media, and forwards them to Discord. The main process orchestrates channel chunks and also serves health and administrative endpoints. A shared log tracks forwarded-message markers; optional Git persistence pushes that state to GitHub, while optional Telethon support supplies richer text and media. The workflow and major capabilities are documented in the README; some internal details are shown only in partial excerpts, so relationships not evidenced there are omitted.
Main entry points: webhook.py Channel Worker · main.py Worker Orchestrator · git_manager.py Git Log Manager · logging_config.py Log & Marker Handler
Components 15
Runtime & API
- Runtime Config
config.py - Worker Orchestrator
main.py - Health & Admin API
main.py
Scrape & Forward
- Channel Worker
webhook.py - Preview Scraper
webhook.py - Message Parser
webhook.py - Media Handling
webhook.py - Discord Layout Sender
webhook.py
Logs & Persistence
- Log & Marker Handler
logging_config.py - Git Log Manager
git_manager.py
Telegram Integration
- Telethon Client
telethon_client.py
Other components
- Operator
- Telegram Public
- Discord
- GitHub
Connections 20
- Operator → Worker Orchestrator: starts
README.md - Worker Orchestrator → Health & Admin API: starts API
README.md - Worker Orchestrator → Channel Worker: spawns chunks
README.md - Worker Orchestrator → Git Log Manager: initializes
README.md - Runtime Config → Worker Orchestrator: configures
main.py - Runtime Config → Channel Worker: configures
webhook.py - Channel Worker → Preview Scraper: scrapes channels
README.md - Preview Scraper → Telegram Public: fetches previews
webhook.py - Channel Worker → Message Parser: processes messages
README.md - Message Parser → Telethon Client: fetches rich text
README.md - Message Parser → Media Handling: extracts media
README.md - Media Handling → Telethon Client: downloads media
README.md - Media Handling → Telegram Public: downloads fallback media
README.md - Channel Worker → Discord Layout Sender: prepares content
README.md - Discord Layout Sender → Discord: sends webhook
webhook.py - Channel Worker → Log & Marker Handler: records markers
README.md - Health & Admin API → Log & Marker Handler: cleans and reads
README.md - Git Log Manager → Log & Marker Handler: persists log
README.md - Git Log Manager → GitHub: commits and pushes
README.md - Operator → Health & Admin API: checks status
README.md