DrexChat

DrexChat help article

Security codes, bots, groups, contacts, AI, forwarding, storage, calls, media, notes and chat tools, explained in plain language.

1.1Why your security code changed

Every DrexChat installation has its own security code. When someone registers DrexChat again, their old code is replaced with a new one, and DrexChat tells everyone who chats with them. This is by design: a code that changed silently would be exactly the thing you would want to know about.

In the chat you will see a line like this:

What usually causes it

  • Your contact got a new phone and signed in to DrexChat on it.
  • They uninstalled and reinstalled the app, or cleared its data, and then registered again.
  • They signed out and signed in again.

In each case the new code belongs to the new installation, so every chat that person is in gets a notice. Your messages and history are not affected.

When to double-check

If the notice appears and you know your contact did not change phones or reinstall, ask them through another channel, such as a call or in person, before sharing anything sensitive.

1.2Bots on DrexChat

A bot is an account that a program controls. People talk to it in a chat, and it answers with text, pictures, video, audio and tap-able buttons. You write the program in plain JavaScript with the @trashcore/drex-api library, which is published on npm.

How the library works

The library uses long polling. Your bot asks DrexChat “anything new for me?”, DrexChat holds the request open until something arrives, and the bot handles it. Because your bot always makes the outgoing call, it needs no public address, no certificate and no open port, so it runs on a laptop, a VPS or a bot-hosting panel. It has no dependencies and needs Node.js 22 or newer.

Each incoming message or button tap reaches your code as a ctx object. It carries the text, the command, the sender's username and the chat, and has methods for answering in the same chat.

Set up a bot

  1. In DrexChat, open a chat with DrexBot and send ?newbot. Answer its two questions (a name and a username). It replies with your bot token, which starts with drex_. The token is shown only once, so save it somewhere safe.
  2. Send ?getid to DrexBot. It replies with your numeric user ID, which the library uses as the bot's owner.
  3. Create a folder for the bot and install the library:
Terminal
mkdir my-drex-bot && cd my-drex-bot
npm init -y
npm install @trashcore/drex-api
  1. Put the token and your ID in a .env file next to your code, not inside the code itself. A token typed into source ends up in git history, screenshots and backups.
.env
DREX_BOT_TOKEN=drex_your_token_here
DREX_OWNER_ID=12345
  1. Create bot.js:
bot.js
const { Bot } = require('@trashcore/drex-api');

const bot = new Bot({
  token: process.env.DREX_BOT_TOKEN,
  ownerId: Number(process.env.DREX_OWNER_ID)
});

// Matches ?start and /start
bot.command('start', (ctx) => ctx.reply('Hello ' + ctx.fromUsername));

// Every other message
bot.on('message', (ctx) => ctx.reply('You said: ' + ctx.text));

bot.on('ready', (me) => console.log('Running as @' + me.username));

bot.start();
  1. Run it:
Terminal
node --env-file=.env bot.js
  1. Add your bot to a chat or group, then send it ?start. A bot can only speak in chats it has been added to.

Buttons

Attach buttons to any reply. A button either sends data back to your bot when tapped, or opens a link.

buttons.js
const { Bot, button, urlButton } = require('@trashcore/drex-api');

bot.command('play', (ctx) => ctx.reply('Pick one', {
  buttons: [
    [button('Truth', 'truth'), button('Dare', 'dare')],
    [urlButton('Docs', 'https://example.com')]
  ]
}));

// Runs when someone taps the button whose data is exactly "truth"
bot.action('truth', (ctx) => ctx.reply('Would you rather...'));

// Or match a pattern: data like "page:2"
bot.action(/^page:(\d+)$/, (ctx) => ctx.reply('Page ' + ctx.match[1]));
Button limitValue
Rows per message8
Buttons per row4
Label length40 characters
Button data64 bytes

How a bot serves and sends media

A bot does not upload files to DrexChat. It sends a direct link to the file, and DrexChat shows it in the chat as a photo, video or audio message that people can open like any other media. So the file has to live somewhere that is publicly reachable.

media.js
bot.command('pic', (ctx) =>
  ctx.replyWithPhoto('https://example.com/cat.jpg', 'A cat'));

bot.command('clip', (ctx) =>
  ctx.replyWithVideo('https://example.com/clip.mp4', 'A short clip'));

bot.command('song', (ctx) =>
  ctx.replyWithAudio('https://example.com/song.mp3', 'Now playing'));

// Outside a reply, use the chat ID
bot.sendPhoto(chatId, 'https://example.com/cat.jpg', 'Caption');
  • Direct links only. The address must point at the file itself and start with http:// or https://. A web page that merely contains a video will not work. Other kinds of address are rejected.
  • The type comes from the address. .mp4 .mov .m4v .webm are shown as video, .mp3 .ogg .wav .m4a as audio, and anything else as a picture. A .webp is treated as a normal picture, not a sticker.
  • Captions are optional. The caption is the text under the media. A message needs text, media, or both.
  • Buttons work with media. Pass { buttons: [...] } as the last argument to attach them under a photo, video or audio.
  • Only in chats the bot is in. If you see “This bot is not in that chat”, someone needs to add the bot first.
  • Handle failures. Links go down. Wrap media sends in try/catch and fall back to plain text so the bot never goes silent.
Keep your token private

Anyone with the token can control your bot. Never post it in a chat, a screenshot or a public repository. If it leaks, create a new bot token with DrexBot and replace the old one.

1.3Using groups responsibly

Groups are shared spaces. A few habits keep them useful for everyone.

Good group habits

  • Check who is in the group before posting something personal. Everyone sees what you send.
  • Join through invite links only from people you trust. Some groups ask an admin to approve new members, so you may need to wait to be let in.
  • Stay on topic and avoid flooding the chat with repeated messages, media or stickers.
  • Pause before forwarding or sharing another person's photos, numbers or messages.
  • If a group stops being useful, you can leave it. If a person is bothering you, you can block or report them.

Why chats and calls are protected

Private conversations should stay private. DrexChat protects them in these ways:

  • Chats travel between your phone and DrexChat over encrypted connections, so someone on the same Wi-Fi or mobile network cannot read them on the way.
  • Calls use WebRTC, which encrypts voice and video between the devices on the call. DrexChat only passes along the setup details that let the two devices find each other.
  • Security codes (see 1.1) tell you when a contact's installation changed, so you notice if something looks different.

You are the other half of that protection. Keep your phone locked, do not share your sign-in codes with anyone, and be careful what you screenshot or forward.

What group admins can do

Each group has one owner (the person who created it), any number of admins, and members. The owner stays above the admins, so an admin cannot remove or demote them.

ActionOwner / adminMember
Send messages and mediaAlwaysUnless the group is closed or media is switched off
Add people to the groupYesNo
Remove membersYesNo
Make or remove adminsYesNo
Approve or decline join requestsYesNo
Pin a messageYesNo
Set disappearing messagesYesNo
Clear group media (Manage storage)YesNo, members can only see usage
Create a similar groupYesYes
Change group permissions and the approval ruleYesNo
Edit the group name, description and iconYesOnly if admins allow members to edit group info
Leave the groupYesYes

Admins can also close a group so that only admins can send. Changes to group settings and membership appear as notices in the group, so everyone can see what changed.

Rights of members

  • You can see the group's name, description and members.
  • You can block anyone, and report a user to the DrexChat admin team.
  • You are told when an admin adds you, removes you, or changes your role.
  • You can leave at any time.

Admins hold their rights to keep the group running well. Use them fairly, apply the same rules to everyone, and remove content or members only for a clear reason.

No explicit content

Do not send sexually explicit material, nudity, graphic violence, or content that harasses, threatens or targets someone. Anything involving minors in a sexual context is never acceptable, and you should report it immediately.

Reports go to the DrexChat admin team. Accounts that break these rules can be restricted or banned. If you think a restriction is a mistake, you can request a review from the app, and it typically takes about 24 hours. Admins who see explicit content in their group should remove it and the person who posted it.

1.4Stickers

How to use stickers

  1. In any chat, tap the emoji button next to the message box.
  2. Switch from Emoji to Stickers.
  3. Tap a sticker to send it.

A sticker is shown by itself, without a message bubble around it. Animated stickers loop silently, so they will not make noise in a quiet room. Stickers come from the pack that ships with the app, so they appear for your contacts without any extra download steps.

Bots can send stickers too. They do it by asking for the sticker type when they send media, and a plain .webp picture from a bot is shown as a normal picture.

sticker.js
// sendMedia(chatId, url, type, caption)
bot.sendMedia(chatId, 'https://example.com/wave.webp', 'sticker');

What counts as sticker abuse

Stickers are meant to add tone to a conversation. These uses are not allowed:

  • Flooding. Sending many stickers in a row to push other messages out of view, or to annoy someone.
  • Harassment. Using stickers to mock, threaten or single someone out, in a group or in a private chat.
  • Explicit or hateful stickers. Sexual, extremely violent or hateful stickers carry the same rules as any other content (see 1.3).
  • Impersonation and scams. Using stickers or sticker-like images to pretend to be someone else, or to trick people into clicking or paying.
  • Bots that spam stickers. A bot sending stickers nobody asked for is treated the same as a person doing it.
If it happens to you

Block the sender, then report them to the DrexChat admin team. In a group, tell an admin, who can remove the person or close the group while things settle down.

1.5Contacts: finding people and starting chats

You do not have to build a contact list by hand. You can search for a person, or let DrexChat check which people in your phone's address book already use the app.

Find people who are already on DrexChat

  1. On the chats screen, tap the + button to open New chat.
  2. Tap Find people on Drex Chat and allow access to your contacts when your phone asks.
  3. People from your address book who already use DrexChat are listed with a Message button. Everyone else is listed under Invite to Drex Chat. Tap Invite to send a ready-made invite with the DrexChat link, or Email for a contact that only has an email address.
What leaves your phone

Your contacts are read on your phone. Only phone numbers and email addresses are checked against DrexChat, and names never leave your phone. DrexChat does not keep the list it checks.

The same person written in different ways still matches. For example, +254 700 000 001 and 0700 000 001 are treated as one number.

Search for someone

Type a username or a phone number into the search bar on the chats screen, or into the search bar in New chat. The You row at the top of New chat lets you message yourself, which is handy for notes, links and files you want to move between devices.

Why someone is missing from the list

  • They are not on DrexChat yet. Use Invite.
  • They turned on Hide phone in Settings. People who do this are left out of contact matching on purpose, so a friend can have DrexChat and still not appear. Ask them for their username and search for it.
  • The number in your address book is different from the one they registered with, or has a typo.
  • The list is empty. You may have refused the contacts permission, your address book may be empty, or the account that holds your contacts may not be synced on the phone. Check the permission in your phone's settings first.
  • You checked too many times in a row. Contact checks are limited on purpose to stop people from scanning for numbers. Wait about ten seconds and try again. One check covers up to 3,000 numbers.

Blocking and reporting

If someone bothers you, block them. A blocked person cannot message you, and you have to unblock them before you can message them yourself. Your blocked people are listed on the Blocked contacts screen, where you can unblock them. To report someone to the DrexChat admin team, see 1.3.

1.6DreXAssistant, the built-in AI

DreXAssistant is an AI assistant inside DrexChat. You can ask it questions, get help writing a message, summarise something long, or work through an idea. It carries a verified badge so you can tell it apart from lookalike accounts.

How to use it

  1. Tap the DreXAssistant button, or open the verified DreXAssistant row in your chat list.
  2. Pick a model at the bottom of the conversation. The app offers two, labelled Claude and Copilot. Each conversation remembers the one you chose, and you can switch for the next message.
  3. Type your message and send it. A message can be up to 12,000 characters.
  4. Use the history button to reopen earlier conversations, or start a new one when you change topic.

Where your AI conversations live

  • On your device. Conversations are saved on your phone, not in your DrexChat chats. The app keeps your 80 most recent conversations, and the last 100 messages of each.
  • They do not follow you. Signing in on a new phone, reinstalling, or clearing the app's data starts you with an empty history. Copy anything you want to keep before you do.
  • Prompts pass through DrexChat to an outside AI provider to get an answer. DrexChat does not write them to its server logs or save them in its database, but the provider that generates the reply does receive them.
Do not share secrets with it

Never type passwords, sign-in codes, bank or card details, ID numbers or private details about other people. Treat it like a public place: assume that anything you type could be seen by the provider that answers.

Using the answers well

  • It can be wrong. AI answers sound confident even when they are mistaken. Check anything that affects your health, money, legal position or safety with a reliable source or a professional.
  • It is not a person. It is not a friend, a doctor or a lawyer, and it cannot act for you. It only writes text.
  • The same rules apply. Do not use it to produce explicit, harassing or deceptive content, then send it to others. See 1.3.

If it says it could not respond

A message such as “I could not get a response right now” means the AI provider is busy or unreachable, or the reply took longer than about 45 seconds. Wait a moment and send again, or switch to the other model. DreXAssistant is separate from the bots in 1.2.

DrexMediaAI

The AI filter on the chats screen also holds DrexMediaAI, which finds songs and videos instead of answering questions. Send it a link or the name of a song. For YouTube and Spotify a name is enough. For TikTok and Facebook, paste the link to the post. It replies with results you can preview and download. Only download things you have the right to keep.

1.7Forwarding messages

Forwarding sends a copy of a message you can see to another chat, so you do not have to retype it or save and re-upload its photo or video.

How to forward

  1. Press and hold the message.
  2. Choose Forward.
  3. In the Forward to list, search for a chat and tap it to select it. You can select several chats at once.
  4. Tap Forward. The button shows how many chats you picked.

If some chats fail, DrexChat tells you how many were sent and which ones did not go through, so you can try those again.

How a forwarded message looks

It is labelled Forwarded in the chat, and the chat list preview starts with “Forwarded:”. This way people can tell the message was not written fresh by you. The forwarded copy shows you as the sender.

What you can and cannot forward

  • You can forward text, photos, videos, audio and documents, with their captions.
  • You must be a member of both chats, and the destination has to be a different chat from the one the message is in.
  • View-once messages cannot be forwarded. They are meant to be seen once by the person they were sent to.
  • Messages that were deleted or have already disappeared are no longer available.
  • You cannot forward to a person who has blocked you, and you have to unblock someone before forwarding to them.
  • Occasionally an attachment cannot be forwarded from the place it is stored. DrexChat then tells you so, and you can send the file again yourself.

Things worth knowing

  • Media is copied, not linked. A forwarded photo or video becomes its own file in the destination chat, so deleting or clearing the original later does not remove the forwarded copy. It also counts toward the destination group's storage (see 1.9).
  • The destination's rules apply. If the group you forward into has disappearing messages turned on, the forwarded message follows that group's timer.
Forward with care

A private message belongs to the people it was written for. Ask before forwarding someone's personal messages, photos or contact details. Do not forward chain messages, rumours you have not checked, scams, or explicit content (see 1.3).

1.8Creating a similar group

When you need another group for the same people, such as a new project, a smaller team, or a fresh start after a group has become cluttered, Create a similar group saves you from setting it all up again.

How to do it

  1. Open the group and tap its name to open Group info.
  2. Open the Settings tab and tap Create a similar group. You can also find it in the group's more menu (the three dots).
  3. The new-group screen opens with everything filled in. Change the name, remove people who should not be there, adjust the permissions, then confirm to create the group. Nothing is created until you do.

What is copied

Copied to the new groupNot copied
Everyone in the group except youMessages, photos and other media
The name, with “(copy)” added so you can rename itThe old group's invite link
The description and group iconAdmin roles. Other admins start as ordinary members
Permissions: who can send messages, who can send media, whether members can edit group info, and whether new members need approvalPinned messages
The disappearing-messages timer

You create the new group, so you are its owner. Any member of the original group can start a similar group, not just admins.

Limits and good manners

  • A similar group can start with up to 100 other members. For a larger group, DrexChat tells you the group is too large, and you can create a normal group and add people in batches.
  • Review the member list before you create it. Adding someone to a group they did not expect can be unwelcome, so tell people why the new group exists.
  • The new group is a separate group. Changing one does not change the other, and people have to be removed from each separately.

1.9Managing media storage

Photos, videos, voice messages and documents shared in a group take up space on DrexChat's servers. Manage storage shows what a group is using and lets admins free up space by removing media nobody needs.

See what a group is using

  1. Open the group and tap its name to open Group info.
  2. On the first tab, tap Manage storage. The total size is shown under the button.
  3. You will see the total, how many items there are, and a breakdown into Photos, Videos, Audio and Documents. Below it is a grid of the media, with each file's size on it.

The group's Media tab shows the same list, so both places always agree. The sizes come from the stored files themselves, not an estimate.

Free up space

This is for admins only. Members can see usage but cannot clear anything.

  1. Open Manage storage or the Media tab.
  2. Tap the items you want to remove. They show a tick. Start with the biggest videos, which usually take most of the space. Select all picks everything.
  3. Tap Clear space. DrexChat tells you how much space was freed and how many items were removed.
Clearing is for everyone, and it cannot be undone

The files live on DrexChat's servers and every member sees the same file, so clearing removes it for the whole group. DrexChat cannot delete a file only from your own phone. The messages stay in the chat, marked as cleared, so nobody wonders where part of the conversation went. Ask members to save anything important first.

Good to know

  • Forwarded media is separate. A copy someone forwarded into another chat is its own file, so clearing it here does not remove it there (see 1.7).
  • Bot media from other websites is not stored by DrexChat. When a bot sends a link to a file hosted elsewhere (see 1.2), it does not count toward the group's storage and clearing it does not delete the original file.
  • Make a habit of it. Groups that share a lot of video fill up quickly. A quick clear-out every few weeks keeps them light, or you can start a fresh group with a similar group.

1.10Voice and video calls

You can call anyone you can message, in a private chat or a group. Calls use your internet connection, not your airtime.

Start a call

  1. Open the chat and tap the phone or camera icon in the header, or tap Call or Video on the person’s profile.
  2. Wait for them to answer. If nobody answers in about 30 seconds, the call is logged as missed.
  3. During the call you can mute, switch cameras on a video call, or end it. Tap the down arrow to put the call away without ending it. A bar at the top of the app shows how long it has been running and takes you back.

You can only be on one call at a time, and you are told if the person is already on another. You cannot call someone who has blocked you, and you must unblock someone before you can call them.

The Calls list

On the chats screen, choose the Calls filter. It lists every call with who it was with, which way it went and how long it lasted. Tap an entry for details and every call with that person. Press and hold an entry to delete it from your list. It is removed for you only, and the other person keeps theirs. Each call also appears in the conversation where it happened.

Group calls

Open Group info and tap Voice or Video. A group call is a room that people join when they can, with up to 8 people at once. The rest of the group sees a Join bar, and Wave inside the call tells them about it without ringing anyone.

If a call will not connect

Both people need a working internet connection. On some mobile networks two phones cannot reach each other directly and the call can fail. Switching to Wi-Fi usually helps.

1.11Photos, videos and voice notes

Send photos, videos and files

  1. Tap the paperclip and choose Gallery, Camera, Document or Audio.
  2. Pick up to 10 items. Add a caption if you like.
  3. With a single photo selected you can crop it. HD keeps more detail, and the 1 button sends it as view once.
  4. Tap send.

The server accepts files only up to a size limit. DrexChat shrinks photos automatically so they fit, but a video or file that is too large is refused with a message saying so. Tap a photo in a chat to see it full screen, and use the download button on any media to save it to your gallery.

View once

A view-once photo or video shows as a mask in the chat. The recipient can open it one time, and afterwards it shows as opened. View-once messages cannot be forwarded. DrexChat cannot stop someone photographing their own screen, so only send them to people you trust.

Voice notes

Press and hold the microphone to record, then let go to send. Slide left to cancel. A voice note can be up to 5 minutes long, and a quick tap does not send anything.

1.12Status and Notes

The Status tab has two parts. Both disappear after 24 hours and are seen by people you share a chat with.

Status

Post text, a photo or a video. When someone replies to your status, the reply arrives as a normal message in your chat with them. You can see who viewed each update, and you can delete your own.

Notes

A note is a song, a short part of it, and a thought.

  1. Open Notes and tap New note.
  2. Search for a song or pick one from the list. Tap play on a row to hear a preview.
  3. Drag the window to choose the part that plays. A note plays one minute at most.
  4. Write what you want to say and post. Tap a note in the row at the top to play it.

1.13Chat tools

Press and hold a message

  • React with one of 8 emoji. Tap a reaction to see who chose it.
  • Reply, Copy or Forward (see 1.7).
  • Message info shows when it was sent and who has read it. In a group you see one line per person.
  • Pin keeps one message at the top of the chat. In a group only admins can pin.
  • Edit or Delete your own messages.

The chat menu

Tap the three dots in a chat for these options:

  • Mute for 1, 5, 8 or 24 hours, or forever. This applies only to you.
  • Change wallpaper for this chat. You can also set one for every chat in Settings.
  • Disappearing messages after 24 hours, 7 days or 90 days. New messages follow the timer, and both people see a notice when it changes.
  • Manage storage shows what the chat uses. Clearing media there hides it for you only, and the other person keeps theirs.
  • Export chat saves the conversation as a file, with links to the media rather than the media itself.
  • Clear chat empties the conversation on your side only.

You can also message yourself. Open New chat and tap You to keep notes and links, or to move files between devices.

1.14Channels

The Channel tab holds the official DrexChat channel. Admins post announcements, releases and media, and everyone else reads. Tap Follow channel to get a notification for new posts. Followers can react to a post by pressing and holding it, but only admins can post. You can unfollow at any time to stop the notifications.