Quran X Bot 🕋

العربية

بوت مكتوب بلغة Python لمنصة X (تويتر سابقًا)، يقوم بنشر آية عشوائية من القرآن الكريم تلقائيًا كل ساعتين.

🌟 المميزات

• اختيار آية عشوائية من ملف JSON محلي.
• تنسيق المنشور ليشمل نص الآية، واسم السورة، ورقم الآية.
• النشر التلقائي على منصة X باستخدام مكتبة Tweepy (واجهة Twitter API v2).
• تحميل بيانات API بشكل آمن من ملف .env.

📋 المتطلبات

• Python 3.7 أو أحدث
• حساب مطور على X (Twitter Developer Account) مع صلاحيات القراءة والكتابة (Read/Write).
• المكتبات التالية:
  • tweepy
  • python-dotenv

⚙️ التثبيت والإعداد

1. استنساخ المستودع أو تنزيل الملفات

قم باستنساخ المستودع (Repository) أو تنزيل ملفات المشروع إلى جهازك أو خادمك.

2. تثبيت الاعتماديات

pip install tweepy python-dotenv

---

English

A Python-based bot for X (formerly Twitter) that publishes a random verse from the Holy Quran every two hours.

🌟 Features

• Selects a random Ayah (verse) from a local JSON file.
• Formats the post to include the verse text, Surah name, and Ayah number.
• Automatically publishes to X using the Tweepy library (Twitter API v2).
• Securely loads API credentials from a .env file.

📋 Requirements

• Python 3.7+
• X (Twitter) Developer Account with Read/Write access.
• Required Python libraries:
  • tweepy
  • python-dotenv

⚙️ Installation & Setup

1. Clone the repository or download the files

Clone the repository or download the project files to your device or server.

2. Install dependencies

pip install tweepy python-dotenv