Telegram Schedule Bot

A Telegram bot for managing and distributing school schedules. The bot automatically downloads schedule PDFs from a school website, processes them, and provides schedule information to users via Telegram.

Features

• Automatic schedule downloading from school website
• PDF processing with OCR support
• Interactive Telegram interface
• Admin panel for bot management
• Class and day-based schedule lookup
• Easy deployment and configuration

Installation

From Source

1. Clone the repository:

git clone https://github.com/Filang666/telegram-schedule-bot.git
cd telegram-schedule-bot

Install dependencies:

pip install -e .[dev]  # For development
# or
pip install -e .       # For basic installation

Configure the bot:

cp .env.example .env

Configuration

Create a .env file in the project root:

TOKEN=your_telegram_bot_token_here ADMINS=123456789,987654321

Usage

Running the bot:

# Using the installed script
schedule-bot

# Or from source
python -m src.aiogram_run

Parsing schedules manually:

schedule-parser

Requirements

Python 3.9+

Tesseract OCR (for PDF text extraction)

Firefox/GeckoDriver (for web scraping)

Telegram Bot API token

License

MIT License - see LICENSE file for details. Author