Skip to content

README.fa.md

Latest commit

 

History

History
203 lines (144 loc) · 5.85 KB

README.fa.md

File metadata and controls

203 lines (144 loc) · 5.85 KB

🦉 ReFrame

ربات قدرتمند تلگرام برای تغییر اندازه، فشرده‌سازی و تبدیل تصاویر و ویدئوها

توسعه داده شده توسط Hoot-Code

Python python-telegram-bot License: MIT

✨ امکانات

قابلیت توضیحات
📸 پردازش تصویر تغییر اندازه، فشرده‌سازی و تبدیل فرمت — JPG · PNG · WEBP
🎬 پردازش ویدئو تغییر اندازه، فشرده‌سازی و تبدیل فرمت — MP4 · AVI · MKV
🗜️ حالت فشرده‌سازی کاهش حجم فایل بدون تغییر رزولوشن
🔄 تبدیل فرمت تبدیل بین فرمت‌های مختلف تصویر و ویدئو
🎯 Fit / Stretch حفظ نسبت تصویر یا اعمال ابعاد دقیق
🔒 اسکنر امنیتی اعتبارسنجی Magic Byte و تشخیص فایل‌های مخرب
🌐 چندزبانه انگلیسی · روسی · چینی · فارسی
🛡️ پنل مدیریت ارسال همگانی، مسدودسازی کاربران، آمار و تنظیمات زنده
💾 تاریخچه کاربران ذخیره آخرین اندازه استفاده شده
⚡ پردازش همزمان مدیریت چند عملیات موازی با محدودیت منابع

🗂️ ساختار پروژه

ReFrame/
├── main.py              # نقطه ورود و اجرای ربات
├── config.py            # تنظیمات و متغیرهای محیطی
├── database.py          # مدیریت پایگاه داده SQLite
├── handlers.py          # مدیریت تعاملات کاربران
├── admin_handlers.py    # پنل مدیریت
├── media_processor.py   # پردازش تصاویر و ویدئوها
├── scanner.py           # اسکنر امنیتی
├── locales.py           # ترجمه‌ها و متون چندزبانه
├── utils.py             # توابع کمکی
├── requirements.txt
├── Dockerfile
├── .env                 # اطلاعات محرمانه
├── .gitignore
└── temp_media/          # پوشه موقت فایل‌ها

🚀 شروع سریع

1. دریافت پروژه

git clone https://github.com/Hoot-Code/ReFrame.git
cd ReFrame

2. نصب وابستگی‌ها

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

نیازمند Python 3.12 یا بالاتر

3. نصب FFmpeg

# macOS
brew install ffmpeg

# Ubuntu / Debian
sudo apt install ffmpeg

ویندوز: FFmpeg را از وب‌سایت رسمی دانلود و نصب کنید.

4. پیکربندی

cp .env .env.local

مقادیر زیر را تنظیم کنید:

BOT_TOKEN=YOUR_BOT_TOKEN
ADMIN_IDS=123456789

5. اجرا

python main.py

🐳 اجرای Docker

docker build -t reframe-bot .
docker run -d --env-file .env --name reframe reframe-bot

🤖 دستورات ربات

دستور توضیح
/start شروع ربات و انتخاب زبان
/help نمایش راهنمای کامل
/stats مشاهده آمار استفاده
/lang تغییر زبان
/cancel لغو عملیات جاری
/admin ورود به پنل مدیریت

🌐 زبان‌های پشتیبانی‌شده

کد زبان
en انگلیسی
ru روسی
zh چینی
fa فارسی

زبان هنگام اجرای دستور /start انتخاب شده و در هر زمان از طریق /lang قابل تغییر است.

🔒 اسکنر امنیتی

تمام فایل‌های آپلودشده پیش از پردازش بررسی می‌شوند:

  • اعتبارسنجی Magic Byte برای اطمینان از واقعی بودن نوع فایل
  • شناسایی کدهای مخرب، اسکریپت‌های Shell، فایل‌های اجرایی و آرشیوهای مشکوک
  • ثبت تمام رویدادهای امنیتی در پایگاه داده

⚙️ پنل مدیریت

قابل دسترس از طریق /admin برای مدیران تعریف‌شده:

  • 📢 ارسال پیام همگانی
  • 👤 مدیریت کاربران (مسدودسازی و رفع مسدودیت)
  • 🚧 فعال یا غیرفعال کردن حالت تعمیرات
  • 📊 مشاهده آمار کامل ربات
  • 🔒 مشاهده گزارش‌های امنیتی
  • ⚙️ تغییر تنظیمات به‌صورت زنده

🖼️ اندازه‌های آماده

نام رزولوشن
پست اینستاگرام 1080 × 1080
استوری اینستاگرام 1080 × 1920
HD 1280 × 720
Full HD 1920 × 1080
4K 3840 × 2160
یوتیوب 1280 × 720
توییتر 1200 × 675
کاور فیسبوک 820 × 312
سفارشی تا 3840 پیکسل

📋 متغیرهای محیطی

متغیر ضروری پیش‌فرض توضیح
BOT_TOKEN ✅ — توکن ربات تلگرام
ADMIN_IDS ✅ — شناسه مدیران
MAX_FILE_SIZE_MB ❌ 50 حداکثر حجم فایل
MAX_CONCURRENT_JOBS ❌ 2 تعداد پردازش همزمان

📄 مجوز

MIT © Hoot-Code