swb.js

swb.js is a lightweight, beginner-friendly WhatsApp bot framework built on top of @whiskeysockets/baileys. It provides a simple command-based interface, inspired by the ease of use of libraries like aoi.js, allowing developers to build WhatsApp bots quickly and efficiently.

⚠️ Disclaimer

swb.js is currently in early development and may not be production-ready. Some features are experimental, and breaking changes may occur as the project evolves.

We welcome all contributions, feedback, and suggestions to help improve the library. If you’d like to be part of its growth, feel free to open an issue, submit a pull request, or star the project on GitHub.

Together, we can make swb.js better for everyone. 💚

---

🪙 Support

If you like this project, please star on this repository, thank you ⭐ You can support me by:

---

✨ Features

• ⚡ Simple command system with $variables
• 📸 Fetch profile picture, about, last seen, and more
• ⏱️ Built-in uptime, latency, date/time utilities
• 📚 Fully customizable prefix and bot name
• 🧩 Easily extendable and maintainable

---

📦 Installation

npm install swb.js

---

🚀 Quick Start

Create a new file index.js:

const { SWBClient } = require("swb.js");

const bot = new SWBClient({
  prefix: "/",          // Command prefix (default: /)
  name: "MyBot",        // Bot name (optional)
});

// Simple ping command
bot.command({
  name: "ping",
  code: "Pong!"
});

// Greeting the sender
bot.command({
  name: "hello",
  code: "Hello $senderName, I am $botName."
});

// Show current uptime
bot.command({
  name: "uptime",
  code: "⏱ Bot has been active for $uptime."
});

// Random number
bot.command({
  name: "random",
  code: "🎲 Your lucky number is: $random[1;100]"
});

// Show info about yourself
bot.command({
  name: "me",
  code: `
🧍 *Your Number:* $number
📝 *About:* $about
📷 *PP URL:* $ppUrl
🕒 *Last Seen:* $lastSeen
  `
});

Then just run:

node index.js

---

🔧 Supported Variables

Variable	Description
$senderName	Name of the message sender
$botName	The name you set for your bot
$botNumber	The phone number of your bot
$uptime	How long the bot has been running
$latency	Message latency in milliseconds
$now	Current time (Asia/Jakarta)
$day[timezone]	Current weekday (default: Asia/Jakarta)
$date[timezone]	Current date (default: Asia/Jakarta)
$args[n]	Argument at index n (e.g., $args[0])
$random[min;max]	Random number between min and max (default: 0–9)
$upper[text]	Convert text to uppercase
$lower[text]	Convert text to lowercase

---

📱 WhatsApp Specific Variables

Variable	Description
$number	Your number (without domain)
$number[num]	Target number
$about	Your "about" info
$about[num]	Target's "about" info
$ppUrl	Your profile picture URL
$ppUrl[num]	Target's profile picture URL
$lastSeen	Your last seen (if available)
$lastSeen[num]	Target's last seen (if available)
$mention[n]	Mentioned user at index n
$groupName	Current group name (if in group)
$groupDesc	Group description (if in group)
$groupId	Group ID (JID)

---

📂 Folder Structure (Recommended)

swb-bot/
├── index.js          # Main bot file
├── package.json
└── node_modules/

---

💡 Tips

• To test group features, make sure to add your bot to a WhatsApp group.
• To use $mention, mention someone when calling the command.
• Commands are case-insensitive (e.g., /PING works the same as /ping).

---

📄 License

This project is licensed under the MIT License. See the LICENSE file for more details.

---

🛠 Built With

• Baileys - WhatsApp Web API library
• Node.js

---

🤝 Contributing

Pull requests and feature suggestions are welcome! Feel free to open an issue or submit a PR if you have something to add.