🌅 Daily Light - Telegram Bible Verse Bot

Dedicated to the persecuted Christians around the world.
“Remember those who are in prison, as though in prison with them.” – Hebrews 13:3

Daily Light is a beautifully crafted Telegram bot that delivers a daily Bible verse in both Persian (Farsi) and English. It brings spiritual encouragement, light, and peace to individuals and groups each morning.

✨ Features

• 🌅 Daily Bible Verses: Automatically sends an inspiring verse every morning at 8:00 AM
• 🇮🇷 Persian Focus: Over 88 curated Persian Bible verses with authentic formatting
• 🌍 Bilingual Support: Supports both Persian (فارسی) and English
• 👥 Group Friendly: Works reliably in Telegram groups and private chats
• 🤖 Smart Scheduling: Timezone-aware scheduling system for consistent delivery
• 🔄 Multiple Sources: Uses ESV API and Bible Gateway with a graceful fallback system
• 📱 Interactive Commands: Allows users to change language and view verses easily
• 🎯 Persian Numerals: Presents verses with authentic Persian digit formatting
• 💾 Persistent Settings: Saves user and group language preferences
• 🛡️ Stable & Reliable: Robust error handling and backup systems

📱 Bot Commands

Command	Description
/start	Welcome message and setup
/verse	Get today’s Bible verse
/language	Switch between Persian and English
/help	Show help message
/stats	View bot usage statistics (admin)

🚀 Quick Start

Prerequisites

• Python 3.8 or higher
• A Telegram Bot Token from @BotFather

Installation

git clone https://github.com/yourusername/daily-light-bot.git
cd daily-light-bot
pip install -r requirements.txt
cp .env.example .env
# Edit .env with your bot token and other settings
python bot.py

⚙️ Configuration

Create a .env file with the following content:

# Required
BOT_TOKEN=your_telegram_bot_token_here

# Optional API Keys
ESV_API_KEY=your_esv_api_key_here
BIBLE_GATEWAY_API_KEY=your_bible_gateway_key_here

# Scheduling
DAILY_TIME=08:00
TIMEZONE=UTC

📖 Bible Verse Collections

Persian Collection (88 Verses)

• Handpicked and properly formatted Persian verses
• Persian numerals and book names

English Collection (20 Verses)

• Short, encouraging English verses
• Automatically rotates daily
• Uses ESV API or Bible Gateway

🌍 Multi-Language Support

Supported Languages:

• Persian (فارسی) – Primary language with full verse collection
• English – Secondary language using API and local fallback

Language Features:

• Per-user language preferences
• Group-level language setting (admin only)
• Auto-detection of user language
• Easy language switch with buttons

🏗️ Project Structure

daily-light-bot/
├── bot.py                   # Main application
├── config.py                # Configuration handling
├── bible_service.py         # Bible verse logic
├── database.py              # Group data handling
├── scheduler.py             # Daily task scheduler
├── languages.py             # i18n language support
├── user_preferences.py      # User language storage
├── bible_verses.json        # English verse data
├── bible_verses_farsi.json  # Persian verse data
├── requirements.txt         # Python dependencies
├── .env.example             # Example environment file
├── .gitignore               # Git ignore rules
├── LICENSE                  # MIT License
└── README.md                # Project documentation

🔧 Development

Local Development

# Clone repo and enter project directory
git clone https://github.com/yourusername/daily-light-bot.git
cd daily-light-bot

# Create and activate virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\\Scripts\\activate

# Install packages
pip install -r requirements.txt

# Set up environment
cp .env.example .env
# Edit with your own credentials

# Run bot
python bot.py

Adding New Verses

To add a new verse:

• Persian: Edit bible_verses_farsi.json
• English: Edit bible_verses.json

Format:

{
  "reference": "John 3:16",
  "text": "For God so loved the world..."
}

🚀 Deployment Options

Server/VPS

nohup python bot.py > bot.log 2>&1 &

# Or using screen
screen -S daily-light
python bot.py
# Ctrl+A, D to detach

Heroku (Optional)

heroku create your-daily-light-bot

heroku config:set BOT_TOKEN=your_token_here
heroku config:set DAILY_TIME=08:00
heroku config:set TIMEZONE=UTC

git push heroku main

🤝 Contributing

We welcome your contributions!

Ways to contribute:

• Add new verses (Persian or English)
• Improve Persian formatting or translations
• Add support for more Bible APIs
• Suggest new features
• Fix bugs or improve performance
• Translate bot to other languages

📄 License

This project is licensed under the MIT License. See the LICENSE file for more details.

🙏 Acknowledgments

• Persian Bible translations from trusted sources
• ESV Bible API
• Bible Gateway
• Telegram Bot API
• All faithful contributors and users

---

May this bot be a source of daily light, peace, and strength—especially for those suffering for their faith.

_“Blessed are those who are persecuted for righteousness’ sake, for theirs is the kingdom of heaven.” – Matthew 5:10_