Sprig is an open-source desktop application published on GitHub, designed to provide a unified, native messaging desktop client for Linux (Ubuntu, Debian, Fedora, Arch, Linux Mint, etc.) supporting both WhatsApp Web and Google Messages Web (SMS/RCS).
It operates as an independent, lightweight desktop wrapper around official WhatsApp Web (web.whatsapp.com) and Google Messages Web (messages.google.com/web), enhancing them with isolated multi-account support, a collapsible sidebar, custom avatar badges, compact navigation mode, comprehensive settings, and native whatsapp:// and sms: deep link integration.
AI Coding Assistants: See AGENTS.md for project rules, architecture guidelines, and commands.
Sprig is built with a strict privacy-first architecture:
- 🛡️ Zero Telemetry & Tracking: Sprig collects zero user data, tracks zero analytics, and contains no external tracking scripts or advertising SDKs.
- 🔐 End-to-End Encryption Maintained: All messaging, voice, and video traffic occurs directly between your local app instance and official messaging servers (
web.whatsapp.comandmessages.google.com). No intermediate proxy or relay servers are ever used. - 📂 Local Session Isolation: Account login sessions and credentials are stored strictly on your local machine in segregated Electron session partitions (
persist:wa-<id>for WhatsApp andpersist:gm-<id>for Google Messages). - 🌐 Fully Open Source: The complete source code is 100% open source and published on GitHub for total transparency and community audit.
Choose the installation option that best matches your Linux desktop environment:
- Download the latest
sprig_1.0.0_amd64.debfile from the GitHub Releases Page. - Double-click the downloaded
.debfile to open it in your system App Center / Software Center / GDebi. - Click Install and enter your password. Sprig will now appear in your app launcher!
Alternatively, if you prefer the terminal, copy-paste this single line:
sudo apt install ./sprig_1.0.0_amd64.deb- Download
Sprig-1.0.0-x64.AppImagefrom the GitHub Releases Page. - Right-click the downloaded file -> select Properties -> go to Permissions -> check "Allow executing file as program".
- Double-click the file to launch Sprig instantly—no installation required!
Terminal 1-liner for AppImage:
chmod +x Sprig-1.0.0-x64.AppImage && ./Sprig-1.0.0-x64.AppImage- 🔀 Multi-Account & Multi-Messenger Support — Manage multiple WhatsApp and Google Messages accounts simultaneously in completely segregated session partitions.
- 🏷️ Distinct Service Badges & Custom Avatars — Visual WhatsApp (green) and Google Messages (blue) badges on account avatars with custom photo avatar upload support.
- 🍃 Botanical Emerald Design System — Polished UI styled with emerald accents (
#16B364), dark background (#0E1512), and clean panel surfaces. - 📐 Collapsible Sidebar Rail — Switch between a full sidebar (240px) and a compact icon rail (64px) with avatar protection.
- ⚡ Compact Navigation Chrome — Hides redundant web chrome to maximize chat workspace.
- ⚙️ Full Settings Preferences — Auto-start on boot, close-to-tray, start minimized, color themes, display zoom, sound alerts, tray unread badges, and cache management.
- 🔗 Deep Link Handlers (
whatsapp://&sms:) — Clicking WhatsApp or SMS chat links anywhere in Linux routes directly to the corresponding service inside Sprig. - 🖥️ Native Desktop & System Tray Integration — High-contrast tray icon and live unread badge counters across Linux desktop docks and trays (GNOME, KDE, Ubuntu).
| Shortcut | Action |
|---|---|
| Ctrl + 1 .. 9 | Switch directly to Account 1 through Account 9 |
| Ctrl + Tab | Cycle forward to the next account |
| Ctrl + Shift + Tab | Cycle backward to the previous account |
| Ctrl + N | Open the Add Account dialog |
| Ctrl + + / = | Zoom in (+10%) |
| Ctrl + - | Zoom out (-10%) |
| Ctrl + 0 | Reset zoom (100%) |
| Ctrl + Shift + I / F12 | Toggle Developer Tools |
| Esc | Close open dialogs or Settings modal |
If you want to build or modify Sprig from source code:
# 1. Clone the repository
git clone https://github.com/made-on-weekends/sprig.git
cd sprig
# 2. Install dependencies
npm install
# 3. Launch in dev mode
npm run dev
# 4. Build Linux release packages (.deb & AppImage)
npm run build:deb
npm run build:appimage- AGENTS.md — Coding agent guidelines.
- docs/ARCHITECTURE.md — System architecture & process separation.
- docs/DESIGN.md — Design system specification.
- docs/PRODUCT.md — Product scope.
- docs/SECURITY.md — Session isolation and security rules.
Sprig is an independent, open-source third-party client wrapper around WhatsApp Web and Google Messages Web. It is not affiliated with, authorized, maintained, sponsored, or endorsed by Meta Platforms, Inc., Google LLC, or any of their affiliates. WhatsApp is a trademark of Meta Platforms, Inc. Google Messages is a trademark of Google LLC.
Encountered an issue or have a feature suggestion?
- View our Quick Guide to Reporting Issues before submitting an issue.
- Read AGENTS.md for quick command reminders and agent coding guidelines.
We are always looking for improvements and additions! Please read the Contribution Guide to understand our branching strategy, conventions, and pull request checklist.
If Sprig helps you manage your messaging accounts seamlessly on Linux:
- ⭐ Star this repository to help others discover the project.
- 📣 Spread the word on X/Twitter or your blog.
- ☕ Support the maintainer via donation to fund further open-source initiatives.
This project is licensed under the MIT License.