https://github.com/CodeXBotz/File-Sharing-Bot
Telegram Bot to store Posts and Documents and it can Access by Special Links.
https://github.com/CodeXBotz/File-Sharing-Bot
bot codexbotz filestore heroku koyeb pyrogram pyrogram-bot python python3 railway telegram telegram-bot telegram-bot-api
Last synced: 2 months ago
JSON representation
Telegram Bot to store Posts and Documents and it can Access by Special Links.
- Host: GitHub
- URL: https://github.com/CodeXBotz/File-Sharing-Bot
- Owner: CodeXBotz
- License: gpl-3.0
- Created: 2021-05-05T12:15:27.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-11-24T17:34:47.000Z (7 months ago)
- Last Synced: 2024-11-24T18:27:14.633Z (7 months ago)
- Topics: bot, codexbotz, filestore, heroku, koyeb, pyrogram, pyrogram-bot, python, python3, railway, telegram, telegram-bot, telegram-bot-api
- Language: Python
- Homepage: https://t.me/CodeXBotz
- Size: 259 KB
- Stars: 2,065
- Watchers: 24
- Forks: 5,704
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- Awesome - File-Sharing-Bot - Telegram Bot to store Posts and Documents and it can Access by Special Links. (Communication and Collaboration Tools)
- awesome-telegram - File sharing Bot
- awesome-telegram - File sharing Bot
README
# File-sharing-Bot
Telegram Bot to store Posts and Documents and it can Access by Special Links.
I Guess This Will Be Usefull For Many People.....😇.
### Features
- Fully customisable.
- Customisable welcome & Forcesub messages.
- More than one Posts in One Link.
- Can be deployed on heroku directly.
- Protect Content to Prevent Forwarding
- Auto-Delete Files After a Configurable Time
## What’s Next
These features are in the pipeline, and contributions from the community are welcome!
- [x] **Channel Join Request**
Implement a feature that prompts users to join a specified Telegram channel before accessing the bot's functionalities.
### How to Contribute
1. Check the [contribution guidelines](https://github.com/CodeXBotz/File-Sharing-Bot/blob/main/CONTRIBUTING.md) for detailed instructions.
2. Pick any feature and create a new issue or comment on an existing one.
3. Discuss your implementation plan with maintainers to align your contributions with project goals.
We encourage all developers to contribute ideas, report bugs, and share improvements. Together, we can make this project even better! 🚀
### Setup
- Add the bot to Database Channel with all permission
- Add bot to ForceSub channel as Admin with Invite Users via Link Permission if you enabled ForceSub
##
### Installation
#### Deploy on Heroku
**BEFORE YOU DEPLOY ON HEROKU, YOU SHOULD FORK THE REPO AND CHANGE ITS NAME TO ANYTHING ELSE**
[](https://heroku.com/deploy)
**Check This Tutorial Video on YouTube for any Help**
**Thanks to [Erich](https://t.me/ErichDaniken) and his [InFoTel](https://t.me/InFoTel_Group) for this Video**
#### Deploy on Railway
[](https://railway.app/new/template/1jKLr4)
#### Deploy on Koyeb
The fastest way to deploy the application is to click the **Deploy to Koyeb** button below.
[](https://app.koyeb.com/deploy?type=git&repository=github.com/CodeXBotz/File-Sharing-Bot&branch=koyeb&name=filesharingbot)
#### Deploy in your VPS
````bash
git clone https://github.com/CodeXBotz/File-Sharing-Bot
cd File-Sharing-Bot
pip3 install -r requirements.txt
#
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
* `APP_ID` Your API ID from my.telegram.org
* `TG_BOT_TOKEN` Your bot token from @BotFather
* `OWNER_ID` Must enter Your Telegram Id
* `CHANNEL_ID` Your Channel ID eg:- -100xxxxxxxx
* `DATABASE_URL` Your mongo db url
* `ADMINS` Optional: A space separated list of user_ids of Admins, they can only create links
* `START_MESSAGE` Optional: start message of bot, use HTML and fillings
* `START_PIC` Optional: URL or file path of the image to be sent as the start message
* `FORCE_SUB_MESSAGE`Optional:Force sub message of bot, use HTML and Fillings
* `FORCE_SUB_CHANNEL` Optional: ForceSub Channel ID, leave 0 if you want disable force sub
* `PROTECT_CONTENT` Optional: True if you need to prevent files from forwarding
* `AUTO_DELETE_TIME ` Set the time in seconds for automatic file deletion. Default is False, which disables auto-deletion.
* `JOIN_REQUEST_ENABLED` Optional: Set to "True" to enable join request for the channel. Default is "False".
### Extra Variables
* `AUTO_DELETE_MSG` put your custom deletion text if you want Setup Custom deletion messaeg,
* `AUTO_DEL_SUCCESS_MSG` Set your custom success message for when the file is successfully deleted
* `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
* `DATABASE_NAME` Your mongo db session name
### 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
## Support
Join Our [Telegram Group](https://www.telegram.dog/codexbotzsupport) For Support/Assistance And Our [Channel](https://www.telegram.dog/codexbotz) For Updates.
Report Bugs, Give Feature Requests There..
### Credits
- Thanks To Dan For His Awsome [Libary](https://github.com/pyrogram/pyrogram)
- Our Support Group Members
### Licence
[](http://www.gnu.org/licenses/gpl-3.0.en.html)
[FILE-SHARING-BOT](https://github.com/CodeXBotz/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](https://www.gnu.org/licenses/gpl.html) 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 ⭐⭐⭐**