Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nacbots/broadcastbot
A simple Telegram bot that can broadcast messages and media to the bot subscribers. with mongo DB support
https://github.com/nacbots/broadcastbot
bot broadcast broadcast-bot heroku heroku-app mongo mongodb nacbots pyrogram python-telegram-bot telegram telegram-bot
Last synced: 7 days ago
JSON representation
A simple Telegram bot that can broadcast messages and media to the bot subscribers. with mongo DB support
- Host: GitHub
- URL: https://github.com/nacbots/broadcastbot
- Owner: NACBots
- Created: 2021-09-08T14:15:19.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-01-20T06:02:19.000Z (about 1 year ago)
- Last Synced: 2025-01-07T23:11:20.548Z (14 days ago)
- Topics: bot, broadcast, broadcast-bot, heroku, heroku-app, mongo, mongodb, nacbots, pyrogram, python-telegram-bot, telegram, telegram-bot
- Language: Python
- Homepage: http://t.me/NACBots
- Size: 60.5 KB
- Stars: 100
- Watchers: 2
- Forks: 157
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 𝘽𝙧𝙤𝙖𝙙𝙘𝙖𝙨𝙩 𝘽𝙤𝙩
A simple Telegram bot that can broadcast messages and media to the bot subscribers using [MongoDB](https://mongodb.com).
[](https://github.com/nacbots/broadcastbot&bg_color=#24292F)
## Features
- Support [mongodb.com](https://mongodb.com) database 📁 for user's record 📹.
- User's can choose whether to enable Broadcast messages or not using `/settings` commands.
- Logs New User's in any channel.
- Get total user's count in Database.
- Ban and UnBan any user.
## Required Configs
- `BOT_TOKEN` - Get from [@BotFather](https://t.me/BotFather)
- `API_ID` - Get it from [telegram.org](https://my.telegram.org/auth)
- `API_HASH` - Get it from [telegram.org](https://my.telegram.org/auth)
- `AUTH_USERS` - Authorised user's ID to use [Admin Commands](https://github.com/nacbots/broadcastbot#admin-commands) {Split 💔 with a space}.
- `DB_URL` - MongoDB Database URI get it from [mongodb.com](https://mongodb.com)
- This for Saving UserIDs. When you will Broadcast, bot will forward the Broadcast to DB Users.
## Optional Configs
- `LOG_CHANNEL` - Log Channel ID to get new user notifications.
- This for some getting user info. If any new User added to DB, Bot will send Log to that Logs Channel. You can use same DB Channel ID.
- `BROADCAST_AS_COPY` - Value should be `True` or `False`.
- If `True` broadcast messages will be forwarder *As Copy*. If `False` broadcast messages will be forwarded with Forward Tag.
- `DB_NAME` - [mongodb.com](https://mongodb.com) Collection name to be used.
## User's Commands 😉
```
start - Start the bot 🥲
settings - Customise settings
```
## Admin Commands 🤫
```
stats - Total User Number in Database
broadcast - Reply to Message to Broadcast
ban_user - Ban A User with time & reason
unban_user - Unban a User
banned_users - Show Banned Users
```
## Deploy 🚀
### Easiest Heroku Deploy 🤭
### Host Locally 🤕
```shell
git clone https://github.com/nacbots/BroadcastBot
cd BroadcastBot
pip3 install -r requirements.txt
# EDIT config.py values appropriately
python3 main.py
```
## Support Group:
## Found a Bug 🐛
```Feel free to create a pull or create a issue now and describe your issue freely.```
## Credits
- [@odysseusmax](https://github.com/odysseusmax)
- [@NikhilEashy](https://github.com/nikhileashy)
- [@MrBotDeveloper](https://github.com/MrBotDeveloper")
