HN
Today

Peter Steinberger – WhatsApp CLI: sync, search, send

This project introduces wacli, a command-line interface for WhatsApp, enabling advanced users to sync, search, and send messages with greater control. It leverages the WhatsApp Web protocol through whatsmeow, offering features like offline search and programmatic interaction. This tool appeals to the Hacker News audience by providing a robust, open-source solution for automating and managing their messaging data outside of the official application.

16
Score
2
Comments
#1
Highest Rank
14h
on Front Page
First Seen
Apr 15, 7:00 AM
Last Seen
Apr 15, 8:00 PM
Rank Over Time
11258111520241014202125

The Lowdown

The wacli project provides a command-line interface (CLI) for WhatsApp, built on the whatsmeow library, designed to offer power users enhanced control over their messaging data. This third-party tool, not affiliated with WhatsApp, focuses on functionalities typically unavailable through the standard application, catering to those who prefer interacting with services via the terminal.

  • Core Functionality: Key features include best-effort local synchronization of message history with continuous capture, fast offline search capabilities, sending messages, and comprehensive contact and group management.
  • Technical Foundation: It operates by utilizing the WhatsApp Web protocol, offering a programmatic interface to WhatsApp's ecosystem.
  • Installation & Usage: Users can install wacli via Homebrew or by building it locally with Go. The README provides quick start examples for authentication, continuous syncing, searching messages, downloading media, sending various message types (text, files), and managing groups.
  • Recent Enhancements: Version 0.2.0 brought updates such as improved message display for reactions and replies, the ability to override display names when sending files, and environmental variable options for device labeling.
  • Data Management: Messages and associated data are stored locally, defaulting to ~/.wacli, with options for directory override. The tool also supports 'best-effort' backfilling of older message history, which requires the primary device to be online and is performed on a per-chat basis.

wacli stands out as a compelling tool for developers and privacy-conscious users who desire more granular control, automation, and offline access to their WhatsApp communications, extending the platform's utility beyond its native applications.