🎬 בוט טלגרם להוספת קרדיט לכתוביות

בוט טלגרם מתקדם להוספת שורות קרדיט אוטומטיות לקבצי כתוביות SRT.

---

✨ תכונות עיקריות

• 📂 תמיכה בקבצי .srt בודדים וארכיוני .zip
• 🎨 הגדרת צבע, גופן ומיקום לקרדיט
• ⏱️ קרדיטים בתחילת, אמצע וסוף הסרט עם תזמון מותאם
• 🧠 מניעת התנגשויות חכמה תלוית-מיקום
• 👑 מערכת ניהול מלאה (אישור, חסימה, קידום למנהל, שידור הודעות)
• 💾 שמירת הגדרות משתמש במסד נתונים SQLite
• 🔤 קידוד UTF-8 מלא
• 📋 תפריט מקלדת קבועה

---

🚀 התקנה והפעלה

1. שכפול הפרויקט

git clone <repo-url>
cd telegram-subtitle-bot

2. התקנת תלויות

pip install -r requirements.txt

3. הגדרת משתני סביבה

cp .env.example .env

ערוך את .env ומלא את הפרטים:

• BOT_TOKEN - טוקן מ-BotFather
• ADMIN_IDS - מזהה הטלגרם שלך (קבל דרך @userinfobot)

4. הפעלת הבוט

python main.py

---

📁 מבנה הפרויקט

telegram-subtitle-bot/
├── main.py                    # נקודת כניסה ראשית
├── config.py                  # טעינת משתני סביבה
├── requirements.txt           # תלויות Python
├── .env.example               # תבנית קובץ הגדרות
│
├── database/
│   ├── db_manager.py          # פונקציות מסד נתונים (CRUD)
│   └── models.py              # מודל נתוני משתמש
│
├── handlers/
│   ├── start.py               # /start + הגדרה ראשונית
│   ├── settings.py            # עריכת הגדרות שמורות
│   ├── file_receiver.py       # קבלת ועיבוד קבצים
│   ├── custom_job.py          # עיבוד חד-פעמי מותאם
│   └── admin.py               # פקודות ניהול
│
├── services/
│   ├── srt_processor.py       # לוגיקת עיבוד SRT מרכזית
│   └── zip_handler.py         # פתיחה ואריזת ZIP
│
└── utils/
    ├── keyboards.py           # מקלדות ותפריטים
    └── helpers.py             # פונקציות עזר

---

👤 תזרים משתמש

1. משתמש חדש - שולח /start, הבקשה עוברת לאישור מנהל
2. אחרי אישור - תהליך הגדרה ראשונית 8 שלבים
3. שימוש שוטף - שליחת קבצי .srt / .zip לעיבוד אוטומטי
4. הגדרות - שינוי בכל עת דרך ⚙️ הגדרות
5. חד-פעמי - 🎬 כתוביות מותאמות אישית לעיבוד בודד שונה

---

👑 פקודות מנהל

פקודה	תיאור
/ban [user_id]	חסימת משתמש
/promote [user_id]	קידום למנהל
/broadcast [הודעה]	שידור לכל המשתמשים
/users	רשימת כל המשתמשים

---

⚙️ לוגיקת תזמון קרדיטים

קרדיט פתיחה

מופיע בשניות 5 ממשך הסרט, לפי משך שהוגדר.

קרדיט אמצע

חוזר כל X דקות (לפי הגדרת תדירות), לפי משך שהוגדר.

קרדיט סיום

מופיע לפני שתי הכתוביות האחרונות של הקובץ (להימנעות מהסתרת קרדיטים מקוריים).

מניעת התנגשויות (חכמה תלוית-מיקום)

• קרדיט למעלה + כתוביות למטה → אין בדיקת התנגשות, חפיפה מותרת
• קרדיט למטה + כתוביות למטה → הבוט מזיז את חלון הזמן קדימה עד למציאת חלון פנוי

---

🔧 דרישות מערכת

• Python 3.10+
• חיבור אינטרנט לבוט הטלגרם

---

📝 רישיון

פרויקט פנימי - צוות אריאל 🎬