Whatsme - WhatsApp in VS Code

Keep your WhatsApp conversations flowing while coding. Whatsme brings WhatsApp messaging directly into Visual Studio Code.

Developed by Jefter Tokomere, Obert Kakomo, and Manchester Pise, students of the National University of Science and Technology.

Features

✨ Key Features:

• 💬 Integrated Chat Interface - Manage WhatsApp conversations without leaving VS Code
• 🔐 Secure Authentication - QR code-based login with automatic session management
• 📱 Real-time Messages - Receive and send messages instantly
• 📬 Chat Management - View all chats with unread message indicators
• 🔔 Notifications - Get notified of new messages (configurable)
• ⚙️ Customizable - Adjust refresh intervals, themes, and auto-read preferences
• 🌙 Light & Dark Theme Support - Adapts to your VS Code theme

How to Use

1. Install the Extension

Install Whatsme from the Visual Studio Code Marketplace.

2. Authenticate with WhatsApp

• Click the Whatsme icon in the activity bar
• Click "Authenticate with WhatsApp"
• Scan the QR code with your WhatsApp app
• Your session will be saved for future use

3. Start Messaging

• View your chats in the sidebar
• Click any chat to open the conversation
• Type and send messages directly from VS Code
• Messages appear instantly in WhatsApp

Configuration

Customize Whatsme behavior in VS Code Settings:

{
  "whatme.autoRefreshInterval": 5000,        // Chat refresh interval in ms
  "whatme.enableNotifications": true,        // Show message notifications
  "whatme.markAsReadAutomatically": true,   // Auto-mark messages as read
  "whatme.theme": "auto"                     // light, dark, or auto
}

Commands

• Open Whatsme Chat - Open the main chat interface
• Authenticate with WhatsApp - Start WhatsApp authentication
• Logout from WhatsApp - Sign out of your WhatsApp account
• Refresh Chat List - Manually refresh your chats
• Whatsme Settings - Open extension settings

How Users Run the Extension

After installation, users can start in any of these ways:

1. Open the Activity Bar and click Whatsme.
2. Open Command Palette and run Open Whatsme Chat.
3. If not authenticated yet, run Authenticate with WhatsApp, then scan the QR with the WhatsApp phone app.
4. Select a chat from the sidebar and send messages from the panel.

Quick local install from VSIX:

code --install-extension whatsme-0.0.1.vsix

Security & Privacy

• Your messages are processed locally on your machine
• WhatsApp session data is stored securely in VS Code's global storage
• No data is transmitted to external servers (except WhatsApp Web)
• You can logout anytime to clear your session

Troubleshooting

QR Code Not Appearing?

• Check your internet connection
• Try re-authenticating via the command palette
• Ensure VS Code has proper permissions

Messages Not Syncing?

• Use the Refresh Chat List command
• Check the auto-refresh interval in settings
• Verify you're still logged into WhatsApp on your phone

Extension Not Activating?

• Reload VS Code (Ctrl+Shift+P → "Developer: Reload Window")
• Check extension details in the Extensions sidebar
• Review output logs

Limitations

• Requires an active WhatsApp account on your phone
• Message media (images, videos) display as indicators only in beta
• Group message reactions not yet supported in this version

Contributing

Found a bug? Have a feature request? Visit our GitHub repository to contribute!

Support

Need help? Check out:

• Documentation
• Issues & Bug Reports

License

MIT License - See LICENSE file for details

Disclaimer

Whatsme is an unofficial, third-party extension. It is not affiliated with, endorsed by, or related to WhatsApp Inc. WhatsApp and the WhatsApp logo are trademarks of WhatsApp Inc. Use at your own discretion and comply with WhatsApp's Terms of Service.

Made with care for developers who code fast and chat faster