edgymeow

library0.0.20jsnpmunverified

EdgyMeow is a WebSocket JSON-RPC 2.0 server for WhatsApp Web automation, version 0.0.20. It provides a Go-based backend (whatsmeow) wrapped as a Node.js CLI tool with pre-built binaries for Linux, macOS, and Windows. Key features include QR code authentication, anti-ban rate limiting, SQLite storage for sessions and history, and a built-in web dashboard. Released under MIT license, updated monthly.

messaging devops

npm install edgymeow

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · EDGYMEOW

edgymeow

messagingjavascriptv0.0.20

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

edgymeow (CLI)

✓ npx edgymeow start

✗ npm run edgymeow

The package is a CLI tool, not a library. Use npx or global install.

WebSocket client (JSON-RPC)

✓ const ws = new WebSocket('ws://localhost:9400/ws/rpc');

✗ const ws = require('ws').connect('ws://localhost:9400/rpc');

Connect to /ws/rpc endpoint with WebSocket. No library import needed.

RPC call

✓ ws.send(JSON.stringify({jsonrpc: '2.0', id: 1, method: 'sendMessage', params: {jid: '...', message: '...'}}));

✗ ws.send({jsonrpc: '2.0', id: 1, method: 'sendMessage'});

Use JSON-RPC 2.0 format; params must be an object or array.

Starts the EdgyMeow server and shows how to connect via WebSocket and get a QR code for WhatsApp authentication.

// Start the server (in terminal) npx edgymeow start // Then connect via WebSocket (example in Node.js using ws library) const WebSocket = require('ws'); const ws = new WebSocket('ws://localhost:9400/ws/rpc'); ws.on('open', () => { // Request QR code for authentication ws.send(JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'getQR' })); }); ws.on('message', (data) => { const response = JSON.parse(data); if (response.id === 1) { console.log('QR code data:', response.result); // Scan the QR with WhatsApp mobile app } }); // To send a message after authenticated: // ws.send(JSON.stringify({ // jsonrpc: '2.0', // id: 2, // method: 'sendMessage', // params: { jid: '1234567890@s.whatsapp.net', message: 'Hello from EdgyMeow!' } // }));

Debug

Known issues

gotchaDefault port 9400 may conflict with other services. Use --port to change.

fix

npx edgymeow start --port 8080

affects: >=0.0.1

breakingNode.js >=18 required; older versions will fail to start.

fix

Upgrade Node.js to v18 or higher.

affects: >=0.0.1

deprecatedPython-based dashboard (edgymeow dashboard) is deprecated; use npx edgymeow web instead.

fix

Use npx edgymeow web for standalone web dashboard.

affects: >=0.0.15

gotchaPre-built binaries may fail on unsupported architectures (e.g., ARM64 Linux). Build from source with Go.

fix

Install Go and run npx edgymeow build before start.

affects: >=0.0.1

gotchaWhatsApp may ban accounts using automated messaging. Use rate limiting and respect anti-spam policies.

fix

Ensure you have rate limiting enabled; do not send high-volume messages.

affects: >=0.0.1

Errors

Common errors & fixes

Error: listen EADDRINUSE :::9400

Another process is already using port 9400.

fix

Kill the conflicting process or use a different port: npx edgymeow start --port 9401

Error: Cannot find module './bin/edgymeow'

The pre-built binary is missing or not downloaded correctly.

fix

Reinstall the package: npm install edgymeow@latest. If persists, try building from source: npx edgymeow build

WebSocket connection to 'ws://localhost:9400/ws/rpc' failed: 403 Forbidden

Server is running but not accepting connections (possibly CORS or rate limiting).

fix

Ensure the server is fully started and not blocked by firewall. Check logs with npx edgymeow status.

Upgrade

Version history

0.0.20latest on npm

Audit

Dependencies

whatsmeowrequiredGo library for WhatsApp Web protocol used under the hood

Agent activity

28 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/trohitg/edgymeow ↗

packageedgymeow ↗

homepagehttps://github.com/trohitg/edgymeow#readme ↗