Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

TheCaduceus/FileStreamBot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

64 Commits

Repository files navigation

🌐File Stream Bot

An open-source Python Telegram bot to transmit Telegram files over HTTP.

πŸ“‘ INDEX

βš™οΈ Installation

1.Install Python & Git:

For Windows:

winget install Python.Python.3.11
winget install Git.Git

For Linux:

sudo apt-get update && sudo apt-get install -y python3.11 git pip

For MacOS:

brew install python@3.11 git

For Termux:

pkg install python -y
pkg install git -y

2.Download repository:

git clone https://github.com/TheCaduceus/FileStreamBot.git

3.Change Directory:

cd FileStreamBot

4.Install requirements:

pip install -r requirements.txt

πŸ“ Variables

The variables listed below should be defined either in config.py file or as environment variables, depending on your setup.

  • API_ID|TELEGRAM_API_ID: API ID of your Telegram account, can be obtained from My Telegram. int
  • API_HASH|TELEGRAM_API_HASH: API hash of your Telegram account, can be obtained from My Telegram. str
  • OWNER_ID: ID of your Telegram account, can be obtained by sending /info to @DumpJsonBot. int
  • ALLOWED_USER_IDS: A list of Telegram account IDs (separated by spaces) that are permitted to use the bot. Leave this field empty to allow anyone to use it. str
  • BOT_USERNAME|TELEGRAM_BOT_USERNAME: Username of your Telegram bot, create one using @BotFather. str
  • BOT_TOKEN|TELEGRAM_BOT_TOKEN: Telegram API token of your bot, can be obtained from @BotFather. str
  • CHANNEL_ID|TELEGRAM_CHANNEL_ID: ID of the channel where bot will forward all files received from users, can be obtained by forwarding any message from channel to @DumpJsonBot and then looking from forward_from_chat key. int
  • SECRET_CODE_LENGTH: Number of characters that file code should contain, by default to 24 characters. int
  • BASE_URL: Base URL that bot should use while generating file links, can be FQDN and by default to 127.0.0.1. str
  • BIND_ADDRESS: Bind address for web server, by default to 0.0.0.0 to run on all possible addresses. str
  • PORT: Port for web server to run on, by default to 8080. int

πŸ•Ή Deployment

Note

This bot is designed for personal use or to share with friends and family only. It is not intended for mass public use or exposure to a large audience.

1.Running locally:

python -m bot

2.Using Docker: (Recommended)

  • Build own Docker image:
docker build -t file-stream-bot .
  • Run the Docker container:
docker run -p 8080:8080 file-stream-bot

⛑️ Need help!

  • Ask questions or doubts here.

❀️ Credits & Thanks

Dr.Caduceus: Owner & developer of File Stream Bot.

About

An open-source Python Telegram bot to transmit Telegram files over HTTP.

Topics

Resources

Stars

Watchers

Forks

Languages

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /