Repository navigation
Command Reference
Every command, with the same information as /help <command> in the chat. New here? Start with the user guide; group admins, see the admin guide.
Reading the usage line: <name> is required, [name] is optional, name... takes the rest of the message, and a|b means one of those words. Members can be given as an @mention, a name (@'Jo Do' with spaces) or #id (see /members). Numbers may use commas (1,000).
Cooldown is how long one person waits before using the same command again (default 2 s). Bot admins skip cooldowns.
- 📖 General:
/about/help/invite/ping/whoami - 🛠 Utility:
/base64/calc/choose/cleanlink/convert/hash/password/poll/prefs/qr/remind/reminders/roll/time/timestamp/todo/uuid - 🌐 Web:
/country/crypto/currency/deals/define/dns/github/hn/holidays/npm/reddit/status/translate/weather/whois/wiki/x - 🎲 Fun:
/8ball/coinflip/fact/hangman/joke/quote/rps/trivia/ttt/word/wyr/xkcd - 👥 Groups:
/afk/antispam/event/feed/filter/groupinfo/groupmenu/link/members/rules/seen/slowmode/toggle/welcome - 🛡 Moderation:
/block/delete/kick/modlog/purge/report/role/unblock/unwarn/warn/warnings - ⚙️ Admin:
/broadcast/groups/join/leave/reload/stats
Basics and bot info.
About me: uptime, version and stats
| Usage | /about |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 5 s |
| Aliases |
/info, /uptime
|
List commands, or show details for one
/help lists categories and commands; /help adds descriptions; /help shows everything about one command.
| Usage | /help [command] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 2 s |
| Aliases |
/h, /commands, /start
|
Arguments
-
command(optional, word or "quoted text"): A command or category to show details for
Examples
/help/help utility/help remind
Get my SimpleX address (link + QR code)
| Usage | /invite |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 10 s |
| Aliases | /address |
Check I'm online and how fast I reply
| Usage | /ping |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 5 s |
| Aliases | /pong |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Show your ids and role (handy for setting up bot admins)
In a DM it shows your contact id — put it in RUBI_BOT_ADMINS to make yourself a bot admin. In a group it shows your member id and role.
| Usage | /whoami |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 2 s |
| Aliases |
/me, /id
|
Handy tools.
Encode or decode Base64
Reply to a message with /base64 encode or /base64 decode to use that message's text.
| Usage | /base64 <encode|decode> [text...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 2 s |
| Aliases | /b64 |
Arguments
-
action(required, one ofencode,decode): encode or decode -
text(optional, text): The text (or reply to a message)
Examples
/base64 encode hello/base64 decode aGVsbG8=
Calculator: /calc (2+3)*4^2
Supports + - * / % ^, parentheses, sqrt, abs, round, floor, ceil, sin, cos, tan, log, ln, exp, min, max, pi, e.
| Usage | /calc <expression...> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 2 s |
| Aliases |
/math, /calculate
|
Arguments
-
expression(required, text): What to calculate
Examples
/calc 2+2/calc sqrt(2)*10/calc 15% * 80
Pick one for you: /choose pizza | sushi | tacos
Separate options with |, commas, or the word "or".
| Usage | /choose <options...> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 2 s |
| Aliases | /pick |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
options(required, text): Things to choose from
Examples
/choose pizza | sushi | tacos/choose tea or coffee
Remove tracking from a link
Works offline and never opens the URL. Signed or tokenized URLs are left unchanged rather than risking a broken link.
| Usage | /cleanlink [url...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 2 s |
| Aliases | /cleanurl |
Arguments
-
url(optional, text): HTTP(S) URL
Examples
/cleanlink https://example.org/?utm_source=newsletter&id=7
Convert units offline: /convert 1,000 m ft
Length, mass, temperature, area, volume, speed, time, data, energy, power, pressure and angle. Use symbols or full names; add 'to' if you like. /convert units shows the categories and common units.
| Usage | /convert <query...> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 2 s |
Arguments
-
query(required, text): [to] , or units
Examples
/convert 1,000 m ft/convert 32 F to C/convert 2 cups mL/convert units
Hash text: /hash sha256 hello
Reply to a message with /hash to hash that message's text.
| Usage | /hash <md5|sha1|sha256|sha512|sha3-256> [text...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 2 s |
| Aliases | /digest |
Arguments
-
algorithm(required, one ofmd5,sha1,sha256,sha512,sha3-256): Hash algorithm -
text(optional, text): Text to hash (or reply to a message)
Examples
/hash sha256 hello world/hash md5 hello
Generate a strong random password (DMs only)
Generated with a cryptographic RNG and not stored by Rubi separately. It remains in SimpleX chat history until you delete the message. Look-alike characters (0/O, 1/l/I) are left out. DMs only, so it isn't shown to a whole group.
| Usage | /password [length] [strong|alnum|pin] |
| Where | Direct messages only |
| Who | Everyone |
| Cooldown | 1 s |
| Aliases |
/pass, /pw
|
Arguments
-
length(optional, whole number, 4–128): Length (4–128, default 20) -
kind(optional, one ofstrong,alnum,pin): strong (default), alnum or pin
Examples
/password/password 32/password 6 pin
Start a poll: /poll Pizza tonight? | yes | no | maybe
Separate the question and options with |. With no options it's a 👍/👎 poll. Up to 8 options. Vote by reacting with an option's emoji (I add the reactions myself for polls with up to 3 options — they don't count as votes), or tap its vote button in DMs. One vote per person; only its creator can close it with /endpoll. Start with multi to let people pick several options (SimpleX allows 3 reactions per person, so more picks need the buttons), and/or a duration (1m to 30d) to close it automatically: /poll multi 2h Lunch? | pizza | sushi | tacos.
| Usage | /poll <poll...> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 15 s |
Arguments
-
poll(required, text): [multi] [duration] Question | option | option
Examples
/poll Movie night? | Friday | Saturday | Sunday/poll Should we start a book club?/poll 1h Pizza tonight? | yes | no/poll multi Which days work? | Mon | Tue | Wed | Thu
Your personal defaults
Defaults are used only in direct chats when a command omits a place, country or currency. Explicit arguments always win.
| Usage | /prefs [action] [value...] |
| Where | Direct messages only |
| Who | Everyone |
| Cooldown | 2 s |
Arguments
-
action(optional, word or "quoted text"): set, reset or list -
value(optional, text): Preference and value
Examples
/prefs/prefs set weather Oslo/prefs reset currency
Make a QR code: /qr https://simplex.chat
Reply to a message with /qr to encode that message's text.
| Usage | /qr [text...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 5 s |
| Aliases | /qrcode |
Arguments
-
text(optional, text): Text or link to encode (or reply to a message)
Examples
/qr https://simplex.chat
Set a reminder: /remind 10m stretch
When: a duration (30s, 10m, 1h30m, 2d, 1w), a clock time (18:30, 6pm, tomorrow 9:00) or a date (dec 24 18:00, 24 december, 2026-12-24 8am, friday 9:00; without a time it's 9:00). Clock times use your time zone from /time set (DMs), otherwise the server's. Repeat with every: every 2h (an hour at least), every day 9:00, every monday 18:00. In groups, start with @member to remind someone else (only you can cancel it). Reminders survive restarts. When a one-off reminder goes off, tap 💤 or reply to it with /snooze 30m to get it again later (for a day).
| Usage | /remind <what...> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 2 s |
| Aliases |
/remindme, /reminder
|
Arguments
-
what(required, text): When, then what to remind you about
Examples
/remind 10m stretch/remind 1h30m check the oven/remind tomorrow 9:00 call mom/remind dec 24 18:00 wrap presents/remind every day 9:00 standup/remind @bob 1h check the PR
List your reminders in this chat
| Usage | /reminders |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 2 s |
Roll dice: /roll 2d6+3, /roll d20, /roll 100
| Usage | /roll [dice] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 1 s |
| Aliases | /dice |
Arguments
-
dice(optional, word or "quoted text"): NdM±K (e.g. 2d6+3), dM, or a number for 1–N
Examples
/roll/roll 2d6+3/roll d20/roll 100
Current time anywhere: /time Tokyo
Give a city or an IANA zone (Europe/Berlin). In a DM, /time set saves your zone — then /time shows it and /remind uses it for clock times.
| Usage | /time [place...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 2 s |
| Aliases |
/clock, /tz
|
Arguments
-
place(optional, text): City, country or time zone — or: set
Examples
/time Tokyo/time Europe/Berlin/time set London
Convert Unix timestamps and dates
No argument: the current time. A number: Unix seconds (or milliseconds if it's 13+ digits). Anything else: parsed as a date (ISO 8601 works best).
| Usage | /timestamp [value...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 2 s |
| Aliases |
/ts, /epoch, /unix
|
Arguments
-
value(optional, text): Unix time or a date
Examples
/timestamp/timestamp 1700000000/timestamp 2030-01-01T00:00:00Z
Personal or group task list
Use add, list, claim, done, reopen, remove, clear and (in groups) assign @member. Tasks are stored in this chat; creators and assignees can complete or reopen a task, only its creator can assign or remove it, and clear removes your own completed tasks.
| Usage | /todo [action] [value...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 2 s |
Arguments
-
action(optional, word or "quoted text"): add, list, claim, done, reopen, assign, remove or clear -
value(optional, text): Task id or text (assign: id and @member)
Examples
/todo add bring projector/todo list/todo claim abc123/todo done abc123/todo assign abc123 @bob/todo clear
Generate UUIDs (v4 random, or v7 time-ordered)
| Usage | /uuid [count] [v4|v7] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 1 s |
| Aliases | /guid |
Arguments
-
count(optional, whole number, 1–20): How many (1–20) -
version(optional, one ofv4,v7): v4 (default) or v7
Examples
/uuid/uuid 5/uuid 3 v7
Look things up online.
Facts about a country: /country Japan
Name, ISO code (de, usa) or common alternative (UK) all work. Data is built in (world-countries, ODbL), so no web request is made.
| Usage | /country <name...> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 2 s |
Arguments
-
name(required, text): Country name or code
Examples
/country Japan/country de/country UK
Crypto price: /crypto btc
Prices from CoinGecko. Optionally add a currency: /crypto eth eur
| Usage | /crypto <coin> [currency] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 5 s |
| Aliases |
/coin, /price
|
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
coin(required, word or "quoted text"): Coin name or symbol -
currency(optional, word or "quoted text"): Fiat currency (default usd)
Examples
/crypto btc/crypto monero eur
Convert money: /currency 20 usd eur
European Central Bank reference rates via frankfurter.dev (updated on working days). Leave out the target for a few common ones.
| Usage | /currency <query...> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 3 s |
| Aliases | /fx |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
query(required, text): [amount] [to] — e.g. 20 usd eur, 100 gbp to jpy
Examples
/currency 20 usd eur/currency 100 gbp to jpy/currency eur
Current PC game deals: /deals
Finds a game by title and shows its Steam app id, historical low and every current store deal from CheapShark, with prices in USD and links through CheapShark.
| Usage | /deals <title...> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 5 s |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
title(required, text): Game title
Examples
/deals LEGO Batman/deals Baldur's Gate 3
Dictionary definition: /define serendipity
Reply to a message with /define to look up its first word.
| Usage | /define [word...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 5 s |
| Aliases |
/dict, /dictionary
|
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
word(optional, text): English word (or reply to a message)
Examples
/define serendipity
DNS lookup: /dns simplex.chat MX
Uses DNS-over-HTTPS (Cloudflare), so lookups are encrypted.
| Usage | /dns <domain> [A|AAAA|MX|TXT|NS|CNAME|SOA|CAA] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 3 s |
| Aliases |
/dig, /lookup
|
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
domain(required, word or "quoted text"): Domain name -
type(optional, one ofA,AAAA,MX,TXT,NS,CNAME,SOA,CAA): Record type (default A)
Examples
/dns simplex.chat/dns simplex.chat MX/dns simplex.chat TXT
GitHub repo or user info: /github simplex-chat/simplex-chat
| Usage | /github <target> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 5 s |
| Aliases | /gh |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
target(required, word or "quoted text"): owner/repo or a username
Examples
/github simplex-chat/simplex-chat/github torvalds
Top stories on Hacker News
| Usage | /hn [count] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 10 s |
| Aliases |
/hackernews, /news
|
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
count(optional, whole number, 1–10): How many (1–10, default 5)
Examples
/hn/hn 10
Upcoming public holidays: /holidays Germany
Data from Nager.Date — about 120 countries are covered.
| Usage | /holidays [country...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 3 s |
| Aliases | /holiday |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
country(optional, text): Country name or code
Examples
/holidays Germany/holidays us
npm package info: /npm simplex-chat
| Usage | /npm <package> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 3 s |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
package(required, word or "quoted text"): Package name
Examples
/npm simplex-chat/npm @simplex-chat/types
Show a Reddit post: /reddit
Shows the post's title, text, score and upvote ratio, and attaches its images, GIFs, videos and files. Reply to a message containing a Reddit link with just /reddit or /r to show that post. Append - to the link, or reply with /reddit -, to report its media without downloading or attaching it. Works with post links, share links (reddit.com/r/…/s/…), redd.it links and post ids. Posts come from the Arctic Shift archive, so brand-new posts can take a few minutes to appear, and scores are refreshed about 36 hours after posting. Media of NSFW posts is only sent in DMs.
| Usage | /reddit [link...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 10 s |
| Aliases | /r |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
link(optional, text): Post link, share link or post id (or reply to a link)
Examples
/reddit https://www.reddit.com/r/running/comments/17snc7d//r https://www.reddit.com/r/running/s/3TzXiyxaMD
Check if a website is up: /status example.com
Only public addresses are allowed (no local network).
| Usage | /status <url> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 5 s |
| Aliases |
/isup, /up
|
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
url(required, word or "quoted text"): Website or URL
Examples
/status simplex.chat
Translate text: /translate de good morning
Give the target language (a code like de or pt-BR, or a name like german), then the text — or reply to a message with /translate de. The source language is detected; name it with fr>en if the guess is wrong. Up to 500 characters per translation. The text is sent to MyMemory (translated.net) to be translated.
| Usage | /translate <lang> [text...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 5 s |
| Aliases | /tr |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
lang(required, word or "quoted text"): Target language, or source>target -
text(optional, text): Text to translate (or reply to a message)
Examples
/translate de good morning/translate fr>en bonjour tout le monde/translate japanese thank you
Weather now and the next 3 days: /weather Oslo
Data from Open-Meteo (free, no tracking key).
| Usage | /weather [place...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 5 s |
| Aliases |
/w, /forecast
|
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
place(optional, text): City or place
Examples
/weather Oslo/weather New York
Domain or IP owner: /whois simplex.chat
Registrar, dates, status, name servers and DNSSEC for domains; network name, range and country for IP addresses. Uses RDAP (rdap.org), the successor of WHOIS.
| Usage | /whois <target> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 3 s |
| Aliases | /rdap |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
target(required, word or "quoted text"): Domain or IP address
Examples
/whois simplex.chat/whois 1.1.1.1
Wikipedia summary: /wiki SimpleX Chat
| Usage | /wiki <query...> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 5 s |
| Aliases | /wikipedia |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
query(required, text): What to look up
Examples
/wiki Ada Lovelace/wiki Double ratchet algorithm
Show a post from X (Twitter): /x
Shows the post's author, text, replies/reposts/likes/views, polls, community notes and quoted posts, and attaches its photos, videos and GIFs (including the quoted post's). Reply to a message containing an X link with just /x to show that post. Append - to the link, or reply with /x -, to report its media without downloading or attaching it. Posts are fetched through the FxTwitter API. Media of sensitive posts is only sent in DMs.
| Usage | /x [link...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 5 s |
| Aliases |
/twitter, /tweet
|
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
link(optional, text): x.com or twitter.com post link (or reply to a link)
Examples
/x https://x.com/jack/status/20
Games and fun stuff.
Ask the magic 8-ball
| Usage | /8ball <question...> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 2 s |
| Aliases |
/eightball, /ask
|
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
question(required, text): Your yes/no question
Examples
/8ball Will it rain tomorrow?
Flip a coin
| Usage | /coinflip |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 2 s |
| Aliases | /flip |
| Live reply | yes: a placeholder appears right away and turns into the answer |
A random (useless) fact
| Usage | /fact |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 3 s |
| Aliases | /funfact |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Play hangman together
Start with /hangman, then anyone guesses with /hangman or /hangman . 6 wrong guesses and it's over. One game per chat; the starter can stop it.
| Usage | /hangman [guess] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | none |
Arguments
-
guess(optional, word or "quoted text"): A letter or the whole word
Examples
/hangman/hangman e/hangman rocket
A joke — the punchline arrives live
From JokeAPI in safe mode (no NSFW, religious, political, racist, sexist or explicit jokes).
| Usage | /joke [programming|pun|misc|spooky] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 5 s |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
topic(optional, one ofprogramming,pun,misc,spooky): programming, pun, misc or spooky
Examples
/joke/joke programming
A random quote
| Usage | /quote |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 3 s |
| Aliases | /inspire |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Rock, paper, scissors against me
| Usage | /rps [rock|paper|scissors] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 1 s |
| Aliases | /rockpaperscissors |
Arguments
-
move(optional, one ofrock,paper,scissors): Your move
Examples
/rps rock
Trivia question or tournament
Answers are revealed after 30 seconds. Questions from the Open Trivia Database. Start a tournament with /trivia tournament [2–10] [easy|medium|hard]; points accumulate across rounds.
| Usage | /trivia [input...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 10 s |
| Aliases | /quiz |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
input(optional, text): [tournament] [rounds] [easy|medium|hard]
Examples
/trivia/trivia hard/trivia tournament 5 medium
Tic-tac-toe vs a member
Challenge someone with /ttt @member; you play ❌ and go first. Move with /ttt <1-9>. Either player can stop with /ttt stop. Games expire after a day.
| Usage | /ttt [input...] |
| Where | Groups only |
| Who | Everyone |
| Cooldown | none |
| Aliases | /tictactoe |
Arguments
-
input(optional, text): @member, a cell 1-9, or stop
Examples
/ttt @bob/ttt 5/ttt stop
Daily word puzzle
Everyone gets the same word each day (UTC). Guess with /word : 🟩 right spot, 🟨 in the word, ⬜ not in it. Each player has 6 guesses a day; guesses are shared with the chat, and the first to solve it scores a win. /word scores shows the leaderboard.
| Usage | /word [guess] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | none |
Arguments
-
guess(optional, word or "quoted text"): A 5-letter word, or scores
Examples
/word/word crane/word scores
Would you rather? Vote A or B
Give two options separated by |, or leave it blank for a random question. One vote per person; changing your reaction or tapping the other option changes your vote.
| Usage | /wyr [options...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 10 s |
| Aliases | /wouldyourather |
Arguments
-
options(optional, text): Option A | option B
Examples
/wyr/wyr Explore space | Explore the ocean
An xkcd comic (latest, random or by number)
| Usage | /xkcd [which] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 3 s |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
which(optional, word or "quoted text"): latest (default), random, or a number
Examples
/xkcd/xkcd random/xkcd 927
Group features.
Mark yourself as away: /afk lunch
While you're away, I tell people who @mention you. It ends as soon as you post again.
| Usage | /afk [reason...] |
| Where | Groups only |
| Who | Everyone |
| Cooldown | 2 s |
| Aliases |
/away, /brb
|
Arguments
-
reason(optional, text): Why you're away
Examples
/afk/afk lunch, back at 2
Delete links from brand-new members (admins)
When on, links posted by members who joined less than 24 hours ago (and are below moderator) are deleted. I need to be a moderator or higher.
| Usage | /antispam [state] |
| Where | Groups only |
| Who | Group admins |
| Cooldown | 2 s |
Arguments
-
state(optional, yes/no): on or off
Examples
/antispam on/antispam off
Create and RSVP to a group event
Create one-off events with a timezone and visible yes/maybe/no RSVPs.
| Usage | /event [action] [value...] |
| Where | Groups only |
| Who | Everyone |
| Cooldown | 2 s |
Arguments
-
action(optional, word or "quoted text"): new, list, rsvp or cancel -
value(optional, text): Event details or id/status
Examples
/event new tomorrow 18:30 | Europe/London | Book club/event list/event rsvp abc123 yes
RSS/Atom feeds for this group
/feed lists this group's feeds; admins use /feed add and /feed remove . Checked every 30 minutes, up to 10 feeds per group. Works with blogs and news sites (a page that links its feed is enough), GitHub (github.com///releases.atom), subreddits (reddit.com/r//.rss), YouTube channel pages and Mastodon profiles.
| Usage | /feed [list|add|remove] [target] |
| Where | Groups only |
| Who | Everyone |
| Cooldown | 2 s |
| Aliases | /rss |
Arguments
-
action(optional, one oflist,add,remove): list, add or remove -
target(optional, word or "quoted text"): Feed URL (add) or id (remove)
Examples
/feed/feed add https://github.com/simplex-chat/simplex-chat/releases.atom/feed remove ab12cd
Delete messages with banned words (admins)
add/remove take words or phrases separated by commas; * matches the rest of a word (crypto* also blocks cryptocoin), and remove also takes * patterns. action: what else happens to the author (delete only, warn = a /warn, block = a timed /block, default 10m). level: normal, strict or max (send /filter level to compare them). The word list is only ever sent to you by DM (link your DMs with /modlog on). Moderators and admins aren't filtered, edits are checked too, and I need to be a moderator or higher.
| Usage | /filter [add|remove|list|clear|action|level] [words...] |
| Where | Groups only |
| Who | Group admins |
| Cooldown | 2 s |
| Aliases | /bannedwords |
Arguments
-
action(optional, one ofadd,remove,list,clear,action,level): add, remove, list, clear, action or level -
words(optional, text): Words or phrases (comma-separated), or the setting
Examples
/filter add spam, buy now, crypto*/filter remove crypto*/filter action block 1h/filter level strict/filter list
About this group: members, roles and my settings here
| Usage | /groupinfo |
| Where | Groups only |
| Who | Everyone |
| Cooldown | 5 s |
| Aliases |
/group, /gi
|
Make my commands tappable here and add them to the / menu
SimpleX apps only make commands tappable in a group when the group profile has a command menu, and only owners can set it — so I need to be a group owner. /groupmenu off removes it.
| Usage | /groupmenu [state] |
| Where | Groups only |
| Who | Group owners |
| Rubi must be | group owner (or higher) |
| Cooldown | 10 s |
| Aliases | /menu |
Arguments
-
state(optional, yes/no): on (default) or off
Examples
/groupmenu/groupmenu off
Show or create this group's invite link (admins)
/link shows the link (creating one if needed), /link new replaces it, /link delete removes it. I need to be a group admin.
| Usage | /link [new|delete] |
| Where | Groups only |
| Who | Group admins |
| Rubi must be | group admin (or higher) |
| Cooldown | 10 s |
| Aliases | /grouplink |
Arguments
-
action(optional, one ofnew,delete): new or delete
List group members and their roles
| Usage | /members |
| Where | Groups only |
| Who | Everyone |
| Cooldown | 5 s |
| Aliases |
/who, /roster
|
Show the group rules (admins: /rules set …, /rules clear)
| Usage | /rules [set|clear] [text...] |
| Where | Groups only |
| Who | Everyone |
| Cooldown | 2 s |
Arguments
-
action(optional, one ofset,clear): set or clear (admins) -
text(optional, text): The rules (for set)
Examples
/rules/rules set 1. Be kind. 2. No spam.
When a member last posted: /seen @bob
Counts messages since I joined the group (to the minute). Also shows whether they're /afk.
| Usage | /seen <member> |
| Where | Groups only |
| Who | Everyone |
| Cooldown | 2 s |
| Aliases | /lastseen |
Arguments
-
member(required, group member (@mention or name)): Who
Examples
/seen @bob
Limit how often members can post (admins)
Members below moderator can send one message per interval; faster messages are deleted. Commands don't count. Interval: 5s to 6h. /slowmode off turns it off. I need to be a moderator or higher.
| Usage | /slowmode [interval...] |
| Where | Groups only |
| Who | Group admins |
| Cooldown | 2 s |
Arguments
-
interval(optional, text): e.g. 30s, 2m, or off
Examples
/slowmode 30s/slowmode off
Turn commands on or off in this group (admins)
Name commands or whole categories, separated by commas or spaces: /toggle off fun turns off every Fun command. Turned-off commands don't run here (for anyone, admins included), disappear from /help and from the group's / menu. /help and /toggle can't be turned off. /toggle alone lists what's off.
| Usage | /toggle [on|off] [commands...] |
| Where | Groups only |
| Who | Group admins |
| Cooldown | 2 s |
Arguments
-
state(optional, one ofon,off): on or off -
commands(optional, text): Commands or categories
Examples
/toggle off fun/toggle off trivia, joke/toggle on trivia/toggle
Greet new members (admins: /welcome set Hi {name}!)
{name} becomes an @mention of the new member and {group} the group name. /welcome off disables it, /welcome test previews it. /welcome goodbye says goodbye to members who leave on their own ({name} in bold, {group}); /welcome goodbye off turns it off.
| Usage | /welcome [set|off|test|goodbye] [text...] |
| Where | Groups only |
| Who | Group admins |
| Cooldown | 2 s |
Arguments
-
action(optional, one ofset,off,test,goodbye): set, off, test or goodbye -
text(optional, text): Welcome message (for set), or the goodbye message
Examples
/welcome set Welcome {name}! Read /rules please 🙂/welcome test/welcome off/welcome goodbye Bye {name}, thanks for stopping by!/welcome goodbye off
Keep groups tidy (moderators/admins).
Block a member for everyone (their messages are hidden)
Blocked members stay in the group but nobody sees their new messages. Add a duration (10m, 2h, 1d; up to 30 days) to unblock them automatically. Undo with /unblock.
| Usage | /block <member> [duration...] |
| Where | Groups only |
| Who | Group moderators |
| Rubi must be | group moderator (or higher) |
| Cooldown | 2 s |
| Aliases | /mute |
Arguments
-
member(required, group member (@mention or name)): Who to block -
duration(optional, text): How long (default: until /unblock)
Examples
/block @troll/block @troll 10m
Reply to a message with /delete to remove it for everyone
Works on members' messages (moderators) and on my own messages. The /delete message is removed too.
| Usage | /delete |
| Where | Groups only |
| Who | Group moderators |
| Rubi must be | group moderator (or higher) |
| Cooldown | none |
| Aliases |
/del, /rm
|
Remove a member from the group
Asks for confirmation first. Their earlier messages stay — remove single ones by replying to them with /delete.
| Usage | /kick <member> [reason...] |
| Where | Groups only |
| Who | Group admins |
| Rubi must be | group admin (or higher) |
| Cooldown | 3 s |
| Aliases | /remove |
Arguments
-
member(required, group member (@mention or name)): Who to remove -
reason(optional, text): Why (shown in the group)
Examples
/kick @spammer advertising
Get the group's moderation log by DM (admins)
In a group, /modlog on sends you every moderation action (kicks, blocks, warnings, deleted and filtered messages, setting changes) by DM, and /modlog off stops it. Nothing sensitive is posted in the group. If I can't reach you yet, I send you a contact request in the group. To use another profile (e.g. not the incognito one you joined with), send /modlog link to me in a DM from that profile, then /modlog on in the group.
| Usage | /modlog [on|off|link] [code] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | 5 s |
Arguments
-
action(optional, one ofon,off,link): on, off or link -
code(optional, word or "quoted text"): Code from /modlog link
Examples
/modlog on/modlog off/modlog link/modlog on 4f7a2c
Delete the last messages: /purge 10
Removes the newest messages for everyone (up to 50), after you confirm. Add a member to only remove theirs. Messages from members whose role is equal to or higher than yours or mine are left alone.
| Usage | /purge <count> [member] |
| Where | Groups only |
| Who | Group moderators |
| Rubi must be | group moderator (or higher) |
| Cooldown | 10 s |
Arguments
-
count(required, whole number, 1–50): How many messages (1–50) -
member(optional, group member (@mention or name)): Only this member's messages
Examples
/purge 10/purge 20 @spammer
Report a message to admins (reply)
Reply to a message with /report and an optional reason. Admins who turned on the moderation log (/modlog on) get it by DM, with the message text. If I'm a moderator, I remove your /report message so the report stays discreet, and confirm by DM when I can.
| Usage | /report [reason...] |
| Where | Groups only |
| Who | Everyone |
| Cooldown | none |
Arguments
-
reason(optional, text): Why (optional)
Examples
/report spam link/report
Change a member's role
You can't give a role higher than your own. I need a role at least as high as both the old and the new one.
| Usage | /role <member> <observer|author|member|moderator|admin|owner> |
| Where | Groups only |
| Who | Group admins |
| Rubi must be | group admin (or higher) |
| Cooldown | 2 s |
| Aliases |
/setrole, /promote
|
Arguments
-
member(required, group member (@mention or name)): Whose role to change -
role(required, one ofobserver,author,member,moderator,admin,owner): New role
Examples
/role @alice moderator/role @bob observer
Unblock a member
| Usage | /unblock <member> |
| Where | Groups only |
| Who | Group moderators |
| Rubi must be | group moderator (or higher) |
| Cooldown | 2 s |
| Aliases | /unmute |
Arguments
-
member(required, group member (@mention or name)): Who to unblock
Clear a member's warnings
| Usage | /unwarn <member> |
| Where | Groups only |
| Who | Group moderators |
| Cooldown | 2 s |
| Aliases | /clearwarns |
Arguments
-
member(required, group member (@mention or name)): Whose warnings to clear
Warn a member (auto-removed at the warning limit)
Warnings are stored per group. At the limit (default 3, change with /warn limit , 0 = never) I remove the member if I'm an admin. Admins can make warnings expire with /warn expire 30d: a member's warnings reset after that long without a new one (/warn expire off: never).
| Usage | /warn <member> [reason...] |
| Where | Groups only |
| Who | Group moderators |
| Cooldown | 2 s |
Arguments
-
member(required, word or "quoted text"): Who to warn (or: limit, expire) -
reason(optional, text): Why (or the new limit / expiry)
Examples
/warn @bob please keep it civil/warn limit 5/warn expire 30d
See warnings (yours, a member's, or everyone's for moderators)
| Usage | /warnings [member] |
| Where | Groups only |
| Who | Everyone |
| Cooldown | 2 s |
| Aliases | /warns |
Arguments
-
member(optional, group member (@mention or name)): Whose warnings (moderators can see anyone's)
Bot operator tools.
Send a message to all my contacts
Asks for confirmation, then sends with live progress. Contacts that deleted me are skipped.
| Usage | /broadcast <message...> |
| Where | Direct messages only |
| Who | Bot admins |
| Cooldown | 2 s |
| Aliases | /announce |
Arguments
-
message(required, text): What to send
List the groups I'm in
| Usage | /groups |
| Where | DMs and groups |
| Who | Bot admins |
| Cooldown | 2 s |
| Aliases | /mygroups |
Make me join a group link or connect to an address
Works with SimpleX group links, contact addresses and one-time invitation links.
| Usage | /join <link> |
| Where | DMs and groups |
| Who | Bot admins |
| Cooldown | 2 s |
| Aliases | /connect |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Arguments
-
link(required, word or "quoted text"): SimpleX link
Make me leave a group
In a group: /leave leaves that group. Anywhere: /leave (ids are in /groups).
| Usage | /leave [groupId] |
| Where | DMs and groups |
| Who | Bot admins |
| Cooldown | 2 s |
Arguments
-
groupId(optional, whole number): Group id (default: this group)
Reload command files and the app menu (no restart)
Picks up edited/new files in data/commands. Event handlers and src/ changes still need a restart.
| Usage | /reload |
| Where | DMs and groups |
| Who | Bot admins |
| Cooldown | 2 s |
| Live reply | yes: a placeholder appears right away and turns into the answer |
Bot statistics: usage, memory, jobs
| Usage | /stats [mode] |
| Where | DMs and groups |
| Who | Bot admins |
| Cooldown | 2 s |
Arguments
-
mode(optional, word or "quoted text"): health for runtime diagnostics
Rubi's buttons send these. You rarely type them yourself, and they're not in /help.
Close a poll and show the result
| Usage | /endpoll <id> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | none |
| Aliases | /closepoll |
Arguments
-
id(required, word or "quoted text"): Poll id (from the poll message)
Snooze a reminder that just went off
Tap a 💤 button under a reminder, or reply to the reminder with /snooze and when (10m, 1h, tomorrow 9:00; default 10m). Reminders can be snoozed for a day after they go off, by the person who set them or the person they're for.
| Usage | /snooze [when...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | none |
Arguments
-
when(optional, text): When: 10m, 1h, tomorrow 9:00 (the buttons add an id first)
Examples
/snooze 30m/snooze tomorrow 9:00
Cancel a reminder
| Usage | /unremind <id> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | none |
Arguments
-
id(required, word or "quoted text"): Reminder id (see /reminders)
Cancel a pending action
| Usage | /cancel [id] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | none |
| Aliases | /no |
Arguments
-
id(optional, word or "quoted text"): Interaction id
Confirm a pending action
| Usage | /confirm [id] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | none |
| Aliases | /yes |
Arguments
-
id(optional, word or "quoted text"): Confirmation id
Show another page of a list
| Usage | /page <id> <n> |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | none |
Arguments
-
id(required, word or "quoted text"): List id (from the button) -
n(required, whole number, 1–…): Page number
Answer a poll or quiz button
| Usage | /vote <id> [choice...] |
| Where | DMs and groups |
| Who | Everyone |
| Cooldown | none |
Arguments
-
id(required, word or "quoted text"): Interaction id (from the button) -
choice(optional, text): Your choice
These pages are generated from guide/ in the repository. Edit them there: changes made here are overwritten.