StreamBox Docs 🚀

Telegram File Stream & Direct Link Generator

دليل الاستخدام الشامل لمشروع ستريم بوكس

01 Introduction / مقدمة

StreamBox is a powerful Telegram-based file streaming service. It uses Telegram's 2GB file limit to provide free, unlimited cloud storage for your files, generating direct stream and download links instantly.

ستريم بوكس هو خدمة قوية لبث الملفات تعتمد على تيليجرام. تستخدم حد الـ 2 جيجابايت الخاص بتيليجرام لتوفير مساحة تخزين سحابية مجانية وغير محدودة لملفاتك، مع إنشاء روابط بث وتحميل مباشرة فوراً.

02 Environment Variables / المتغيرات البيئية

To run StreamBox, you need the following credentials from Telegram:

Variable / المتغير	Description / الوصف
TELEGRAM_API_ID	Your API ID from my.telegram.org
TELEGRAM_API_HASH	Your API Hash from my.telegram.org
TELEGRAM_BOT_TOKEN	Bot token from @BotFather
BIN_CHANNEL_ID	Storage channel ID (e.g., -1001234567890). Bot must be admin.

03 Docker Deployment / النشر عبر دوكر

StreamBox includes a Dockerfile and docker-compose.yml for easy containerized deployment.

# 1. Clone the repository
git clone https://github.com/yourusername/streambox.git
cd streambox

# 2. Create .env file with your variables
nano .env

# 3. Start the container
docker-compose up -d

04 Heroku Deployment / النشر عبر هيروكو

You can deploy StreamBox to Heroku with a single click or via the Heroku CLI.

# Login to Heroku
heroku login

# Create a new app
heroku create my-streambox-app

# Push code to Heroku
git push heroku main

# Set environment variables
heroku config:set TELEGRAM_API_ID=your_id TELEGRAM_API_HASH=your_hash TELEGRAM_BOT_TOKEN=your_token BIN_CHANNEL_ID=your_channel

05 Render & Railway / منصات أخرى

StreamBox is pre-configured for modern PaaS providers. Configuration files (render.yaml and railway.json) are included in the repository.

Render: Connect your GitHub repo. Render will automatically detect the render.yaml file.
Railway: Create a new project from GitHub. Railway uses the railway.json configuration automatically.