WhatsLNX v0.4.0

Added

• "About WhatsLNX" tray menu item opening a window with the current version
  and this release's notes (no more whatslnx -v in a terminal)
• "License" tray menu item opening a viewer for the full GPL-3.0 text

Fixed

• Deep links (whatsapp://send?...) reloaded the app and then wedged on a
  blank window: WhatsApp Web registers a beforeunload handler, which
  silently cancelled the deep-link navigation. The window now forces
  navigations past beforeunload (will-prevent-unload), so links open the
  chat reliably
• Save dialog appeared twice for one download: WhatsApp Web fires the same
  download twice in quick succession and each request prompted again.
  Duplicate requests (same URL + filename within 10 s) now reuse the
  already-approved save path silently

WhatsLNX v0.3.2

Added

• Embedded AppImage update information (gh-releases-zsync channel) and a
  matching .zsync asset per release, so users can update with AppImageUpdate
  / appimageupdate-style tools in addition to the built-in electron-updater

WhatsLNX v0.3.1

Fixed

• AppImage repack: --appimage-extract applies the caller's umask, so the
  repacked squashfs stored 0700 directories. Environments that extract the
  AppImage as root (e.g. firejail --appimage, used by the AppImage catalog
  test) then cannot traverse to AppRun as the regular user ("Permission
  denied"). The repack script now normalizes with chmod -R a+rX before
  packing, matching electron-builder's stored 0755 directories

Changed

• README now links the project website / APT repository at
  kmmuntasir.github.io/WhatsLNX

WhatsLNX v0.3.0

Added

• Offline page: when WhatsApp Web cannot be reached (no network), a local
  "You're offline" screen is shown instead of a blank window, with a Reconnect
  button, automatic retry every 15 seconds, and instant retry when connectivity
  returns (fixes the AppImage catalog test failure — the app now shows content
  when started without network access)

Fixed

• File downloads: clicking download on a received file showed the save dialog
  but never saved anything — event.preventDefault() in the will-download
  handler cancels the download in current Electron versions. The handler now
  always resolves to either the chosen save path or an explicit cancel
• Auto-updater no longer emits UnhandledPromiseRejectionWarning when the
  machine is offline (rejections are handled via the existing error handler)

Changed

• AppImage is repacked with the modern statically-linked AppImage runtime
  (type2-runtime via appimagetool) — it no longer depends on the EOL
  libfuse2 or the system C library to mount, so it runs out of the box on
  current distributions (Ubuntu 24.04+, Fedora, Arch, …). Delta updates are
  replaced by full downloads; latest-linux.yml is regenerated with matching
  checksums (npm run build:appimage && npm run repack:appimage locally)
• Release workflow publishes via gh release create after the repack step
• Updated Electron 42.2.0 → 44.5.1 (Chromium 140 → 152), electron-builder
  26.8.1 → 26.15.3, electron-updater 6.8.3 → 6.8.9, ESLint 10.4.0 → 10.11.0

0.2.1

Added

• "Close button minimizes to tray" toggle in Settings (default: enabled). When disabled, the close button quits the app instead of hiding to tray.

Fixed

• Tray context menu showed "Hide WhatsLNX" instead of "Show WhatsLNX" after close-to-tray. Context menu is now rebuilt on window show/hide events.
• Settings window threw "Attempted to register a second handler" error on reopening. IPC handlers are now registered once.
• Settings toggle for close-to-tray didn't respond to clicks. Fixed by wrapping toggle in <label>.
• Settings window content was clipped and not scrollable. Changed overflow: hidden to overflow-y: auto.
• App didn't quit when close-to-tray was disabled — window closed but tray stayed alive. Close handler now explicitly calls app.quit().
• "Object has been destroyed" crash when interacting with tray menu after window was destroyed. Added isDestroyed() guards.

0.2.0

v0.2.0

Add workflow_dispatch trigger to release workflow

0.1.0

WhatsLNX v0.1.0

Initial release of WhatsLNX — a minimalist, high-performance unofficial WhatsApp desktop client for Linux.

Installation

AppImage (any Linux distro) — download, chmod +x, run.

DEB (Ubuntu/Debian/Mint) — see install instructions.

Highlights

• Wayland & X11 — auto-detected, no flags needed
• Audio/Video Calling — automatic camera and microphone permissions
• Screen Sharing — PipeWire + xdg-desktop-portal (Wayland + X11)
• Native Notifications — system notification bubbles via DBus
• Native File Dialogs — xdg-desktop-portal for uploads/downloads
• Theme Sync — follows desktop light/dark mode automatically
• System Tray — tray icon with unread message count badge
• Deep Links — whatsapp:// URI scheme handler
• Auto-Update — AppImage via GitHub Releases, DEB via apt upgrade
• Session Persistence — stay logged in between restarts

Full changelog: CHANGELOG.md