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