xstro-md Simple WhatsApp Bot

xstro-md is an open-source WhatsApp bot written and enhanced by AstroX11 to facilitate lazy WhatsApp users like yourself and me. The original purpose of this project was, personally for me, to develop my JavaScript skills. Since you guys like my work, I decided to continue improving and maintaining this project. I hope someone will sponsor me one day, lol.

Important

If you want to modify the source code, you are free to do so according to the license. However, I will not take responsibility for any unethical actions you take using this software, as it was originally made for educational purposes. I strongly oppose any form of misuse, abuse, or threats.

Offical Documentation

Note

Session ID created by XstroSession, encrypted with SessionMaker Crypto, and stored on Koyeb. Only Xstro can unlock it. Two repository links provided for creating your own session. Keep your session ID safe. I am not a cybersecurity expert.

Custom Session

• Download & Install Node.js
• Download & Install Git
• Run node -v on your terminal.
• Create a folder, and open your terminal on that folder and run the below.

Deployments

Heroku Deploy

• Deploy Now
• Once you tap the URL above, fill in the vars such as SESSION_ID,BOT_INFO, SUDO, STICKER_PACK, WARN_COUNT, and TIME_ZONE.
• Click on the Deploy button to install and deploy the bot to Heroku.
• Watch Video Tutorial

Koyeb Deploy

• Deploy Now
• Once you tap the URL above, fill in the vars such as SESSION_ID,BOT_INFO, SUDO, STICKER_PACK, WARN_COUNT, and TIME_ZONE.
• If you are not an advanced koyeb user, just tap on the deploy button, after you have filled the variables and aviod any necessary options that "may" or "will" alter the pre and post deployment process.
• Watch Video Tutorial

Render Deploy

• Deploy Now
• Once you tap the URL above, fill in the vars such as SESSION_ID,BOT_INFO, SUDO, STICKER_PACK, WARN_COUNT, and TIME_ZONE.
• Tap on the Deploy Blueprint button, the wait for the bot to deploy and start running.
• Once you have deployed the bot, copy the URL of the deployed blueprint.
• If you do not have a betterstack account then Create A Better Stack Account or Login if you already have one.
• Once you are in, tap on the create monitor button and scroll down to the box that say you should put url to monitor it could be different and paste the URL in the box and tap on create monitor.
• This keeps the bot Alive by pinging it every 5mins.
• Watch Video Tutorial

Panel Deploy

• Panel Deployment

Windows/Linux/MacOS Deploy

1. Install Node.js

• Windows: Download and install. Verify:

  node -v
  npm -v

• Linux:

  curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
  sudo apt install -y nodejs
  node -v
  npm -v

• macOS:

  brew install node
  node -v
  npm -v

2. Install FFmpeg

• Windows: Download, extract, and add bin to PATH. Verify:

  ffmpeg -version

• Linux:

  sudo apt update && sudo apt install ffmpeg
  ffmpeg -version

• macOS:

  brew install ffmpeg
  ffmpeg -version

3. Install Yarn

• Install globally using npm:

  npm install -g yarn
  yarn -v

4. Install Git

• Windows: Download and install. Verify:

  git --version

• Linux:

  sudo apt update && sudo apt install git
  git --version

• macOS:

  brew install git
  git --version

5. Setup

1. Open a terminal.

2. Clone the repo and start:

   git clone https://github.com/AstroX11/Xstro.git
   cd Xstro
   yarn install
   npm start

Guide and Support

• External Plugins

• Render Support

• Heroku Support

• Windows Support

• Plugin Creation

• Listener Events

Contributing

Want to help? Fork the repo, create a pull request, and ensure everything works.

Disclaimer

This is my first JavaScript project—expect some bugs. This project is not affiliated with WhatsApp. For official WhatsApp, visit whatsapp.com.