BOT FEATURES ⤵️
| Menu ➜ | Status Save + Send | Group | ChatBot | Downloading | Antidelete | Ai | RPG/Economy | Fun | Status Reply | Status Reacts | HeartReacts | Autoreacts | Call Rejecter | |---|---|---|---|---|---|---|---|---|---|---|---|---|---| | Work ➜ |✅|✅|✅|✅|✅|✅|✅|✅|✅|✅|✅|✅|✅|
𝟏. 𝐒𝐄𝐓 𝐔𝐏:
👇FORK REPO (A MUST)
𝗖𝗟𝗜𝗖𝗞 𝗛𝗘𝗥𝗘
- This gives you your own safe, deployable copy of the repo — especially important for Heroku, Render, Railway users.
𝟐. 𝐋𝐈𝐍𝐊 𝐖𝐈𝐓𝐇 𝐖𝐇𝐀𝐓𝐒𝐀𝐏𝐏
GET YOUR SESSION_ID
- No forking required — anyone can generate a
SESSION_IDfrom the link above.
🔑 Environment Variables
| Variable | Required | Description |
|---|---|---|
| SESSION_ID | ✅ | Your bot session ID from the pairing site |
| MODE | ✅ | public (anyone can use it) or private (owner only) |
| TIME_ZONE | ✅ | e.g. Africa/Harare, Asia/Kolkata, America/New_York |
| MALVIN_API_KEY | ✅ | Free key from api.malvin.gleeze.com dashboard |
| AUTO_LIKE_STATUS | ➖ | true/false — auto-like statuses |
| AUTO_READ_STATUS | ➖ | true/false — auto-view statuses |
| DATABASE_URL | ➖ | PostgreSQL URL. Leave blank to fall back to SQLite |
| OWNER_NAME / OWNER_NUMBER | ➖ | Your name and number, shown as bot owner |
𝟑. 𝐃𝐄𝐏𝐋𝐎𝐘𝐌𝐄𝐍𝐓 𝐒𝐄𝐂𝐓𝐈𝐎𝐍:
(A) HEROKU DEPLOYMENT
TAP TO OPEN
- PostgreSQL is auto-provisioned via the
heroku-postgresql:essential-0addon — no manual setup needed. - Builds from the repo's
Dockerfile(ffmpeg included). - All env vars are pre-filled from
app.json— just addSESSION_IDandMALVIN_API_KEY.
(B) RENDER DEPLOYMENT
TAP TO OPEN
Steps:
- Fork this repo, then sign in at render.com.
- Click New → Blueprint and connect your fork.
- Render reads
render.yamland auto-provisions a free PostgreSQL database (malvin-db). - Fill in
SESSION_IDandMALVIN_API_KEYwhen prompted — everything else has defaults. - Click Apply.
Render's free Postgres lasts 90 days. After that, grab a free external DB from neon.tech or supabase.com and paste it as DATABASE_URL. Leave it blank and the bot falls back to SQLite automatically.
(C) RAILWAY DEPLOYMENT
TAP TO OPEN
Steps:
- Fork this repo and go to railway.app.
- New Project → Deploy from GitHub repo → select your fork (builds from
Dockerfile). - + New → Database → PostgreSQL — Railway auto-links
DATABASE_URL. - In Variables, add
SESSION_ID,MODE=public,TIME_ZONE,MALVIN_API_KEY,AUTO_LIKE_STATUS=true,AUTO_READ_STATUS=true. railway.tomlhandles the health check (/health) and auto-restart.
(D) KOYEB DEPLOYMENT
TAP TO OPEN
Steps:
- Fork this repo and sign in at koyeb.com.
- Koyeb has no built-in database — get a free PostgreSQL from neon.tech, supabase.com, or aiven.io.
- Click Deploy Now, or Create App → GitHub → select your fork.
- Set
SESSION_ID,MALVIN_API_KEY, andDATABASE_URLin the service environment variables. - Koyeb uses
Dockerfile+koyeb.yamlautomatically.
Skip DATABASE_URL and the bot uses local SQLite — data resets on every redeploy.
(E) VPS / SELF-HOSTED DEPLOYMENT
TAP TO OPEN
Requires a Linux VPS (Ubuntu 20.04+) with Node.js 20+ and Git installed.
1. Clone the repo
git clone https://github.com/XdKing2/MALVIN-XD.git
cd MALVIN-XD
2. Install dependencies
npm install
3. Set environment variables
Create a .env file in the project root using the variables from the table above.
4. Install FFmpeg (required for media commands)
sudo apt update && sudo apt install -y ffmpeg
5. Start the bot
npm start
6. Keep it running with PM2 (recommended)
npm install -g pm2
pm2 start index.js --name malvin-xd
pm2 save
pm2 startup
7. Update the bot
git pull
npm install
pm2 restart malvin-xd
(F) BOT HOSTING PANEL 🔥 (DISCORD) DEPLOYMENT
TAP TO OPEN
- One-click deploy pulls straight from the
XdKing2/MALVIN-XDGitHub repo — no fork needed just to use this button. - Sign up at bot-hosting.net, click Deploy Now above, and it auto-fills the repo for you.
- Set
SESSION_ID,MODE,TIME_ZONE,MALVIN_API_KEYin the instance's environment/startup settings. - Start the instance — SQLite is used automatically if
DATABASE_URLisn't set.
(G) MALVIN HOST
TAP TO OPEN
- Sign up, claim your daily coins and select a bot instance, and set
SESSION_ID,MODE,TIME_ZONE,MALVIN_API_KEYin the settings etc.
⚠️ DISCLAIMER
- ❗ MALVIN-XD is not affiliated with WhatsApp Inc.
- 🚫 Misuse may lead to account bans. Use responsibly.
💡 CREDITS & CONTRIBUTORS
Built with ❤️ by Mr XdKing
- 👤 Mr XdKing — Creator & Maintainer
𝟒. 𝐔𝐏𝐃𝐀𝐓𝐄𝐒 & 𝐒𝐔𝐏𝐏𝐎𝐑𝐓
𝗖𝗟𝗜𝗖𝗞 𝗛𝗘𝗥𝗘
🔔 Stay connected for updates, feature drops, and tutorials!
- ▶️ YouTube: MalvinTech
- 💬 WhatsApp Channel
- 🎮 Discord
𝟓. 𝐑𝐄𝐏𝐎 𝐒𝐓𝐀𝐑 𝐇𝐈𝐒𝐓𝐎𝐑𝐘
🤖 _MALVIN-XD STATUS_
+ Project Status: Active
! Version: V.3.0.0
License: Apache
💫 Thanks to our loyal followers
