██████╗ █████╗ ██████╗ ███████╗██╗███████╗██╗ ██████╗ ██╗ ██╗ ██╗ ██╗
██╔════╝ ██╔══██╗██╔══██╗██╔════╝██║██╔════╝██║ ██╔══██╗ ██║ ██║███║ ██║
██║ ███╗███████║██████╔╝█████╗ ██║█████╗ ██║ ██║ ██║ ██║ ██║╚██║ ██║
██║ ██║██╔══██║██╔══██╗██╔══╝ ██║██╔══╝ ██║ ██║ ██║ ╚██╗ ██╔╝ ██║ ██║
╚██████╔╝██║ ██║██║ ██║██║ ██║███████╗███████╗██████╔╝ ╚████╔╝ ██║ ██║
╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝╚══════╝╚══════╝╚═════╝ ╚═══╝ ╚═╝ ╚═╝
┌──────────────────────────────────────────────────────────────────────────┐
│ │
│ 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 |
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 -versionStep 2 — Clone the project
git clone https://github.com/xnodesdevelopers/GARFIELD-V11-CORE.git
cd GARFIELD-V11-COREStep 3 — Install dependencies
npm install
npx playwright install chromiumStep 4 — Configure
nano config.jsOWNER_NUMBER: '94711234567', // your number without +
PREFIX: '.',
MODE: 'public',
GEMINI_API_KEY: 'your_key_here', // optional — get from aistudio.google.comStep 5 — Add menu video
# put your menuvideo.mp4 inside lib/ folder
ls lib/menuvideo.mp4 # must existStep 6 — First launch & scan QR
node index.js📱 QR code appears → Open WhatsApp → Linked Devices → Link a Device → Scan After scan press
Ctrl+C
Step 7 — Install PM2 & start bot
npm install -g pm2
npm startStep 1 — Install Node.js
- Download from https://nodejs.org → install LTS (v20+)
- Open Command Prompt and verify:
node -v
npm -vStep 2 — Install FFmpeg
- Download from https://ffmpeg.org/download.html
- Extract and add
ffmpeg/binto System PATH - Verify:
ffmpeg -versionStep 3 — Install Git
- Download from https://git-scm.com → install
Step 4 — Clone & install
git clone https://github.com/xnodesdevelopers/GARFIELD-V11-CORE.git
cd GARFIELD-V11-CORE
npm install
npx playwright install chromiumStep 5 — Configure
notepad config.jsOWNER_NUMBER: '94711234567', // your number without +
PREFIX: '.',
MODE: 'public',
GEMINI_API_KEY: 'your_key_here', // optionalStep 6 — Add menu video
- Put
menuvideo.mp4inside thelib/folder
Step 7 — First launch & scan QR
node index.js📱 QR code appears → Open WhatsApp → Linked Devices → Link a Device → Scan After scan press
Ctrl+C
Step 8 — Install PM2 & start bot
npm install -g pm2
npm startStep 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 -versionStep 3 — Clone & install
git clone https://github.com/xnodesdevelopers/GARFIELD-V11-CORE.git
cd GARFIELD-V11-CORE
npm install
npx playwright install chromiumStep 4 — Configure
nano config.jsOWNER_NUMBER: '94711234567', // your number without +
PREFIX: '.',
MODE: 'public',
GEMINI_API_KEY: 'your_key_here', // optionalStep 5 — Add menu video
- Put
menuvideo.mp4inside thelib/folder
Step 6 — First launch & scan QR
node index.js📱 QR code appears → Open WhatsApp → Linked Devices → Link a Device → Scan After scan press
Ctrl+C
Step 7 — Install PM2 & start bot
npm install -g pm2
npm startPM2 keeps your bot running 24/7. Auto-restarts on crash. Survives server reboots.
| Command | Action |
|---|---|
npm start |
|
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 youCheck 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 botQR expired?
rm -rf sessions/
node index.js # scan new QRSticker / tomp3 not working?
ffmpeg -version # make sure ffmpeg is installedSong / news not working?
npx playwright install chromiumAI 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.
██╗ ██╗███╗ ██╗ ██████╗ ██████╗ ███████╗███████╗
╚██╗██╔╝████╗ ██║██╔═══██╗██╔══██╗██╔════╝██╔════╝
╚███╔╝ ██╔██╗██║██║ ██║██║ ██║█████╗ ███████╗
██╔██╗ ██║╚████║██║ ██║██║ ██║██╔══╝ ╚════██║
██╔╝╚██╗██║ ╚███║╚██████╔╝██████╔╝███████╗███████║
╚═╝ ╚═╝╚═╝ ╚══╝ ╚═════╝ ╚═════╝ ╚══════╝╚══════╝
If this project helped you, drop a ⭐ on GitHub — it means the world!
[ GARFIELD v11 · XNODES · THARINDU LIYANAGE · 2026 ]

| Tharindu Liyanage (Sanku) |
|---|
