• Fork This Repo

• Click on Deploy Easily

• Press the below button to Fast deploy on Heroku

  

• Go to variables tab for more info on setting up environmental variables.

git clone https://github.com/avipatilpro/FileStreamBot
cd FileStreamBot
python3 -m venv ./venv
. ./venv/bin/activate
pip install -r requirements.txt
python3 -m FileStream

• To stop the whole bot, do CTRL+C

• If you want to run this bot 24/7 on the VPS, follow these steps.

sudo apt install tmux -y
tmux
python3 -m FileStream

• now you can close the VPS and the bot will run on it.

• Create ENV and Start Container:

docker run -d --restart unless-stopped --name fsb \
-v /PATH/TO/.env:/app/.env \
-p 8000:8000 \
file-stream

• if you need to change the variables in .env file after your bot was already started, all you need to do is restart the container for the bot settings to get updated:

docker restart fsb

If you're on Heroku, just add these in the Environmental Variables or if you're Locally hosting, create a file named .env in the root directory and add all the variables there. An example of .env file:

API_ID = 789456
API_HASH = ysx275f9638x896g43sfzx65
BOT_TOKEN = 12345678:your_bot_token
BIN_CHANNEL = -100xxxxxxxx
DATABASE_URL = mongodb://admin:[email protected]
FQDN = 192.168.27.1
HAS_SSL = False
MULTI_TOKEN1 = 12345678:bot_token_multi_client_1
MULTI_TOKEN2 = 12345678:bot_token_multi_client_2
OWNER_ID = 987456321
PORT = 8080

📝 Mandatory Vars :

• API_ID: API ID of your Telegram account, can be obtained from My Telegram. int
• API_HASH: API hash of your Telegram account, can be obtained from My Telegram. str
• OWNER_ID: Your Telegram User ID, Send /id to @missrose_bot to get Your Telegram User ID int
• BOT_TOKEN: Telegram API token of your bot, can be obtained from @BotFather. str
• LOG_CHANNEL: ID of the channel where bot will forward all files received from users. int.
• BOT_WORKERS: Number of updates bot should process from Telegram at once, by default to 10 updates. int
• DATABASE_URL: MongoDB URI for saving User Data and Files List created by user. str
• FQDN: A Fully Qualified Domain Name if present without http/s. Defaults to BIND_ADDRESS. str

🗼 MultiClient Vars :

• MULTI_TOKEN1: Add your first bot token or session strings here. str
• MULTI_TOKEN2: Add your second bot token or session strings here. str

🪐 Optional Vars :

• UPDATES_CHANNEL: Channel Username without @ to set channel as Update Channel str
• FORCE_UPDATES_CHANNEL: Set to True, so every user have to Join update channel to use the bot. bool
• AUTH_USERS: Put authorized user IDs to use bot, separated by Space. int
• SLEEP_THRESHOLD: Set global flood wait threshold, auto-retry requests under 60s. int
• SESSION_NAME: Name for the Database created on your MongoDB. Defaults to FileStream. str
• IMAGE_FILEID: To set Image at /files command. Defaults to pre-set image. str
• WORKERS: Number of maximum concurrent workers for handling incoming updates. Defaults to 6. int
• PORT: The port that you want your webapp to be listened to. Defaults to 8080. int
• BIND_ADDRESS: Your server bind adress. Defauls to 0.0.0.0. int
• MODE: Should be set to secondary if you only want to use the server for serving files. str
• PING_INTERVAL: Heroku ping interval (ms), defaults to 1200 (20 minutes). int
• KEEP_ALIVE: Self-ping server every PING_INTERVAL sec to avoid sleeping defaults to False.
• NO_PORT: (True/False) Set PORT to 80 or 443 hide port display; ignore if on Heroku. Defaults to False.
• HAS_SSL: (can be either True or False) If you want the generated links in https format. Defaults to False.

⚠️ Before using the bot, don't forget to add the bot to the LOG_CHANNEL as an Admin

‍☠️ Bot Commands :

/start      : To check if the bot is alive or not.
/help       : To Get Help Message.
/about      : To check About the Bot.
/files      : To Get All Files List of User.
/del        : To Delete Files from DB with FileID.
/ban        : To Ban Any Channel or User to use bot.
/unban      : To Unban Any Channel or User to use bot.
/status     : To Get Bot Status and Total Users.
/broadcast  : To Broadcast any message to all users of bot.

🍟 Channel Support :

Bot also Supported with Channels. Just add bot Channel as Admin. If any new file comes in Channel it will edit it with Get Download Link Button.