arsam
fc16c47343
Import the existing local project snapshot. This commit organizes existing files; it does not represent newly developed functionality.
🚀 Tele2Rub
انتقال خودکار فایل از تلگرام به روبیکا — سریع، ساده، بدون هزینه و دردسر
پشتیبانی از ارسال فایل تا ۲ گیگابایت
🧠 معرفی
Tele2Rub
یک ابزار سبک و کاربردی است که فایل‌ها را از بات تلگرام دریافت کرده و به صورت خودکار به سیو مسیج (Saved Messages) روبیکا ارسال می‌کند.
کل فرایند به صورت صف (Queue) انجام می‌شود تا از بروز خطا و تداخل جلوگیری شود.
⚙️ نحوه کار
ارسال به روبیکا → صف پردازش → دانلود فایل → ربات تلگرام
- دریافت فایل از تلگرام
- ذخیره موقت در سرور
- ثبت در صف
- ارسال خودکار توسط Worker
✨ قابلیت‌ها
- 📥 دریافت انواع فایل از تلگرام
- 🔗 پشتیبانی دانلود از لینک مستقیم
- 📤 ارسال خودکار به روبیکا
- 🧾 ارسال همه فایل‌ها به صورت Document
- 📊 نمایش وضعیت دانلود و آپلود
- ❌ امکان حذف یک فایل از صف با
/del - 🧨 امکان پاکسازی کل صف با
/delall - 🛡 حالت Safe Mode برای ارسال فایل ها به صورت ZIP رمز دار
- ⚡سیستم صف برای جلوگیری از کرش
- 🔄 اجرای جداگانه پردازش برای پایداری بیشتر
- ⏱ محدودیت زمان آپلود برای جلوگیری از گیر کردن پردازش (این مقدار با توجه به سرعت سرور، حجم فایل‌ها و صبر و حوصله خودتون قابل تنظیمه.) (به‌صورت پیش‌فرض روی ۱۰ دقیقه تنظیم شده.)
🛠 نصب سریع
ابتدا پروژه را دریافت کنید:
git clone https://github.com/caffeinexz/Tele2Rub.git
cd Tele2Rub
نصب وابستگی‌ها:
pip install -r requirements.txt
اجرای پروژه:
python3 main.py
🖥 نصب روی سرور
1. نصب پیش‌نیازها
sudo apt update
sudo apt install python3 python3-venv python3-pip git -y
2. دریافت پروژه
git clone https://github.com/caffeinexz/Tele2Rub.git
cd Tele2Rub
3. ساخت محیط مجازی
python3 -m venv venv
4. فعال‌سازی محیط مجازی
source venv/bin/activate
5. نصب وابستگی‌ها
pip install --upgrade pip
pip install -r requirements.txt
6. ساخت فایل تنظیمات
nano .env
و مقادیر زیر را وارد کنید:
API_ID=عدد_API
API_HASH=کد_API
BOT_TOKEN=توکن_ربات
RUBIKA_SESSION=rubsession
7. اجرای دائمی (Screen)
screen -S tele2rub
source venv/bin/activate
python main.py
⚙️ تنظیمات
یک فایل .env در ریشه پروژه بسازید:
API_ID=عدد_API
API_HASH=کد_API
BOT_TOKEN=توکن_ربات
RUBIKA_SESSION=rubsession
یا از فایل نمونه استفاده کنید:
cp .env.example .env
📌 دریافت API_ID و API_HASH از تلگرام
برای استفاده از پروژه، ابتدا باید API تلگرام دریافت کنید:
-
وارد سایت زیر شوید: 👉 https://my.telegram.org
-
با شماره تلگرام خود وارد شوید
-
روی API development tools کلیک کنید
-
فرم را به شکل زیر پر کنید:
App title: tele2rub
Short name: t2r
- پس از ثبت، مقادیر زیر به شما داده می‌شود:
- API_ID
- API_HASH
این مقادیر را در فایل .env قرار دهید.
درصورت مشکل در دریافت API ID و API HASH مقادیر در کانال تلگرام قرار گرفته لینک : https://t.me/caffeinexz/3
🔐 اجرای اولیه
در اولین اجرا:
- شماره روبیکا را وارد کنید
- کد تایید را وارد کنید
- فایل سشن ذخیره می‌شود و در دفعات بعد نیاز نیست
📥 نحوه استفاده
- وارد بات تلگرام شوید
- فایل ارسال کنید
- فایل به صورت خودکار در Saved Messages روبیکا ارسال می‌شود