Home
Softono
UxB-file-sharing

UxB-file-sharing

Open source Python
41
Stars
99
Forks
1
Issues
1
Watchers
1 year
Last Commit

About UxB-file-sharing

UxB-file-sharing is a specialized Telegram bot designed to store posts and documents, making them accessible to users via unique generated links. Built on the Ultroid framework, it enables administrators to manage content distribution efficiently while offering flexible deployment options including Heroku, Railway, Koyeb, and personal VPS. The bot supports advanced functionality such as token verification, which integrates with shortening services to require user verification before link access, adding a layer of monetization or access control. It features a mandatory three-channel force subscription system, requiring users to join up to three designated channels before they are allowed to interact with the bot and retrieve files. Additional capabilities include automatic media deletion to manage storage, batch link generation for multiple posts, and comprehensive administrative tools like user analytics, media broadcasting, and uptime monitoring. Configuration is handled through environment variables, allowi

Platforms

Web Self-hosted

Languages

Python

πŸ“ UxB-File-Sharing Bot

Bot

Ultroid Official Channel Ultroid Official Group

Telegram Bot to store posts and documents accessible via special links.

πŸš€ Overview

File Sharing Token Bot is a Telegram bot designed to store posts and documents, accessible through special links. This bot provides a convenient way to manage and share content within Telegram.

✨ Features

  • Store posts and documents.
  • Access content via special links.
  • Easy to deploy and customize.
  • Token Verifiction
  • 3 Force subs
  • Auto Deletion

πŸ› οΈ Setup

To deploy the bot, follow these steps:

  1. Add the bot to a database channel with all permissions.
  2. Add the bot to the ForceSub channel as an admin with "Invite Users via Link" permission if ForceSub is enabled.

πŸ“¦ Installation

Deploy on Heroku

Click the button below to deploy the bot on Heroku:

Deploy

For a detailed deployment guide, watch this tutorial video.

Deploy on Railway

Deploy on Railway

Deploy on Koyeb

Click the button below to deploy the bot on Koyeb:

Deploy to Koyeb

Deploy on Your VPS

git clone https://github.com/sahildesai07/UxB-file-sharing
cd file-sharing-token-bot
pip3 install -r requirements.txt
# <Create config.py appropriately>
python3 main.py

πŸ”§ Admin Commands

start - start the bot or get posts

batch - create link for more than one posts

genlink - create link for one post

users - view bot statistics

broadcast - broadcast any messages to bot users

stats - checking your bot uptime

πŸ› οΈ Variables

  • API_HASH Your API Hash from my.telegram.org tutorial video.
  • APP_ID Your API ID from my.telegram.org tutorial video.
  • TG_BOT_TOKEN Your bot token from @BotFather
  • OWNER_ID Must enter Your Telegram Id
  • CHANNEL_ID Your Channel ID eg:- -100xxxxxxxx
  • DB_URI Your mongo db url tutorial video.
  • DB_NAME Your mongo db session name
  • ADMINS Optional: A space separated list of user_ids of Admins, they can only create links
  • START_MSG Optional: start message of bot, use HTML and fillings
  • FORCE_SUB_MESSAGEOptional:Force sub message of bot, use HTML and Fillings
  • FORCESUB_CHANNEL Optional: ForceSub Channel ID, leave 0 if you want disable force sub
  • FORCESUB_CHANNEL2 Optional: ForceSub Channel ID, leave 0 if you want disable force sub
  • FORCESUB_CHANNEL3 Optional: ForceSub Channel ID, leave 0 if you want disable force sub
  • PROTECT_CONTENT Optional: True if you need to prevent files from forwarding

Token Variables

  • IS_VERIFY = Default : "True" (if you want off : False )
  • SHORTLINK_URL = Your shortner Url ( ex. "api.shareus.io")
  • SHORTLINK_API = Your shortner API (ex. "PUIAQBIFrydvLhIzAOeGV8yZppu2")
  • VERIFY_EXPIRE = ( ex. 86400)) # Add time in seconds

Extra Variables

  • CUSTOM_CAPTION put your Custom caption text if you want Setup Custom Caption, you can use HTML and fillings for formatting (only for documents)
  • DISABLE_CHANNEL_BUTTON Put True to Disable Channel Share Button, Default if False
  • BOT_STATS_TEXT put your custom text for stats command, use HTML and fillings
  • USER_REPLY_TEXT put your text to show when user sends any message, use HTML

Fillings

START_MESSAGE | FORCE_SUB_MESSAGE

  • {first} - User first name
  • {last} - User last name
  • {id} - User ID
  • {mention} - Mention the user
  • {username} - Username

CUSTOM_CAPTION

  • {filename} - file name of the Document
  • {previouscaption} - Original Caption

CUSTOM_STATS

  • {uptime} - Bot Uptime

πΆπ‘œπ‘šπ‘šπ‘Žπ‘›π‘‘π‘ 

/start - start the bot or get posts
/batch - create link for more than one posts
/genlink - create link for one post
/users - view bot statistics
/broadcast - broadcast any messages to bot users
/stats - checking your bot uptime

πŸ’¬ Support

Join Our Telegram Group For Support/Assistance And Our Channel For Updates.

Report Bugs, Give Feature Requests There..

πŸŽ‰ Credits

  • Thanks to ultroidxTeam for Modified this repo
  • Thanks to Dan for his awesome library. Libary Our support group members.

πŸ“ License

GNU GPLv3 GNU GPLv3 Image

FILE-SHARING-BOT is Free Software: You can use, study share and improve it at your will. Specifically you can redistribute and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Star this Repo if you Liked it ⭐⭐⭐