How rafatosta/zapzap works
ZapZap is a Python/PyQt6 desktop wrapper for WhatsApp Web. A user launches the desktop app, which sets up the runtime and opens the browser shell; that shell manages isolated account sessions and embedded WhatsApp Web pages. The app also adds native desktop capabilities including tray controls, notifications, themes, downloads, spell checking, and account-specific customization. The graph preserves these documented feature areas, but unsampled subsystems are represented at their existing directory paths; their internal call wiring is not inferred.
Main entry points: main_window_controller.py Main window · application.py Application startup · browser_controller.py Browser shell · download_manager.py Download handling
Components 19
App lifecycle
- Application startup
zapzap/app/application.py - Main window
zapzap/app/main_window_controller.py - Runtime setup
zapzap/core/environment/setup_manager.py
Web and accounts
- Browser shell
zapzap/features/browser/shell/browser_controller.py - Embedded web page
zapzap/features/browser/web/web_view.py - Account profiles
zapzap/features/accounts/domain/user.py - Account management
zapzap/features/accounts/card_user_controller.py
Desktop integrations
- System tray
zapzap/features/tray/sys_tray_manager.py - Desktop notifications
zapzap/features/notifications - Download handling
zapzap/features/downloads/download_manager.py - Spell checking
zapzap/features/dictionaries - Donation page
zapzap/features/donation/page.py - Download events
zapzap/features/downloads/download_events.py
Settings and customization
- Theme manager
zapzap/core/theme/theme_manager.py - Settings store
zapzap/core/config/settings_manager.py - CSS and JS customization
zapzap/features/customizations/customizations_manager.py - Settings interface
zapzap/features/settings/shell/settings_controller.py
Other components
- Desktop user
- WhatsApp Web
Connections 21
- Desktop user → Application startup: launches
README.md - Application startup → Main window: creates
zapzap/app/application.py - Application startup → Runtime setup: configures
zapzap/app/application.py - Main window → Browser shell: opens
zapzap/app/main_window_controller.py - Browser shell → Embedded web page: creates
zapzap/features/browser/shell/browser_controller.py - Embedded web page → WhatsApp Web: loads
README.md - Browser shell → Account profiles: manages
zapzap/features/browser/shell/browser_controller.py - Account management → Account profiles: uses
zapzap/features/accounts/card_user_controller.py - Main window → Settings interface: opens
zapzap/app/main_window_controller.py - Main window → Download handling: uses
zapzap/app/main_window_controller.py - Download handling → Download events: emits events
zapzap/features/downloads/download_manager.py - Main window → Theme manager: uses
zapzap/app/main_window_controller.py - Theme manager → Settings store: reads and writes
zapzap/core/theme/theme_manager.py - Main window → System tray: binds window
zapzap/app/main_window_controller.py - Main window → Donation page: opens
- Desktop user → Desktop notifications: receives
README.md - Desktop user → Spell checking: uses
README.md - Desktop user → CSS and JS customization: configures
README.md - Desktop user → System tray: controls
README.md - Desktop user → Download handling: downloads through
README.md - Settings interface → CSS and JS customization: configures