WhatsApp Command Center

Big-screen WhatsApp display for production teams.

What it does

• Connects to WhatsApp using Baileys.
• On first run, guides you through QR setup and selecting groups to watch.
• Runs a local dashboard in the browser and streams new group messages live over WebSocket.
• New messages trigger red screen flashing until you stop it (button or s key).
• Includes fullscreen mode and optional keyword-only display filtering.

Run

cd whatsapp-command-center
npm install
npm start

On startup, the dashboard runs at http://localhost:3399 by default.

Re-run setup anytime (including searchable group picker):

npm start -- --setup

If the app loses connection to WhatsApp (e.g. dashboard still says "Connected" but messages stop, or you see decrypt/session errors in the log), re-link by rescanning the QR code:

npm start -- --rescan

Or with the global command: whatsappCC --rescan. This clears the WhatsApp session and runs setup again so you can scan a fresh QR and pick groups.

Installed command (background mode)

If installed as a package, run:

whatsappCC

This starts the app in the background and writes logs to whatsapp-command-center.log.

Run in foreground instead:

whatsappCC --foreground

Behavior

• Default: shows all messages from selected groups.
• Optional keyword mode: open http://localhost:3399/settings, enable Only show keyword matches, add comma-separated keywords, then save.
• In keyword mode, only matching messages are displayed on the dashboard stream.
• Settings page also includes:
  • pulse enable/disable
  • pulse mode: all messages or keyword matches
  • dedicated pulse keywords (separate from display filter keywords)
  • message font size
  • group enable/disable checkboxes
  • per-group keyword inputs (override global keywords for that group)
  • group search by name
  • optional PIN lock for group management (unlock required before group list is shown)
• Home dashboard header shows watched group names (not only the count).

Notes

• wa-qr.png is generated during setup for easy scanning.
• Config is saved at whatsapp-command-center/data/config.json.
• Set WACC_OPEN_DASHBOARD=0 to disable automatic browser open.