Giter Club home page Giter Club logo

broadcastbot's Introduction

๐˜ฝ๐™ง๐™ค๐™–๐™™๐™˜๐™–๐™จ๐™ฉ ๐˜ฝ๐™ค๐™ฉ

A simple Telegram bot that can broadcast messages and media to the bot subscribers using MongoDB.

Readme Card

Features

  • Support 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
  • API_ID - Get it from telegram.org
  • API_HASH - Get it from telegram.org
  • AUTH_USERS - Authorised user's ID to use Admin Commands {Split ๐Ÿ’” with a space}.
  • DB_URL - MongoDB Database URI get it from 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 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 ๐Ÿคญ

herokudeploy-01

Host Locally ๐Ÿค•

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

pyrogram

broadcastbot's People

Contributors

fayasnoushad avatar itz-fork avatar mrbotdeveloper avatar nikhileashy avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

broadcastbot's Issues

I don't understand i need help config

i use heroku to deploy
I don't understand what to put into VALUE box whn i fill AUTH_USERS
Also what to put into LOG_CHANNEL Value....?
Where is DB channel ID as you mention it from readme..
thanks

Docker

Hi dear NACBots

Please also provide the option to run in Docker.

Thank You

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.