An advanced and powerful administration bot based on yagop/telegram-bot licensed under the GNU General Public License.
- A powerful antispam system with custom sensitivity for each group
- Multiple realms (admin groups)
- Recalcitrant to any kind of spamming (X/Y bots, name/photo changers, etc.)
- Global banning
- Broadcast to all groups
- Group and links
- Kick, ban and unban by reply
- Groups, ban and global ban list
- Logging anything that happens in a group
- Invitation by username
- Group administration via private messages
- Only mods, owner and admin can add bots in groups
- Arabic lock
- Lock TgService
- Chat list
- And more!
<<<<<<< HEAD
TeleSeed has several commands that are only usable at certain ranks.
Command | Description |
---|---|
[#!/]id | Returns group/SuperGroup ID or user id in pm. |
[#!/]teleseed | Returns bot information. |
Command | Description |
---|---|
[#!/]help | Returns help text. |
[#!/]superhelp | Returns SuperGroup help text. |
[#!/]chats | Returns public chats in a message(s). |
[#!/]chatlist | Returns public chats in a .txt document. |
[#!/]join [GroupID] | Join a public chat by id |
Command | Description | Groups? | SuperGroups? |
---|---|---|---|
[#!/]info | Returns general info about the SuperGroup. | N | Y |
[#!/]admins | Returns SuperGroup admins list. | N | Y |
[#!/]modlist | Returns Moderator list. | Y | Y |
[#!/]owner | Returns group/SuperGroup owner. Can be used by any user | Y | Y |
[#!/]bots | Lists bots in SuperGroup. | N | Y |
[#!/]who | Lists all users in group *SuperGroup returns .txt document list. | Y | Y |
[#!/]wholist | Lists all users in group in .txt document. | Y | N |
[#!/]block | Kicks a user from SuperGroup Adds user to blocked list. | N | Y |
[#!/]kick | kicks user from group. | Y | N |
[#!/]ban | Bans user from the group/SuperGroup. | Y | Y |
[#!/]unban | Unbans user from group/SuperGroup. | Y | Y |
[#!/]id [username|reply] | For userID's: !id @username (ONLY IN SuperSroups) or reply !id in any group. |
Y | Y |
[#!/]id from | Returns ID of user a message is forwarded from. | N | Y |
[#!/]kickme | Kicks user from SuperGroup / In SuperGroup: Must be unblocked by owner or use #join by pm to return |
Y | Y |
[#!/]setowner | Sets group/SuperGroup owner. | Y | Y |
[#!/]promote | Promote a group/SuperGroup moderator. | Y | Y |
[#!/]demote | Demote a group/SuperGroup moderator. | Y | Y |
[#!/]setname | Set group/SuperGroup name. | Y | Y |
[#!/]setphoto | Set group/SuperGroup photo. | Y | Y |
[#!/]setrules | Set group/SuperGroup rules. | Y | Y |
[#!/]setabout | Sets the about section in chat info(members list) | N | Y |
[#!/]set about | Y | N | |
[#!/]save [value] | Sets extra info for group/SuperGroup by value. | Y | Y |
[#!/]get [value] | Returns extra info for group/SuperGroup by value. | Y | Y |
[#!/]newlink | Generate a new group/SuperGroup link. | Y | Y |
[#!/]setlink | Set a new SuperGroup link If bot is not creator. | N | Y |
[#!/]link | Retrieves the group/SuperGroup link. | Y | Y |
[#!/]rules | Retrieves the group/SuperGroup rules. | Y | Y |
[#!/]lock setting | Lock group/SuperGroup settings. | Y | Y |
[#!/]unlock setting | Unlock group/SuperGroup. | Y | Y |
[#!/]mute [mute]#mutes-mutes) | mute group message types. | Y | Y |
[#!/]unmute mute | unmute group message types. | Y | Y |
[#!/]setflood value | Set [value] as flood sensitivity. | Y | Y |
[#!/]muteuser [username|id|reply] | Mute and unmute a user in chat. If a muted user posts a message, the message is deleted automaically only owners can mute | mods and owners can unmute | Y | Y |
[#!/]mutelist | Returns list of muted users in group/SuperGroup. | Y | Y |
[#!/]muteslist | Returns mutes for group/SuperGroup. | Y | Y |
[#!/]settings | Returns a list of group/SuperGroup settings. | Y | Y |
[#!/]stats | Returns simple message statistics in a .txt document. | Y | Y |
[#!/]statslist | Returns simple message statistics in a message. | Y | Y |
[#!/]banlist | Returns group/SuperGroup banlist. | Y | Y |
[#!/]clean [rules|about|modlisthtml>|bots|mutelist] | Clears rules, about, modlist, bots, or mutelist | Y | Y |
[#!/]del | Deletes a message by reply. | N | Y |
[#!/]res [username] | Returns users name and id by username. | Y | Y |
[#!/]log | Returns group logs.In SuperGroups: Search for kick reasons using [#RTL|#spam|#lockmember] | Y | Y |
Command | Description | groups/SuperGroups? | In private? |
---|---|---|---|
[#!/]muteuser [username|id|reply] | Mute and unmute a user in chat.If a muted user posts a message, the message is deleted automaically / only owners can mute / mods and owners can unmute | N | |
[#!/]all | Returns all available information about current group. | Y | N |
[#!/]all [GroupID] | Returns all available information about group by GroupID. | Y | N |
[#!/]owners [GroupID] [kick|ban|unban] [UserID] | Kick, ban, or unban a user from a group by GroupID and UserID. | N | Y |
[#!/]owners [GroupID] clean [modlist|rules|about] | Clear options by GroupID. | N | Y |
[#!/]owners [GroupID] setflood [value] | Set flood for a group by GroupID and a value [1-5]. | N | Y |
[#!/]owners [GroupID] lock [setting] | Lock settings for a group by GroupID. | N | Y |
[#!/]owner [GroupID] unlock [setting] | Unlock settings for a group by GroupID. | N | Y |
[#!/]owners [GroupID] new link | Create a new group link by GroupID. | N | Y |
[#!/]owners [GroupID] get link | Returns group link by GroupID. | N | Y |
[#!/]changename [GroupID] [name] | Change a group's name by GroupID. | N | Y |
[#!/]changrules [GroupID] [rules] | Change a group's rules by GroupID. | N | Y |
[#!/]changeabout [GroupID] [about] | Change a group's about by GroupID. | N | Y |
[#!/]loggroup [GroupID] | get group logs by GroupID. | N | Y |
Command | Description | Groups? | SuperGroups? | Realms? |
---|---|---|---|---|
[#!/]creategroup [Name] | Create a group and add it to moderation.json. | Y | Y | Y |
[#!/]createrealm [Name] | Create a realm and remove it from moderation.json. | Y | Y | Y |
[#!/]add | Add a group to moderation.json. | Y | Y | Y |
[#!/]rem | Remove a group from moderation.json. | Y | Y | Y |
[#!/]rem [GroupID] | Remove a group from moderation by GroupID. | Y | Y | Y |
[#!/]setname [Name] | Set realm name. | N | -- | Y |
[#!/]setabout [group|sgroup] [GroupID] [Text] | Set a group's about text. | Y | Y | Y |
[#!/]setrules [group|sgroup] [GroupID] [Text] | Set a group's rules. | Y | Y | Y |
[#!/]lock [GroupID] [setting] | Lock a group's setting. | Y | Y | Y |
[#!/]lock [GroupID] [setting] | Lock a group's setting. | Y | Y | Y |
[#!/]unlock [GroupID] [setting] | Unlock a group's setting. | Y | Y | Y |
[#!/]who | Get a list of members in group/realm. | Y | Y | Y |
[#!/]wholist | Get a .txt document list of members in group/realm. | Y | Y | Y |
[#!/]type | Get group type. | Y | Y | Y |
[#!/]addlog | Add a Log_SuperGroup for GBan log. | N | Y | N |
[#!/]remlog | Remove a Log_SuperGroup for GBan log. | N | Y | N |
[#!/]kill chat [GroupID] | Kick all users and remove a group from moderation. | Y | Y | Y |
[#!/]kill realm [RealmID] | Kick all users and remove a realm from moderation. | Y | Y | Y |
[#!/]banall [id|usename] | Ban a user from all moderated groups where bot is an admin (#global_ban) | Y | Y | Y |
[#!/]unbanall [id|usename] | Unban a user from all moderated groups where bot is an admin (#global_ban) | Y | Y | Y |
[#!/]gbanlist [id|usename] | Returns a list of all globally banned user | Y | Y | Y |
[#!/]list groups | Returns a list of all groups. | Y | Y | Y |
[#!/]list realms | Returns a list of all realms. | Y | Y | Y |
[#!/]whitelist | User/Bot will not be subject to message checks. | Y | Y | Y |
[#!/]support | Promote user to support. | Y | Y | Y |
[#!/]-support | deomote user from support. | Y | Y | Y |
[#!/]pm [UserID] | Sends a private message to a user by UserID. | Y | Y | Y |
[#!/]import | Bot joins a group by GroupLink. | Y | Y | Y |
[#!/]pmblock [UserID] | Block a user from bot private message and bot photo. | Y | Y | Y |
[#!/]pmunblock [UserID] | Unblock a user from bot private message and bot photo. | Y | Y | Y |
[#!/]markread [on|off] | Toggle bot to doubble check or not doubble check messages. | Y | Y | Y |
[#!/]setbotphoto | Set bot photo. | Y | Y | Y |
[#!/]contactlist | Bot will generate a list of all it's contacts***and send it by private message of command sender | Y | Y | Y |
[#!/]dialoglist | Bot will generate a list of all it's private message users***and send it by private message of command sender | Y | Y | Y |
[#!/]delcontact | Delete bot contact. | Y | Y | Y |
[#!/]reload | Reloads all bot plugins | Y | Y | Y |
[#!/]updateid | Adds long_id to moderation data for groups. | Y | Y | Y |
[#!/]!bc [GroupID] [text] | This command will send text to [GroupID] | Y | Y | Y |
[#!/]leave | Bot will leave that group and can only be re-invited by an admin with bot phone number | Y | Y | Y |
[#!/]mp | (Mod Promote) Set user as a mod of supergroup. TESTING | N | Y | N |
[#!/]md | (Mod demote) Removes user from mod of supergroup. TESTING | N | Y | N |
Command | Groups? | SuperGroups? | Realms? |
---|---|---|---|
[#!/]addadmin [id|username] | Set a user as bot admin. | Y | Y |
[#!/]removeadmin [id|username] | Remove a user from bot admin. | Y | Y |
[#!/]sync_gbans | Sync your GBans with official @TeleSeed | Y | Y |
Command | Groups? | SuperGroups? |
---|---|---|
[#!/](un)lock links | Y | Y |
[#!/](un)lock flood | Y | Y |
[#!/]setflood [5-20] | Y | Y |
[#!/](un)lock bots | Y | N |
[#!/](un)lock spam | Y | Y |
[#!/](un)lock arabic | Y | Y |
[#!/](un)lock member | Y | Y |
[#!/](un)lock leave | Y | N |
[#!/](un)lock RTL | Y | Y |
[#!/](un)lock tgservice | N | Y |
[#!/](un)lock sticker | Y | Y |
[#!/]public [yes|no] | Y | Y |
[#!/](un)lock strict | N | Y |
/lock [setting] and /unlock [setting]: sets allowed actions and content for groups/SuperGroups /lock strict in a supergroup, if strict is locked users will be kicked for violations of settings or mutes
/public [yes|no]: Set group/SuperGroup visibility in pm !chats
or !chatlist
commands.
Command |
---|
[#!/]mute audio |
[#!/]mute video |
[#!/]mute photo |
[#!/]mute documents |
[#!/]mute gifs |
[#!/]mute text |
[#!/]mute all |
Groups: If "muted" message type: user is kicked if message type is posted
**SuperGroups: A "muted" message type is auto-deleted if posted **
Rank | Description |
---|---|
Banned | Cannot enter the group(s). |
User | Default rank. |
Moderator | Can set settings and kick/ban/unban users from a group. Can unmute users. |
Owner | Can mute users. Can promote/demote moderators. Can set SuperGroup admins. |
Support | Can globally unban users. Acts as owner of all groups. |
Administrator | Can globally ban/unban users. Can promote/demote owners. |
Sudo | Can add[#!/]remove groups. Can broadcast. Can promote/demote administrators. |
Each higher status inherits the privileges of the lower status.
**You can use "#", "!", or "/" to begin all commands
======= Table of Contents
- TeleSeed
- Features
- Commands
- Admins commands
- Group settings in realm
- Global ban commands
- Owner and mod commands
- Hammer
- Locking a group's name/members/bots/arabic/flood
- Unlocking a group's name/members/bots/arabic/flood
- Cleaning a group's modlist/rules/about/members
- Seting a group's rules/about
- Setting or changing a group's owner
- Setting or changing a group's photo
- Changing a group's name
- Group links
- Promoting and demoting mods
- Resolving usernames
- Flood sensitivity
- Group rules and about
- Group settings
- Modlist
- Help
- Owner
- Save and Get
- Id
- Group stats
- Member list
- Group help
- In private commands
- Installation
- Support and development
- Special thanks to:
- Our team!
Only admins and sudo users can run these commands.
[!/]creategroup [group name]
[!/]creategroup SEED
will create a group
Only works in realms for admins but, sudo users can use it everywhere
[!/]createrealm [realm name]
[!/]createrealm SEED
will create a realm
Only works in realms for admins but, sudo users can use it everywhere
[!/]add realm
This command will add that group
[!/]rem realm
This command will remove that group
[!/]add
This command will add that group
[!/]rem
This command will remove that group
[!/]leave
Bot will leave that group
[!/]all
This command will return everything about that group
[!/]all [group_id]
Only onwer, admin and sudo users can use this command
[!/]setabout [group_id] [text]
[!/]setabout 123456789 about
This command will set [text] as description of [group_id]
[!/]setname [group_id] [text]
[!/]setname 123456789 SEED
This command will set [text] as name of [group_id]
[!/]setrules [group_id] [text]
[!/]setrules 123456789 rules !
This command will set [text] as rules of [group_id]
[!/]lock [group_id] [name|flood|photo|member]
[!/]lock 123456789 name
This command will lock name|flood|photo|member of [group_id]
[!/]unlock [group_id] [name|flood|photo|member]
[!/]unlock 123456789 name
This command will unlock name|flood|photo|member of [group_id]
[!/]setting [group_id]
[!/]setting 12345678
This command will return settings of [group_id]
[!/]addadmin [username]
[!/]addadmin @username
This command will add username as admin
Only works in realms
[!/]removeadmin [username]
[!/]removeadmin @username
This command will add username as admin
Only works in realms [username]
[!/]list [admins|groups]
[!/]list groups
This command will return admins|groups list
[!/]broadcast [text]
[!/]broadcast Hello !
This command will send text to all groups
Only sudo users can run this command
[!/]bc [group_id] [text]
[!/]bc 123456789 Hello !
This command will send text to [group_id]
[!/]banall [id]
[!/]banall 123456789
This commands will globally ban [id]
/sync_gbans
Sync your global bans with teleseed
[!/]unbanall [id]
[!/]unbanall 123456789
This commands will remove [id] from global bans
[!/]gbanlist
This command will return global bans ids
[!/]banlist [group_id]
[!/]banlist 123456789
This command will return banned user of [group_id]
[!/]setgpowner [group_id] [User_id]
[!/]setgpowner 123456789 987654321
This command will set [User_id] as the owner of [group_id]
[!/]stats teleseed
This command will return bot stats
[!/]help
Get realm commands list
Sudo users and admins can also use this commands in all groups
[!/]kick [username|id]
[!/]kick @useranme [!/]kick 123456789
This command will remove that user
[!/]ban [username|id]
[!/]ban @username [!/]ban 123456789
this command will ban and remove that user
[!/]unban [id]
[!/]unban 12345678
This command will unban that user
[!/]banlist
This command will return bans list
[!/]lock [name|member|arabic|flood|bots]
[!/]lock flood
This command will lock name|member|arabic|flood|bots of groups
[!/]unlock [name|member|arabic|flood|bots]
[!/]unlock flood
This command will unlock name|member|arabic|flood|bots of groups
[!/]clean [modlist|rules|about|member]
[!/]clean modlist
This command will clean modlist|rules|about|member /clean member will kick all users except owner,admins and bot and it's for owners only
[!/]set [rules|about] [text]
[!/]set rules don't spam!
No NSFW
This command will set [text] as the rules|about of groups
[!/]setowner [id]
[!/]setowner 123456789
This command will set id as owner of that group
[!/]setphoto
This command will change or set group photo also locks photo
[!/]setname [name]
[!/]setname SEED
This command will set [name] as name of groups
[!/]newlink
This command will revoke group link
[!/]link
This command will return group link
[!/]promote [username]
[!/]promote @username
This command will promote @username as moderator
[!/]demote [username]
[!/]demote @username
This command will demote @username
[!/]res [username]
[!/]res @username
This command will return info about that username
[!/]setflood [value]
[!/]setflood 15
will set flood sensitivity to [value]
[!/]about
This command will return group description
[!/]rules
This command will return group rules
normal users can use it too
[!/]setting
This command will return group settings
[!/]modlist
This command will return group moderators
normal users can use it too
[!/]help
[!/]owner
This command will return owners id
[!/]save [title] [text]
[!/]save spam Don't spam !
This command will save text as that title
[!/]get [title]
[!/]get spam
This command will return text of that title
[!/]id
This command will return user or group id can be triggered by reply
Normal users can use it
[!/]stats
This command will return group message statistic in a .txt file
[!/]statslist
This command will return group message statistic
[!/]who
This command will return member list in a .txt file
[!/]wholist
This command will return member list
[!/]help
Get commands list
These commands only works in bots private
[!/]owners group_id [kick|ban|unban] user_id
[!/]owners 1234567 kick 1234567
[!/]owners group_id clean [modlist|rules|about]
[!/]owners 1234567 clean modlist
[!/]owners group_id setflood value
[!/]owners 1234567 setflood 17
[!/]owners group_id lock [member|name]
[!/]owners 1234567 lock member
[!/]owner group_id unlock [member|name]
[!/]owners 1234567 unlock name
[!/]owners group_id get link
[!/]owners 1234567 get link
[!/]owners group_id new link
[!/]owners 1234567 new link
[!/]changename [group_id] [name]
[!/]changename 123456789 SEED
[!/]changrules [group_id] [rules]
[!/]changrules 123456789 rules !
[!/]changeabout [group_id] [about]
[!/]changeabout 123456789 about !
[!/]loggroup [group_id]
[!/]loggroup 123456789
[!/]oin [group_id]
This command will add user in [group_id]
U can use both "/" and "!"
refs/remotes/origin/master
# Install dependencies.
# Tested on Ubuntu 14.04. For other OSs, check out https://github.com/yagop/telegram-bot/wiki/Installation
<<<<<<< HEAD
sudo apt-get install libreadline-dev libconfig-dev libssl-dev lua5.2 liblua5.2-dev lua-socket lua-sec lua-expat libevent-dev make unzip git redis-server autoconf g++ libjansson-dev libpython-dev expat libexpat1-dev
=======
sudo apt-get install libreadline-dev libconfig-dev libssl-dev lua5.2 liblua5.2-dev libevent-dev make autoconf unzip git redis-server g++ libjansson-dev libpython-dev expat libexpat1-dev
>>>>>>> refs/remotes/origin/master
# Let's install the bot.
cd $HOME
git clone https://github.com/SEEDTEAM/TeleSeed.git -b supergroups
cd TeleSeed
chmod +x launch.sh
./launch.sh install
./launch.sh # Enter a phone number & confirmation code.
To install everything in one command (useful for VPS deployment) on Debian-based distros, use:
#https://github.com/yagop/telegram-bot/wiki/Installation
<<<<<<< HEAD
sudo apt-get update; sudo apt-get upgrade -y --force-yes; sudo apt-get dist-upgrade -y --force-yes; sudo apt-get install libreadline-dev libconfig-dev libssl-dev lua5.2 liblua5.2-dev lua-socket lua-sec lua-expat libevent-dev libjansson* libpython-dev make unzip git redis-server g++ autoconf -y --force-yes && git clone https://github.com/SEEDTEAM/TeleSeed.git -b supergroups && cd TeleSeed && chmod +x launch.sh && ./launch.sh install && ./launch.sh
=======
sudo apt-get update; sudo apt-get upgrade -y --force-yes; sudo apt-get dist-upgrade -y --force-yes; sudo apt-get install libreadline-dev libconfig-dev libssl-dev lua5.2 liblua5.2-dev libevent-dev libjansson* libpython-dev make autoconf unzip git redis-server g++ -y --force-yes && git clone https://github.com/SEEDTEAM/TeleSeed.git && cd TeleSeed && chmod +x launch.sh && ./launch.sh install && ./launch.sh
>>>>>>> refs/remotes/origin/master
After you run the bot for first time, send it !id
. Get your ID and stop the bot.
Open ./data/config.lua and add your ID to the "sudo_users" section in the following format:
sudo_users = {
110626080,
103649648,
111020322,
0,
YourID
}
Then restart the bot.
Create a realm using the !createrealm
command.
Creating a LOG SuperGroup -For GBan Log
1. Create a group using the `!creategroup` command.
2. Add two members or bots, then use `#Tosuper` to convert to a SuperSroup.
3. Use the `#addlog` command and your ***LOG SuperGroup(s)*** will be set.
Note: you can set multiple Log SuperGroups
Check out this tutorial by Telegram Geeks for further assistance with setup and installation.
Do not contact us in private for support.
Join our bot development group by sending /join 1047524697
to @TeleSeed
For managing @teleseed on Telegram.
For graphic designs.
English: @TeleSeedCH
Persian: @IranSeed