⚡ Ｄ Ａ Ｎ Ｕ Ｗ Ａ － Ｍ Ｄ ⚡

A modern, multi-device WhatsApp bot
Powered by Baileys — optimized for speed, flexibility, and automation.

---

📍 What is DANUWA-MD?

DANUWA-MD is a multi-device WhatsApp bot written in Node.js using the Baileys library. It supports QR/Pairing code login, a plugin-based command system, and various media tools such as sticker conversion, song and video downloads, and group management commands.

---

🛠️ Setup

🧾 Requirements

• Session ID
• Gemini API (Optional)
• OPENAI(gpt-4to-mini) API (Optional)
• Skymantion API (Optional)

Essential links

1. skymantion API key
2. Gemini API key
3. OPENAI API key
4. Weather API key
5. Removebg API key

🚀 Installation

1. Fork the Repository
   DANUWA-MD GitHub Repo

2. Generate Session ID
   Generate Session ID - 1
   
   OR
   
   Generate Session ID - 2

3. Configure Session and Owner Info

• Edit config.js with your session ID and owner number (international format)
• Edit config.js with your Gemini API Key (Optional)
• Edit config.js with your OPENAI(gpt-4to-mini) API Key (Optional)
• Edit config.js with your Skymantion API Key (Optional)

---

⚡ Deployment Methods

---

🧑‍💻 How to Deploy DANUWA-MD on GitHub Codespaces

1. Click the "Launch in GitHub Codespaces" button above.

2. Sign in with your GitHub account if needed.

3. Choose your forked repository (DANUWA-MD) to open in a new Codespace.

4. Wait for GitHub to set up your development environment.

5. In the terminal, install dependencies using:

   npm install

6. Start the bot using:

   node index.js

⚡ How to Deploy DANUWA-MD on Replit

1. Click the "Run on Replit" button above to begin deployment.
2. Log in to Replit using your GitHub account if prompted.
3. On your Replit dashboard, click the ➕ “Create Repl” button in the left sidebar.
4. Select “Import from GitHub” and paste the link to your forked DANUWA-MD repository.
5. Replit will automatically import and set up your project.
6. Once ready, click the “Run” button at the top — the bot will start and show logs in the console.

✅ Note:
Make sure your repository includes all required files (index.js, plugins, auth/, etc.) and no essential configuration is missing.

---

🚀 How to Deploy DANUWA-MD on GitHub (via Actions)

After you've added your session ID and updated the owner number in config.js, follow these steps to deploy your bot using GitHub Actions:

1. In your forked repository, click on the Actions tab in the navigation bar.

2. In the search bar that says “Search workflows”, type node.js. You’ll see a workflow template named Node.js — click on it to start configuring.

3. Once the workflow editor opens, delete all the existing code inside the editor.

4. Copy and paste the following GitHub Actions configuration into the editor:

# This workflow will do a clean installation of node dependencies, cache/restore them, build the source code and run tests across different versions of node
# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-nodejs

name: Node.js CI

on:
  push:
    branches: [ "main" ]
  pull_request:
    branches: [ "main" ]

jobs:
  build:

    runs-on: ubuntu-latest

    strategy:
      matrix:
        node-version: [20.x]
        # See supported Node.js release schedule at https://nodejs.org/en/about/releases/

    steps:
    - uses: actions/checkout@v4
    - name: Use Node.js ${{ matrix.node-version }}
      uses: actions/setup-node@v4
      with:
        node-version: ${{ matrix.node-version }}
        cache: 'npm'
    - run: npm install
    - run: npm start
    - run: npm test

5. Once pasted, commit the changes.

6. GitHub will now automatically deploy your bot using this workflow when you push updates to the main branch.

✅ Note: Make sure all required files (index.js, config.js, plugins/, auth/, etc.) are properly configured and committed to your repository before triggering the workflow.

---

🚄 How to Deploy DANUWA-MD on Railway

You can easily deploy your own instance of DANUWA-MD on Railway with just one click.

1. Click the "Deploy on Railway" button.

2. Connect your GitHub account and authorize access if prompted.

3. Click deploy now button.

4. Fill in the required environment variables (e.g., SESSION_ID, OWNER_NUMBER, etc.).

Click "Deploy" — Railway will handle the rest!

---

✅ Features

DANUWA-MD is designed with scalability, flexibility, and functionality in mind. Here’s what it offers:

Category	Description
🔗 Multi-Device Support	Seamless compatibility with WhatsApp Multi-Device using the Baileys library.
📱 QR/Pairing Login	Secure and easy authentication via QR code or pairing session.
📦 Modular Plugin Architecture	Easily extend functionality with a clean, plugin-based command system.
🎵 Media Tools	Download music and videos from platforms like YouTube, Facebook, and more.
🖼️ Sticker Tools	Convert images, videos, and GIFs to high-quality stickers in WebP format.
👥 Group Management	Manage WhatsApp groups with commands to add, remove, promote, demote, etc.
🧠 Smart Interaction	Reply-based command handling for a more interactive and context-aware experience.
⚙️ Developer Friendly	Built in Node.js with a clean, modular structure—perfect for customization and contributions.
🗂️ File Handling	Upload, download, and manage documents, past papers, and media files with ease.
🔍 Search Utilities	Fetch results from Google, Wikipedia, and other sources directly from chat.
🎮 Fun & Games	Enjoy mini-games, quizzes, and entertainment commands built-in for engagement.
🛡️ Admin Tools	Enable anti-link, auto-delete, welcome/goodbye messages, and other moderation features.
🌐 Web Integration	Supports express server for web-based pairing and API usage.
📝 Notes & Reminders	Save notes, set reminders, and manage personal data through chat commands.
📊 Stats & Uptime	Get bot performance data, uptime tracking, and usage analytics.
🌍 Language Support	Easily switch between multiple languages with dynamic localization support.

---

🛠️ Coming Soon

We’re constantly improving DANUWA-MD to bring more power to your fingertips. Here’s what’s on the roadmap:

Feature	Description
🤖 AI Chat Integration	Integration with ChatGPT or other LLMs for intelligent conversations and query handling.
📚 Educational Tools	Access to school syllabi, timetables, and educational content for students.
💬 Auto Reply & Scheduler	Set up automated replies and scheduled messages for improved automation.
🎧 Voice Command Support	Execute bot commands using voice messages for hands-free interaction.
📥 Advanced Downloader	Support for batch downloads, subtitle fetching, and audio format selection.
📂 Cloud Storage Sync	Integration with Google Drive, MEGA, and OneDrive for media management.
📈 Advanced Analytics	Detailed usage stats per user/group, plugin insights, and activity heatmaps.
🔐 User Profiles & Permissions	Role-based access control for different users (admin, user, guest).
📲 Companion App	Mobile-friendly frontend for managing plugins, sessions, and logs visually.
🎨 Custom UI Themes	Customize bot response styles, sticker frames, and preview cards.

---

👨‍💻 Developer

Danuka Disanayaka

Danuka Disanayaka is a passionate full-stack developer and automation enthusiast with a focus on building scalable bots, AI integrations, and open-source tools. With a deep understanding of JavaScript, Node.js, and real-time systems, Harshana actively contributes to the developer community by creating tools that simplify communication and task automation. His work emphasizes clean code, performance, and user-centric design.

GitHub • YouTube • WhatsApp • Facebook

---

📜 License

This project is licensed under the MIT License.

---

🌟 Star the Repository

If you like this project, don’t forget to ⭐️ the repo!

⚙️ Made with ❤️ by DANUKA DISSANAYAKA🔥