Metadata-Version: 2.4
Name: zapzap
Version: 6.2.4
Summary: zapzap whatsapp client web app
Author-email: Rafael Tosta <rafa.ecomp@gmail.com>
License: GPL-3.0-or-later
Project-URL: homepage, https://rtosta.com/zapzap
Keywords: zapzap,whatsapp,client,web,app
Classifier: Environment :: X11 Applications :: Qt
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Topic :: Office/Business
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyQt6
Requires-Dist: PyQt6-WebEngine
Provides-Extra: dbus
Requires-Dist: dbus-python; extra == "dbus"
Dynamic: license-file

# [ZapZap](https://rtosta.com/zapzap-web/) – WhatsApp Desktop for Linux
![ZapZap for WhatsApp](share/screenshot/default.png)

## 📌 About

ZapZap brings the WhatsApp experience on Linux closer to that of a native application.  
Since Meta does not provide a public API for third-party applications, ZapZap is developed as a [Progressive Web Application (PWA)](https://en.wikipedia.org/wiki/Progressive_web_app), built with **PyQt6 + PyQt6-WebEngine**.

---

## 📥 Download

- **[Flathub](https://flathub.org/apps/details/com.rtosta.zapzap)**  
- **[Fedora Copr](https://copr.fedorainfracloud.org/coprs/rafatosta/zapzap/)**  

---

## ✨ Features

ZapZap extends WhatsApp Web with additional features:

### 🎨 Appearance
- Adaptive **light and dark mode**
- **Fullscreen mode**
- Custom **window decorations**
- **Interface scaling adjustment** (ideal for 2K/4K screens)

### ⚡ Usability
- **Keyboard shortcuts** for main options
- Adaptive **system tray icon** (notifies new messages)
- **Background process** support
- **Drag-and-drop** functionality
- Ability to select a **custom folder for downloads**
- **Temporary folder** for opening files

### 🛠️ Extras
- **Spellchecker** with language selection via context menu
- Customizable **system tray icons**
- Option to choose a **folder for custom dictionaries**
- Setting to **disable the native file selection dialog** (Hyprland)
- **Reorganized Settings Panel**
- Added **Performance section**

---

## ⚙️ Development

ZapZap is built using **PyQt6** and **PyQt6-WebEngine**.

### Requirements
- **Python 3.9 or higher**

### Installation

1. **Clone the repository**
   ```bash
   git clone https://github.com/rafatosta/zapzap.git
   cd zapzap
   ```

2. **Install dependencies**
    ```bash
    pip install -r requirements.txt
    ```

3. Build & Run Locally
    ```bash
    python run.py [dev|preview|build] [--build-translations | --appimage | --flatpak-onefile]
    ```

The executable will be generated in the dist/ folder as zapzap.flatpak.
(Currently without full support)

#### Install as Python module
```bash
pip install .
```

#### Uninstall:
```bash
pip uninstall zapzap
```

## 📦 Packaging
- **[Fedora Copr](/fedora_copr.spec)** 
- **[Flatpak](https://github.com/flathub/com.rtosta.zapzap)**

## 🌍 Translation
ZapZap supports translations. If your language file is missing from the [po](/po) folder, submit a pull request or open an [issue](https://github.com/rafatosta/zapzap/issues).

## 🤝 Contributions
Contributions are welcome!
Please submit a pull request with any improvements or changes you wish to propose.

## 📜 License
This project is licensed under the GPL.
See the LICENSE file for more information.

## 💖 Donations
**PayPal:** [Donate via PayPal](https://www.paypal.com/donate/?business=E7R4BVR45GRC2&no_recurring=0&item_name=ZapZap+-+Whatsapp+Desktop+for+linux%0AAn+unofficial+WhatsApp+desktop+application+written+in+Pyqt6+%2B+PyQt6-WebEngine.&currency_code=USD) 

**Pix:** [Donate via Pix](https://nubank.com.br/pagar/3c3r2/LS2hiJJKzv) 

**Ko-fi:** [Donate via Ko-fi](https://ko-fi.com/X8X2E1OLG)

## 📬 Contact
**Maintainer:** Rafael Tosta 

**Email:** [rafa.ecomp@gmail.com](mailto:rafa.ecomp@gmail.com)
