v1.0.1

WhatsApp Desktop Linux v1.0.1

🔧 Bug Fix & Enhancement Release - Major improvements to desktop integration and user experience

🆕 What's New

Single Instance Application

• No more duplicate instances - Only one WhatsApp instance can run at a time
• Smart window management - Launching app when already running brings existing window to front
• Tray integration - If app is minimized to tray, launching again restores and focuses the window

Intelligent Desktop Shortcut Management

• User-controlled shortcuts - No automatic/forced shortcut creation
• Dynamic system tray menu that adapts based on current state:
  • Shows "Create Desktop Shortcut" when no shortcut exists
  • Shows "Remove Desktop Shortcut" when shortcut is installed
• One-click shortcut management via right-click tray menu

🐛 Critical Fixes

Notification System Overhaul

• Fixed duplicate notifications - Eliminated "You have a new message" + content notification pairs
• Disabled WhatsApp Web's native notifications to prevent conflicts
• Clickable notifications - Click any notification to bring WhatsApp window to front
• Smart notification logic - Only shows notifications when unread count increases

KDE Desktop Integration Fixed

• Resolved taskbar pinning errors - No more "Could not find program" errors
• Proper path escaping - Fixed spaces in AppImage filename causing launch failures
• Persistent desktop files - Creates shortcuts in ~/.local/share/applications/ instead of temp locations
• Desktop database updates - Automatically refreshes system application database

✨ User Experience Improvements

Enhanced System Tray

• Improved "Show WhatsApp" action - Now properly focuses window
• Clear visual feedback - Success/error notifications for all shortcut operations
• Better menu organization - Logical grouping with separators

Desktop Integration

• Proper StartupWMClass - Better window management in KDE and other DEs
• Icon management - Copies app icon to user's icon directory for persistence
• Clean removal - Remove shortcut option cleans up properly while preserving icon for reuse

🔧 Technical Improvements

• Enhanced error handling with user-friendly notifications
• Better debugging with detailed console logging
• Improved AppImage detection and path handling
• Proper desktop file formatting with correct categories and metadata

📥 Installation & Usage

Download & Run

1. Download WhatsApp Web-1.0.1.AppImage from assets below
2. Make executable: chmod +x WhatsApp\ Web-1.0.1.AppImage
3. Run: ./WhatsApp\ Web-1.0.1.AppImage

Desktop Integration

• Right-click system tray icon → "Create Desktop Shortcut"
• Pin to taskbar now works correctly in KDE and other desktop environments
• Remove shortcut anytime via tray menu

🎯 Migration from v1.0.0

If upgrading from v1.0.0:

1. Remove old broken shortcuts (if any):

   rm ~/.local/share/applications/whatsapp-web-wrapper.desktop

2. Run new version and use tray menu to create fresh shortcut

⌨️ Keyboard Shortcuts

• Ctrl+Tab - Next conversation
• Ctrl+Shift+Tab - Previous conversation
• Ctrl+M - Mute/unmute current chat

🔍 Known Issues Fixed

• ❌ Duplicate notifications appearing
• ❌ Notification clicks not working
• ❌ KDE taskbar pinning failures
• ❌ AppImage path with spaces causing errors
• ❌ Multiple app instances running simultaneously

🤝 Contributing

Found a bug or have a feature request?

• 🐛 Report issues: Create an issue
• 💡 Feature requests: Open a discussion
• 🔧 Contribute code: Submit a PR

📄 License

Released under the MIT License.

⚠️ Disclaimer

This is an unofficial WhatsApp client. WhatsApp is a trademark of Meta Platforms, Inc.

---

Full Changelog: v1.0.0...v1.0.1

WhatsApp Desktop Linux v1.0.0

🎉 Initial Release - Native WhatsApp Web desktop application for Linux

🚀 What's New

This is the first stable release of WhatsApp Desktop Linux, bringing a native desktop experience for WhatsApp Web on Linux systems.

✨ Features

Core Functionality

• 📱 Native WhatsApp Web Integration - Full WhatsApp Web functionality wrapped in a native desktop application
• 🚫 Sandbox-Free Launch - No more --no-sandbox flags required - the app handles this automatically
• 📦 AppImage Distribution - Single-file executable that runs on most Linux distributions

Desktop Integration

• 🔔 System Notifications - Desktop notifications for new messages when the app is not focused
• 🎛️ System Tray Support - Minimize to system tray with quick access menu
  • Left-click to show/hide window
  • Right-click for context menu
  • Close button minimizes to tray instead of quitting

Keyboard Shortcuts

Intuitive keyboard navigation for power users:

• Ctrl+Tab - Switch to next conversation
• Ctrl+Shift+Tab - Switch to previous conversation
• Ctrl+M - Mute/unmute current chat

Auto-Updates

• 🔄 Automatic Update Checking - App checks for updates on startup
• 📢 Update Notifications - Desktop notifications when updates are available
• 🔗 GitHub Releases Integration - Seamless update delivery

🛠️ Technical Details

• Framework: Electron v37.2.3
• Build System: electron-builder v26.0.12
• Target Platforms: Linux x64
• Distribution Format: AppImage
• Security: Modern Electron security practices with proper sandboxing

📥 Installation

Download & Run

1. Download WhatsApp Web-1.0.0.AppImage from the assets below
2. Make it executable: chmod +x WhatsApp\ Web-1.0.0.AppImage
3. Run: ./WhatsApp\ Web-1.0.0.AppImage

System Requirements

• OS: Linux (64-bit)
• Desktop Environment: Any with system tray support (GNOME, KDE, XFCE, etc.)
• Dependencies: None (all bundled in AppImage)

🐛 Known Issues

• Some Linux distributions may require enabling system tray extensions

🤝 Contributing

This is an open-source project! Contributions are welcome:

• 🐛 Report bugs: Create an issue
• 💡 Request features: Create an issue
• 🔧 Submit code: Create a pull request

📄 License

Released under the MIT License.

⚠️ Disclaimer

This is an unofficial WhatsApp client. WhatsApp is a trademark of Meta Platforms, Inc. This project is not affiliated with or endorsed by Meta Platforms, Inc.

---

Full Changelog: https://github.com/codeXpedite/whatsapp-desktop-linux/commits/v1.0.0