Coffee Bot is a lightweight WhatsApp Bot written in Node.js that automatically updates your WhatsApp profile picture. It supports custom sizes.
- Sets WhatsApp DP from
profile/folder. - Secure login using pairing codes.
- Cleans up session files like
Session/after completion. - Works on Windows, Mac, and Linux.
- Internet connection
- Node.js: v21.x or higher
- npm: Included with Node.js
- WhatsApp account: Valid phone number (e.g.,
+91629717594x) - Profile picture: JPG/PNG in
profile/folder (e.g.,profile.jpg)
πͺ Install for Windows
- Download and install Node.js from: https://nodejs.org
- Download and install Git from: https://git-scm.com/downloads
node -v
npm -v
git --versiongit clone https://github.com/Aeon-San/Coffee.git
cd Coffeenpm installCreate or edit the settings.js file with the following content:
module.exports = {
auth: "pairing",
sessionFile: "./Session",
BotName: "Coffee Bot",
additionalConfig: { proxy: null, retryCount: 5 },
};Place a JPG or PNG file inside the profile/ folder (e.g. profile.jpg).
npm startπ Install for macOS
- Install Node.js using Homebrew:
Or download from: https://nodejs.org
brew install node
- Install Git using Homebrew:
brew install git
node -v
npm -v
git --versiongit clone https://github.com/Aeon-San/Coffee.git
cd Coffeenpm installCreate or edit the settings.js file with the following content:
module.exports = {
auth: "pairing",
sessionFile: "./Session",
BotName: "Coffee Bot",
additionalConfig: { proxy: null, retryCount: 5 },
};Place a JPG or PNG file inside the profile/ folder (e.g. profile.jpg).
npm startπ§ Install for Linux (Ubuntu/Debian)
sudo apt update
sudo apt install nodejs npmOr install via NVM:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
source ~/.bashrc
nvm install 16sudo apt install gitnode -v
npm -v
git --versiongit clone https://github.com/Aeon-San/Coffee.git
cd Coffeenpm installCreate or edit the settings.js file with the following content:
module.exports = {
auth: "pairing",
sessionFile: "./Session",
BotName: "Coffee",
additionalConfig: { proxy: null, retryCount: 5 },
};Place a JPG or PNG file inside the profile/ folder (e.g. profile.jpg).
npm start1. Enter your phone number (e.g., 91629717594x)
2. Open WhatsApp β Settings β Linked Devices β Link with phone number
3. Enter the pairing code shown in the terminal
- The bot exits automatically after setting the DP.
- A new pairing code is required each time.
- Ensure your profile image is correctly named and placed inside the
profile/folder.
Developed by Aeon San If you found this Coffee Bot useful and want to support further development, you can buy me a coffee! β€οΈ
- Baileys β WhatsApp Web Reverse-Engineering Library.
This project is Unlicensed β for personal use only.