Skip to content

xnodesdevelopers/GARFIELD-V11-CORE

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

53 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Garfield WhatsApp Bot v11 Stable


 ██████╗  █████╗ ██████╗ ███████╗██╗███████╗██╗     ██████╗     ██╗   ██╗ ██╗ ██╗
██╔════╝ ██╔══██╗██╔══██╗██╔════╝██║██╔════╝██║     ██╔══██╗    ██║   ██║███║ ██║
██║  ███╗███████║██████╔╝█████╗  ██║█████╗  ██║     ██║  ██║    ██║   ██║╚██║ ██║
██║   ██║██╔══██║██╔══██╗██╔══╝  ██║██╔══╝  ██║     ██║  ██║    ╚██╗ ██╔╝ ██║ ██║
╚██████╔╝██║  ██║██║  ██║██║     ██║███████╗███████╗██████╔╝     ╚████╔╝  ██║ ██║
 ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝     ╚═╝╚══════╝╚══════╝╚═════╝       ╚═══╝   ╚═╝ ╚═╝

𝖳𝖧𝖤 𝖴𝖫𝖳𝖨𝖬𝖠𝖳𝖤 𝖶𝖧𝖠𝖳𝖲𝖠𝖯𝖯 𝖡𝖮𝖳 𝖥𝖮𝖱 𝖠𝖭𝖸 𝖯𝖫𝖠𝖳𝖥𝖮𝖱𝖬


Version Platform API Node Playwright License Status




🔌   𝖠𝖱𝖢𝖧𝖨𝖳𝖤𝖢𝖳𝖴𝖱𝖤

┌──────────────────────────────────────────────────────────────────────────┐
│                                                                          │
│   WhatsApp Web  ──►  Baileys (WebSocket)  ──►  Node.js Runtime          │
│                                    │                                     │
│                          GARFIELD BOT v11 Logic                          │
│                                    │                                     │
│              command.js  ◄──  plugins/  ──►  ctx object                 │
│                                                                          │
└──────────────────────────────────────────────────────────────────────────┘
Layer Technology Role
🌐 WhatsApp Client @whiskeysockets/baileys Core WA API — messages, media, groups
⚙️ Runtime Node.js 20+ Bot logic, plugin system, file handling
🎬 Media Engine FFmpeg Video & audio processing and conversion
🌐 Scraper Playwright + Chromium YouTube audio, news scraping
🤖 AI Engine Gemini 2.5 Flash AI replies via Google GenAI



⚡   𝖥𝖤𝖠𝖳𝖴𝖱𝖤𝖲

╔══════════════════════════════════════════════════════════════════════╗
║  🎥  VIDEO UI SYSTEM                                                 ║
║      .menu and .alive render HD local MP4 inside WhatsApp            ║
╠══════════════════════════════════════════════════════════════════════╣
║  ⚡  BAILEYS POWERED — ULTRA LIGHTWEIGHT                             ║
║      Direct WebSocket · Anti-ban optimized · 512MB RAM ready         ║
║      QR login · Auto-reconnect · Works on any platform               ║
╠══════════════════════════════════════════════════════════════════════╣
║  📥  MEDIA DOWNLOAD SUITE                                            ║
║      YouTube MP3/M4A · Facebook Video · Android APK                  ║
║      Sri Lanka News · Format conversion via FFmpeg                   ║
╠══════════════════════════════════════════════════════════════════════╣
║  🤖  GEMINI AI                                                       ║
║      Ask anything · Powered by Google Gemini 2.0 Flash               ║
║      Safe error handling · Works without API key too                 ║
╠══════════════════════════════════════════════════════════════════════╣
║  🛡️  GROUP MANAGEMENT                                                ║
║      Anti bad words auto-delete · Member list with @mentions         ║
╠══════════════════════════════════════════════════════════════════════╣
║  🔧  PLUGIN ARCHITECTURE                                             ║
║      Drop JS files into /plugins — auto loaded on startup            ║
╠══════════════════════════════════════════════════════════════════════╣
║  🌍  CROSS PLATFORM                                                  ║
║      Windows · macOS · Linux · VPS · Any server                      ║
╚══════════════════════════════════════════════════════════════════════╝



📜   𝖢𝖮𝖬𝖬𝖠𝖭𝖣 𝖯𝖠𝖭𝖤𝖫

Command Action Category
.menu 🎬 Video Menu CORE
.alive 💚 Bot uptime & status CORE
.owner 👤 Developer info INFO
.ai <query> 🤖 Ask Gemini AI AI
.song <query> 🎵 YouTube MP3 MEDIA
.play <query> 🎧 YouTube M4A MEDIA
.fb <url> 🎬 Facebook video MEDIA
.app <n> 📲 Android APK MEDIA
.news 📰 Sri Lanka news MEDIA
.sticker 🎨 Image/Video → Sticker TOOLS
.toimage 🖼️ Sticker → Image/Video TOOLS
.tomp3 🎙️ Video/Voice → MP3 TOOLS
.members 👥 Group member list GROUP



🛠   𝖨𝖭𝖲𝖳𝖠𝖫𝖫𝖠𝖳𝖨𝖮𝖭 𝖦𝖴𝖨𝖣𝖤



🐧   Linux / VPS


Step 1 — Install Node.js, FFmpeg & Git

sudo apt update && sudo apt upgrade -y
sudo apt install git ffmpeg -y

# Install Node.js 20
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install nodejs -y

# Verify
node -v    # v20.x.x
npm -v     # 10.x.x
ffmpeg -version

Step 2 — Clone the project

git clone https://github.com/xnodesdevelopers/GARFIELD-V11-CORE.git
cd GARFIELD-V11-CORE

Step 3 — Install dependencies

npm install
npx playwright install chromium

Step 4 — Configure

nano config.js
OWNER_NUMBER:   '94711234567',  // your number without +
PREFIX:         '.',
MODE:           'public',
GEMINI_API_KEY: 'your_key_here', // optional — get from aistudio.google.com

Step 5 — Add menu video

# put your menuvideo.mp4 inside lib/ folder
ls lib/menuvideo.mp4   # must exist

Step 6 — First launch & scan QR

node index.js

📱 QR code appears → Open WhatsApp → Linked DevicesLink a Device → Scan After scan press Ctrl+C


Step 7 — Install PM2 & start bot

npm install -g pm2
npm start


🪟   Windows


Step 1 — Install Node.js

node -v
npm -v

Step 2 — Install FFmpeg

ffmpeg -version

Step 3 — Install Git


Step 4 — Clone & install

git clone https://github.com/xnodesdevelopers/GARFIELD-V11-CORE.git
cd GARFIELD-V11-CORE
npm install
npx playwright install chromium

Step 5 — Configure

notepad config.js
OWNER_NUMBER:   '94711234567',  // your number without +
PREFIX:         '.',
MODE:           'public',
GEMINI_API_KEY: 'your_key_here', // optional

Step 6 — Add menu video

  • Put menuvideo.mp4 inside the lib/ folder

Step 7 — First launch & scan QR

node index.js

📱 QR code appears → Open WhatsApp → Linked DevicesLink a Device → Scan After scan press Ctrl+C


Step 8 — Install PM2 & start bot

npm install -g pm2
npm start


🍎   macOS


Step 1 — Install Homebrew (if not installed)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Step 2 — Install Node.js, FFmpeg & Git

brew install node ffmpeg git
node -v
ffmpeg -version

Step 3 — Clone & install

git clone https://github.com/xnodesdevelopers/GARFIELD-V11-CORE.git
cd GARFIELD-V11-CORE
npm install
npx playwright install chromium

Step 4 — Configure

nano config.js
OWNER_NUMBER:   '94711234567',  // your number without +
PREFIX:         '.',
MODE:           'public',
GEMINI_API_KEY: 'your_key_here', // optional

Step 5 — Add menu video

  • Put menuvideo.mp4 inside the lib/ folder

Step 6 — First launch & scan QR

node index.js

📱 QR code appears → Open WhatsApp → Linked DevicesLink a Device → Scan After scan press Ctrl+C


Step 7 — Install PM2 & start bot

npm install -g pm2
npm start



🔄   𝖯𝖬𝟐 𝖢𝖮𝖬𝖬𝖠𝖭𝖣𝖲

PM2 keeps your bot running 24/7. Auto-restarts on crash. Survives server reboots.


Command Action
npm start ▶️ Start the bot
npm stop ⏹️ Stop the bot
npm run restart 🔄 Restart the bot
npm run logs 📋 View live logs
npm run status 📊 Check bot status

Auto-start on server reboot:

pm2 save          # save current process list
pm2 startup       # copy & run the command it gives you

Check if bot is running:

npm run status
┌─────┬───────────┬─────────┬──────┬───────────┬──────────┐
│ id  │ name      │ status  │ cpu  │ mem       │ uptime   │
├─────┼───────────┼─────────┼──────┼───────────┼──────────┤
│ 0   │ garfield  │ online  │ 0%   │ 85mb      │ 2D       │
└─────┴───────────┴─────────┴──────┴───────────┴──────────┘



📂   𝖯𝖱𝖮𝖩𝖤𝖢𝖳 𝖲𝖳𝖱𝖴𝖢𝖳𝖴𝖱𝖤

GARFIELD-V11-CORE/
│
├── 📄 index.js               ← Bot entry point
├── 📄 command.js             ← Plugin registry
├── 📄 config.js              ← Your settings (owner, prefix, mode)
├── 📄 package.json           ← Dependencies & npm scripts
├── 📄 ecosystem.config.js    ← PM2 configuration
│
├── 📁 plugins/               ← All commands (drop & auto-load)
│   ├── ai.js                 ← Gemini AI (optional — needs API key)
│   ├── alive.js              ← Bot status
│   ├── antiBadWords.js       ← Auto delete bad words in groups
│   ├── app.js                ← Android APK downloader
│   ├── fb.js                 ← Facebook video downloader
│   ├── members.js            ← Group member list with @mentions
│   ├── menu.js               ← Video menu
│   ├── news.js               ← Sri Lanka news (Helakuru Esana)
│   ├── owner.js              ← Developer info
│   ├── play.js               ← YouTube M4A download
│   ├── song.js               ← YouTube MP3 download
│   ├── sticker.js            ← Image/Video to sticker
│   ├── toimage.js            ← Sticker to image/video
│   └── tomp3.js              ← Video/Voice to MP3
│
├── 📁 sessions/              ← Auto-generated (don't delete)
└── 📁 lib/
    ├── menuvideo.mp4         ← ⚠️ Required — add your video here
    └── store/                ← Temp files (auto-cleanup)



❓   𝖢𝖮𝖬𝖬𝖮𝖭 𝖨𝖲𝖲𝖴𝖤𝖲


Bot not responding?

npm run logs     # check for errors
npm run restart  # restart bot

QR expired?

rm -rf sessions/
node index.js    # scan new QR

Sticker / tomp3 not working?

ffmpeg -version  # make sure ffmpeg is installed

Song / news not working?

npx playwright install chromium

AI not working?

Add GEMINI_API_KEY to config.js
Get free key from → https://aistudio.google.com



🏆   𝖦𝖨𝖵𝖤 𝖢𝖱𝖤𝖣𝖨𝖳

This is the 100% original project — every file, every plugin, every line of code built from scratch by Tharindu Liyanage. If you use, fork, modify, or deploy this — you MUST give proper credit. 🙏

╔══════════════════════════════════════════════════════════════════════╗
║                                                                      ║
║   ✅  Keep original developer name visible in your README            ║
║   ✅  Link back to this repository in your fork or project           ║
║   ✅  If you MODIFY this code — mention Tharindu Liyanage, Xnodes    ║
║   ✅  If you FORK this repo — credit the original author             ║
║   ✅  Do NOT remove the footer or claim as your own original         ║
║   ✅  A simple credit costs nothing — it supports open source        ║
║                                                                      ║
║   ❌  Do NOT reupload without credit                                 ║
║   ❌  Do NOT sell or monetize without permission                     ║
║                                                                      ║
╚══════════════════════════════════════════════════════════════════════╝

Original Author: Tharindu Liyanage · Xnodes Development Repository: https://github.com/xnodesdevelopers/GARFIELD-V11-CORE

"Hours of real work went into building this from scratch. If you use it — just say where you got it. That's all."




👨‍💻   𝖣𝖤𝖵𝖤𝖫𝖮𝖯𝖤𝖱

  Detail
🏗️ Architect Tharindu Liyanage
🌐 Organization Xnodes Development
🎓 University UOR · Faculty of Applied Science
🐺 Vibe Introvert · Codeaholic · Night Owl
📍 Origin 🇱🇰 Sri Lanka



⚠️   𝖣𝖨𝖲𝖢𝖫𝖠𝖨𝖬𝖤𝖱

This project is developed for educational and personal automation purposes only.
The developer holds no responsibility for misuse of this software.
WhatsApp is a trademark of Meta Platforms, Inc.
Use responsibly and comply with WhatsApp's Terms of Service.



██╗  ██╗███╗  ██╗ ██████╗ ██████╗ ███████╗███████╗
╚██╗██╔╝████╗ ██║██╔═══██╗██╔══██╗██╔════╝██╔════╝
 ╚███╔╝ ██╔██╗██║██║   ██║██║  ██║█████╗  ███████╗
 ██╔██╗ ██║╚████║██║   ██║██║  ██║██╔══╝  ╚════██║
██╔╝╚██╗██║ ╚███║╚██████╔╝██████╔╝███████╗███████║
╚═╝  ╚═╝╚═╝  ╚══╝ ╚═════╝ ╚═════╝ ╚══════╝╚══════╝

© 2026 Xnodes · All Rights Reserved

𝖯𝖮𝖶𝖤𝖱𝖤𝖣 𝖡𝖸 𝖦𝖠𝖱𝖥𝖨𝖤𝖫𝖣 𝖡𝖮𝖳 𝖵𝟏𝟏 🐼🔥


If this project helped you, drop a ⭐ on GitHub — it means the world!

[ GARFIELD v11 · XNODES · THARINDU LIYANAGE · 2026 ]


Developer

Tharindu Liyanage (Sanku)

About

Ultra-lightweight WhatsApp Bot built on Baileys. YouTube MP3 · Facebook DL · APK · Sticker · News · Gemini AI · Group Management · Any platform · Plugin architecture

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors