greenido/wacrawl-ui

WaCrawl Dashboard is a local analytics tool for looking through your own WhatsApp history. It works together with a separate tool called wacrawl, which creates a SQLite archive of your WhatsApp data, and this dashboard reads that archive to show charts, contact lists, chat history, and media in a browser based interface that only runs on your own computer. The project is a small monorepo containing a read only Express API and a React plus Vite frontend, connected over CORS but restricted to localhost only, meaning nothing leaves your machine. The simplest way to run it is a single command, npx wacrawl-dashboard, which opens the dashboard in a browser at a local address. It requires Node.js version 20 or higher and an existing wacrawl archive file. Once running, the dashboard shows overview cards for total messages, chats, contacts, and media, along with charts for message volume over time, top contacts, activity by hour and day, and a word cloud of common terms. A People section lists contacts ranked by activity, a Chats section lets you browse conversations and read messages, a Media section shows a scrollable grid of images, videos, and audio, and a Search section provides full text search across messages. A Settings panel lets you point the dashboard at different archive file locations and shows whether the database is readable. The tool is built with privacy and safety in mind: the API only listens on the local machine, the WhatsApp database is opened in read only mode, and identifiers for certain contact types are hidden from the display. The app also includes light and dark themes, keyboard shortcuts, and a database optimization command that adds search indexes to speed up full text search after new data is synced. This is a companion viewer for people who already use wacrawl to archive their own WhatsApp conversations, aimed at anyone who wants to see personal statistics and browse their message history locally rather than through the WhatsApp app itself.