HandbookGetting started

All commands

264 commands42 modules

Every command Marina understands, on one page. Type to filter, or open one for the full story.

Command	Module	What it does
/start	Bot basics	In private chat: a hello, the module menu and the Add me to a group button.
/help	Bot basics	The module menu. In a group, a button that opens it in private.
/help <module or command>	Bot basics	Opens one topic straight away. Works with command names too.
/about	Bot basics	In private chat: what Marina is and who runs her.
/privacy	Bot basics	Her privacy policy, and a menu to see, download or delete your data.
/donate	Bot basics	How to support the project.
/markdownhelp [topic]	Formatting & buttons	This guide inside Telegram, or one topic of it. Also /formatting.
/connect <chat id or @username>	Connections	In private chat, connect to that group.
/connect	Connections	Alone in private: pick a recent group. In a group: a button that connects you in private.
/disconnect	Connections	End the current connection.
/reconnect	Connections	Pick one of your recent groups again.
/connection	Connections	Which group you're connected to, and what you can do there. Also /connections.
/allowconnect <on/off>	Connections	Let regular members connect, or keep it for admins. On by default.
/settings	Settings	An overview of the group, module by module. In a group she offers to open it in private. Also /config.
/checkup	Settings	Lists features that can't work with her current rights, and how to fix each one.
/adminlist	Admin	The owner and admins, with their titles. Also /admins.
/promote <user> [title]	Admin	Makes someone an admin who can change info, delete, ban, invite and pin.
/lowpromote <user> [title]	Admin	A lighter admin: delete, invite and pin only.
/midpromote <user> [title]	Admin	Like /promote, plus video chats and topics.
/fullpromote <user> [title]	Admin	Every right Marina can give, including adding admins.
/demote <user>	Admin	Removes all admin rights.
/title <user> <title>	Admin	Sets a custom title, up to 16 characters without emoji.
/admincache	Admin	Reloads the admin list now, after someone was promoted by hand. Once every 10 minutes.
/adminerror <on/off>	Admin	Tell members when they try an admin command. On by default.
/anonadmin <on/off>	Admin	Let anonymous admins use commands without confirming who they are. Off by default.
/kickme	Bans	Leave the group. You can come back any time. Not for admins.
/ban <user> [time] [reason]	Bans	Bans someone, even if they aren't in the group. Permanent unless you add a time.
/tban <user> <time> [reason]	Bans	Bans for a set time.
/dban [time] [reason]	Bans	Reply to a message: ban its sender and delete it.
/sban <user> [time] [reason]	Bans	Bans without a notice in the chat.
/unban <user>	Bans	Lifts a ban. Works on channels too.
/mute <user> [time] [reason]	Bans	Stops someone from sending messages. They can still read.
/tmute <user> <time> [reason]	Bans	Mutes for a set time.
/dmute [time] [reason]	Bans	Reply to a message: mute its sender and delete it.
/smute <user> [time] [reason]	Bans	Mutes without a notice.
/unmute <user>	Bans	Lets a muted member talk again.
/kick <user> [reason]	Bans	Removes someone without banning them.
/dkick [reason]	Bans	Reply to a message: kick its sender and delete it.
/skick <user> [reason]	Bans	Kicks without a notice.
/warns	Warnings	Your own active warnings. Admins can add a user to see theirs.
/warn <user> [reason]	Warnings	Warns a member.
/dwarn [reason]	Warnings	Reply to a message: warn its sender and delete it.
/swarn <user> [reason]	Warnings	Warns without a notice. The log channel still gets it.
/rmwarn <user>	Warnings	Removes someone's latest warning. Also /unwarn.
/resetwarn <user>	Warnings	Clears all of someone's warnings. Also /resetwarns.
/warnings	Warnings	The group's limit, mode and expiry time.
/warnlimit [number]	Warnings	Shows or sets the limit, from 1 to 50. Default 3. Also /setwarnlimit.
/warnmode [mode] [time]	Warnings	What happens at the limit: `ban`, `kick`, `mute`, `tban` or `tmute`. Also /setwarnmode.
/warntime [time/off]	Warnings	How long warnings last. Default off: forever. Also /setwarntime.
/resetallwarns	Warnings	Wipes every warning in the group, after you confirm.
/purge [count] [reason]	Purges	Reply to a message: delete it and everything after it, or only that many messages.
/spurge [count]	Purges	Like /purge, without the notice.
/del	Purges	Reply to a message to delete just that one.
/purgefrom	Purges	Reply to the first message of a range to mark it. The command disappears straight away.
/purgeto	Purges	Reply to the other end to delete the whole range, both ends included.
/pinned	Pins	The current pinned message, with a button to jump to it.
/pin [loud]	Pins	Reply to a message to pin it. Quiet unless you add `loud`, `violent` or `notify`.
/unpin	Pins	Unpins the message you reply to, or the latest pin.
/unpinall	Pins	Unpins everything, after you confirm. Only you can confirm your own.
/permapin <text>	Pins	Posts the text as Marina and pins it. Reply to a message to repost it instead.
/antichannelpin <on/off>	Pins	Unpin linked-channel posts as soon as Telegram pins them.
/cleanlinked <on/off>	Pins	Delete posts that arrive from the linked channel. Also /cleanlinkedchannel.
/report [reason]	Reports	Reply to a message to report it. Without a reply, it calls the admins.
@admin	Reports	Anywhere in a message, the same as /report. Also `@admins`.
/reports <on/off>	Reports	Allow or block reports. Send it alone to see the setting.
/approval [user]	Approval	Whether you (or someone) are approved, and why.
/approve <user> [reason]	Approval	Approves a member. The reason shows in /approval and /approved.
/unapprove <user>	Approval	Removes an approval. Also /disapprove.
/approved	Approval	Lists approved members. Long lists arrive as a file.
/unapproveall	Approval	Removes every approval, after you confirm. Also /disapproveall.
/disable <commands>	Disabling	Switches off one or more commands for members.
/enable <commands>	Disabling	Switches them back on.
/disabled	Disabling	The commands that are off here.
/disableable	Disabling	Every command that can be switched off.
/disabledel <on/off>	Disabling	Also delete messages that try a disabled command. Off by default.
/disableadmin <on/off>	Disabling	Make disabled commands apply to admins too. Off by default.
/actiontopic	Topics	The topic Marina's automatic messages go to.
/actiontopic off	Topics	Send them back to General.
/setactiontopic	Topics	Makes the current topic the action topic.
/newtopic <name>	Topics	Creates a topic, one a minute. Also /createtopic.
/renametopic <name>	Topics	Renames the current topic.
/closetopic	Topics	Closes the current topic so only admins can post.
/reopentopic	Topics	Opens it again. Also /opentopic.
/deletetopic	Topics	Deletes the topic and all its messages, after you confirm. There's no undo.
/captcha <on/off>	CAPTCHA	Turns CAPTCHAs on or off. Also /welcomemute.
/captchamode <mode>	CAPTCHA	`button`, `math`, `text` or `text2`.
/captcharules <on/off>	CAPTCHA	Newcomers must also accept the rules before they can talk.
/captchamutetime <time/off>	CAPTCHA	Unmute unsolved members after this long. Also /captchatime.
/captchakick <on/off>	CAPTCHA	Kick members who don't solve it in time.
/captchakicktime <time>	CAPTCHA	How long they get before the kick. Default 5 minutes, at most a day.
/recaptcha <on/off>	CAPTCHA	Test everyone who joins, even people who passed here before.
/setcaptchatext <text>	CAPTCHA	Changes the text on the CAPTCHA button.
/resetcaptchatext	CAPTCHA	Back to the default button text.
/flood	Antiflood	The current settings. Also /antiflood.
/setflood <number/off>	Antiflood	Act on this many messages in a row, 1 to 100.
/setfloodtimer <count> <time>	Antiflood	Act on this many messages within a time, 3 seconds to 1 hour. Also /setfloodtime.
/floodmode <action> [time]	Antiflood	`ban`, `mute`, `kick`, `tban` or `tmute`. Also /setfloodmode.
/clearflood <on/off>	Antiflood	Also delete the flood messages. Also /floodclear.
/antiraid	Antiraid	Whether raid mode is on, with a button to switch it. Also /raidmode.
/antiraid <time>	Antiraid	Offers to switch it on for that long.
/antiraid off	Antiraid	Switches raid mode off straight away.
/raidtime [time]	Antiraid	How long raid mode stays on. Default 6 hours.
/raidactiontime [time]	Antiraid	How long raiders are banned. Default 1 hour.
/autoantiraid [number/off]	Antiraid	Turn raid mode on when more than this many join in a minute. Also /setautoantiraid.
/lock <types>	Locks	Locks one or more types.
/lock <types> ### [reason] [{action}]	Locks	Locks with a custom reason and action.
/unlock <types>	Locks	Unlocks them. `/unlock all` unlocks everything.
/locks	Locks	What's locked, with custom reasons and actions. `/locks list` shows every type.
/locktypes	Locks	Every lock type with a short explanation.
/lockwarns [on/off]	Locks	Also warn members who send locked content. Off by default.
/antichannelmode <on/off>	Locks	Delete messages sent as a channel and ban the channel. Also /antichannel.
/allowlist [items]	Locks	Lets specific things past the locks. Alone, shows the list. Also /whitelist.
/rmallowlist <items>	Locks	Takes items off the allowlist. Also /unallowlist.
/rmallowlistall	Locks	Clears the whole allowlist, after you confirm.
/addblocklist <item> [reason]	Blocklists	Blocks an item. Quote phrases; put several in brackets. Also /addblacklist.
/rmblocklist <item>	Blocklists	Unblocks one or more items. Also /unblocklist.
/blocklist	Blocklists	Lists the items. Also /blacklist.
/blocklistmode [action] [time]	Blocklists	The action for senders. Default `nothing`: just delete.
/blocklistdelete [on/off]	Blocklists	Whether matches are deleted. On by default. Also /blocklistdel.
/setblocklistreason [reason]	Blocklists	The default reason. `{trigger}` is the matched item.
/resetblocklistreason	Blocklists	Back to the built-in reason.
/blocklistcheck <user or name>	Blocklists	Tests a member or name against the name items. Nobody is punished.
/unblocklistall	Blocklists	Removes every item, after you confirm.
/autoapprove <mode>	Join Control	What happens to join requests. Alone, shows the mode.
/dnd <on/off>	Join Control	Remove people without a username. Also /nousername.
/nightmode	Night Mode	The settings, with an on/off button. Also /night.
/nightmode <on/off>	Night Mode	Switches night mode on or off.
/nightmode <start>-<end>	Night Mode	Sets the night: `23:00-07:00` or `11pm-7am`.
/nightmode tz <timezone>	Night Mode	Sets the timezone: `+5:30`, `UTC-4` or `IST`.
/cleancommand <types>	Clean Commands	Start deleting these kinds of commands. Alone, shows the setting.
/keepcommand <types>	Clean Commands	Stop deleting them. Also /nocleancommand.
/cleancommandtypes	Clean Commands	Explains each command type.
/cleanmsg <types>	Clean Commands	Delete these kinds of Marina's messages after a while.
/keepmsg <types>	Clean Commands	Keep them again.
/cleanmsgtypes	Clean Commands	Explains each message type.
/cleanmsgtime <time>	Clean Commands	How long her messages stay, from 1 minute to 47 hours. Default 5 minutes.
/cleanservice <types>	Clean Service	Start deleting these notices. Alone, shows the setting.
/cleanservice <on/off>	Clean Service	All types, or none.
/keepservice <types>	Clean Service	Stop deleting these. Also /nocleanservice.
/cleanservicetypes	Clean Service	Explains each type. Also /servicetypes.
/newfed <name>	Federations	Creates your federation, in private chat. One per person. Also /fnew.
/renamefed <name>	Federations	Renames it. Also /frename.
/delfed	Federations	Deletes it, after you confirm. Existing bans stay. Also /fdel.
/fedtransfer <user>	Federations	Hands it to someone else; they accept, you confirm. Also /ftransfer.
/fedpromote <user>	Federations	Invites a fed admin. They join once they accept. Also /fpromote.
/feddemote <user>	Federations	Removes a fed admin or withdraws an invite. Also /fdemote.
/fednotif <on/off>	Federations	A private copy of every fed ban and unban. Also /fnotif.
/fedreason <on/off>	Federations	Require a reason for every fed ban. Also /freason.
/subfed <fedid>	Federations	Apply another federation's bans too, up to five. Also /fedsub.
/unsubfed <fedid>	Federations	Stop applying them. Also /fedunsub.
/fedexport [format]	Federations	Download the ban list: `csv`, `minicsv`, `json` or `human`. Also /fexport.
/fedimport [overwrite/keep] [format]	Federations	Import a ban list from a file. Also /fimport.
/setfedlog	Federations	Send federation actions to a group or channel. /unsetfedlog stops it.
/setfedlang	Federations	The log's language. Also /fedlang.
/fban <user> [reason]	Federations	Bans someone in every group of the federation. Also /fedban.
/unfban <user> [reason]	Federations	Lifts a fed ban. Also /unfedban, /funban.
/fedchats [fedid]	Federations	The groups in a federation, sent in private.
/myfeds	Federations	The federations you own or help run.
/feddemoteme <fedid>	Federations	Step down as fed admin. Also /fdemoteme.
/fedinfo [fedid]	Federations	Details of a federation.
/fedadmins [fedid]	Federations	Its owner and admins.
/fedsubs [fedid]	Federations	Its subscriptions, both ways.
/fedstat [user] [fedid]	Federations	Where you or someone is fed banned. Also /fstat, /fbanstat.
/chatfed	Federations	The federation this group belongs to.
/joinfed <fedid>	Federations	Adds the group to a federation, or moves it.
/leavefed	Federations	Takes the group out of its federation.
/quietfed <on/off>	Federations	Remove fed-banned members who speak without posting a notice. People who join while fed banned are always removed quietly.
/welcome <on/off>	Greetings	Welcome messages on or off. Alone, shows the settings and current welcome.
/goodbye <on/off>	Greetings	The same for goodbyes. Both start on.
/setwelcome <text>	Greetings	Sets the welcome. Or reply to a message to use it, media included.
/setgoodbye <text>	Greetings	Sets the goodbye the same way.
/resetwelcome	Greetings	Back to the default welcome. /resetgoodbye does the same for goodbyes.
/cleanwelcome <on/off>	Greetings	Delete old welcomes automatically.
/get <name>	Notes	Sends a note. As a reply, answers that message with it.
#name	Notes	The same, as the first word of any message.
/notes	Notes	The notes saved here. Also /saved.
/save <name> [text]	Notes	Saves a note, or reply to a message or media to save it.
/clear <name>	Notes	Deletes a note.
/privatenotes <on/off>	Notes	Send notes through a button to private chat. Off by default.
/clearall	Notes	Deletes every note, after you confirm.
/filters	Filters	Every trigger saved here.
/filter <trigger> <reply>	Filters	Saves a filter. Reply to a message to use it as the reply.
/stop <trigger>	Filters	Removes a filter.
/stopall	Filters	Removes every filter, after you confirm.
/rules	Rules	Shows the rules. As a reply, points someone at them.
/setrules <text>	Rules	Sets the rules. Or reply to a message to use it, buttons and media included.
/resetrules	Rules	Removes the rules. Also /clearrules.
/privaterules <on/off>	Rules	Send the rules in private through a button. On by default.
/setrulesbutton <text>	Rules	Changes the button label, up to 40 characters.
/resetrulesbutton	Rules	Back to "Rules".
/repeat <interval> [now] <text>	Recurring	Posts a message every interval. Reply to a message to repeat it. `now` posts the first copy at once.
/repeats	Recurring	Lists them, with a button to manage each. Also /recurring.
/editrepeat <id> <interval>	Recurring	Changes the interval, or the message if you give text or reply.
/pauserepeat <id>	Recurring	Pauses one.
/resumerepeat <id>	Recurring	Resumes it on its usual rhythm.
/repeatnow <id>	Recurring	Posts it right now; the schedule stays.
/stoprepeat <id>	Recurring	Deletes it. Also /delrepeat.
/stopallrepeats	Recurring	Deletes them all, after you confirm.
/say <text>	Announcements	Posts the text as Marina. Also /echo, /send.
/say	Announcements	As a reply: reposts that message as Marina's own.
/say <text>	Announcements	As a reply with text: Marina's answer to that message.
/editmsg <new text>	Announcements	Reply to a /say or /permapin post to replace its text and buttons. Also /edit.
/setlog	Log Channels	Links a log channel (see above).
/unsetlog	Log Channels	Stops logging and forgets the channel.
/logchannel	Log Channels	The linked channel and what's logged.
/log <categories>	Log Channels	Logs these categories again, or `all`.
/nolog <categories>	Log Channels	Stops logging these categories, or `all`.
/logcategories	Log Channels	What each category covers.
/logsettings	Log Channels	Switch categories with buttons.
/export [categories]	Import/Export	Sends the group's configuration as a file, all of it or some categories.
/import [categories]	Import/Export	Reply to an export file to load it. The format is detected automatically.
/reset	Import/Export	Wipes every setting and all data of the group, after you confirm, and sends a backup. Also /chatreset.
/setgtitle <title>	Group Profile	Renames the group. Also /settitle.
/setgpic	Group Profile	Reply to a photo to make it the group photo. Also /setgrouppic.
/delgpic	Group Profile	Removes the group photo. Also /rmgpic.
/setdesc <text>	Group Profile	Sets the description, or reply to a message to use its text. Also /setdescription.
/setsticker	Group Profile	Reply to a sticker to make its pack the group's set. Also /setstickers.
/delsticker	Group Profile	Removes the group's sticker set. Also /rmsticker.
/slowmode	Group Profile	Whether slow mode is on, and where to change it.
/setlang [language]	Languages	In private chat, your own language. Through /connect, the group's.
/setlang <language>	Languages	Sets the group's language by name or code.
/privacy	Privacy	In private chat: the policy, and your data to see, download or delete.
/id [user]	Misc	The id of a user, group or channel.
/info [user]	Misc	Information about a user.
/ginfo	Misc	Information about this group. Also /chatinfo.
/fileid	Misc	Reply to media to get its file id. Also /stickerid, /gifid.
/ping	Misc	Marina's response time and uptime.
/runs	Misc	A random line about running away.
/limits	Misc	This group's limits and usage.
/donate	Misc	How to support the project.
/silentactions <on/off>	Misc	Let locks, blocklists and antiflood use silent actions.
/bot2bot <off/admin/all>	Misc	Which bots may use Marina's commands. Off by default. Also /bottobot.
/bot2botskipreview <on/off>	Misc	Run bots' admin commands without a human review.
/rank [user]	Levels	Your rank card, or someone else's.
/top	Levels	The ten most active members. Also /leaderboard.
/levels <on/off>	Levels	Levels on or off here. Off by default.
/levelup <on/off>	Levels	Announce new levels. On by default.
/karma [user]	Karma	Your karma, or someone else's.
/karmatop	Karma	The ten members with the most karma. Also /karmaboard.
/karma <on/off>	Karma	Karma on or off here. Off by default.
/setbirthday <date>	Birthdays	Saves your birthday: `15/03`, `15 March` or `15/03/1998`. Also /setbday.
/birthday [user]	Birthdays	Your birthday or someone's, and the days to go. Also /bday.
/birthdays	Birthdays	Birthdays in the next 30 days. Also /bdays.
/delbirthday	Birthdays	Forgets your birthday. Also /delbday.
/addbirthday <date>	Birthdays	Reply to a member to save their birthday for them. Also /addbday.
/birthdaywishes <on/off>	Birthdays	Post a birthday message on the day. Off by default. Also /bdaywishes.
/birthdaywishes tz <timezone>	Birthdays	The timezone for wishes, like `+5:30`.
/afk [reason]	AFK	Marks you as away.
brb [reason]	AFK	A message starting with "brb" does the same.
/afknotes <on/off>	AFK	Away and welcome-back notes on or off here. On by default.
/setme <text>	Profiles	Writes a short line about yourself.
/me [user]	Profiles	Your line, or someone else's. Also /aboutme.
/delme	Profiles	Removes your line. Also /clearme.
/bio [user]	Profiles	The bio this group's admins wrote about you or someone.
/setbio <text>	Profiles	Reply to a member to write their bio in this group.
/delbio	Profiles	Reply to a member to remove it. Also /clearbio.
/couples	Games	Today's couple, picked from active members. Also /couple, /shipping.
/truth	Games	A question to answer honestly.
/dare	Games	A small, harmless challenge.
/kang [emoji]	Stickers	Reply to a sticker or photo to add it to your pack. Also /steal.
/unkang	Stickers	Reply to a sticker from your pack to remove it.
/mypack	Stickers	A link to your pack. Also /mystickers.
/getsticker	Stickers	Reply to a sticker to get it as a file.
/stickerid	Stickers	Reply to a sticker to get its file id.