POP Tv One - File Stream Bot

A powerful, customized Telegram bot to generate direct stream links instantly.

---

💖 Support My Work

This project is the result of countless hours of passion and dedication, especially in completely overhauling the video player with a professional UI and unique mobile features.

If you've found this bot useful and appreciate the effort, please consider showing your support by buying me a coffee! It helps me dedicate more time to maintaining and improving this project for everyone. Thank you!

---

🚀 About This Project

This is a customized and enhanced version of the popular FileStreamBot, proudly maintained by POP Tv One. This bot allows you to generate direct streamable links for any file stored on Telegram, eliminating the need to download files before watching. It's fast, efficient, and perfect for media lovers!

✨ Key Features

• Instant Streaming: Get direct links for your Telegram files in seconds.
• No Download Needed: Play your videos and media directly in your browser or media player.
• Channel Support: Fully supports files from Telegram channels.
• Easy Deployment: Deploy your own instance of the bot on Heroku, VPS, or using Docker.
• Highly Customizable: You can easily configure the bot with your own settings and variables.

---

🛠️ Deployment Guide

You can deploy this bot on various platforms. Choose the method that suits you best.

Deploy on Heroku (Paid)

• Fork This Repository: Click Here
• Click on the Deploy button below to get started on Heroku.

Go to the Configuration section for more info on setting up environmental variables.

Deploy Locally / on VPS

Follow these commands to run the bot on your local machine or a Virtual Private Server (VPS).

# Clone your repository (NOT the original one)
git clone https://github.com/dilusha034/FileStreamBot
cd FileStreamBot
Create a virtual environment and activate it

python3 -m venv ./venv
. ./venv/bin/activate
Install dependencies

pip install -r requirements.txt
Run the bot

python3 -m FileStream

To stop the bot, press CTRL + C.

To run the bot 24/7 on a VPS, use tmux:

sudo apt install tmux -y
tmux
python3 -m FileStream

Now you can safely close the VPS terminal, and the bot will continue to run.

Deploy using Docker

Clone the repository:

git clone https://github.com/dilusha034/FileStreamBot
cd FileStreamBot

Build your Docker image:

docker build -t pop-tv-filestream .

Create an .env file with your variables, then start the container:

docker run -d --restart unless-stopped --name pop-tv-bot \
-v /path/to/your/.env:/app/.env \
-p 8080:8080 \
pop-tv-filestream

To restart the container after changing variables, use:

docker restart pop-tv-bot

---

⚙️ Configuration (Variables)

Click to see all required and optional variables

If you're on Heroku, add these in the 'Config Vars' section. If you're hosting locally, create a file named .env and add them there.

📝 Mandatory Vars:

• API_ID: Get from my.telegram.org.
• API_HASH: Get from my.telegram.org.
• OWNER_ID: Your Telegram User ID.
• BOT_TOKEN: Your bot's token from @BotFather.
• DATABASE_URL: Your MongoDB connection URI.
• And other required variables as listed in the original documentation...

🪐 Optional Vars:

• UPDATES_CHANNEL, FORCE_SUB_ID, START_PIC, etc., can be configured for a better user experience.

---

💬 Get in Touch

Have questions, suggestions, or need help with this specific version? Feel free to reach out to me!

• Telegram: @Mr_D_2000

❤️ Acknowledgements & Credits

This project is a customized fork of the original FileStreamBot. A huge thank you to the original developers for their incredible work and for making their code open-source.

• AvishkarPatil (avipatilpro) - For the original bot.
• Deekshith SH - For modules.
• EverythingSuckz - For his version of FileStreamBot.
• Biisal - For the Stream Page UI..

---

© 2025 POP Tv One | Maintained by Dilusha