Skip to content

Releases: ruskicoder/zalo-linux

v0.0.1-rev.02

Choose a tag to compare

@ruskicoder ruskicoder released this 05 Oct 19:54

Zalo Linux v0.0.1-rev.02

Unofficial Linux port of Zalo messenger for Fedora/KDE Plasma

📝 Changelog

Added

  • Native KDE Plasma system tray integration
  • Simplified tray menu (Open/Exit)
  • Wayland window controls fix

Fixed

  • Window controls on Wayland
  • System tray icon display

Known Issues

  • Message sync from mobile not functional (documented limitation)

📋 System Requirements

  • OS: Linux (Fedora 40+ tested)
  • Desktop: KDE Plasma (recommended), GNOME, or other DE
  • Display: X11 or Wayland
  • RAM: 2 GB minimum, 4 GB recommended
  • Disk: 500 MB

✨ Features

  • ✅ Real-time messaging
  • ✅ Send/receive messages and files
  • ✅ Native KDE Plasma system tray integration
  • ✅ Wayland support
  • ✅ Dark theme (ZaDark version)

⚠️ Known Limitations

Message sync from mobile to desktop is not functional in this release.

Workarounds:

  • Use Zalo web or phone. There is no workaround. The problem is due to the port. I cannot fix it, it is a server side problem.

INSTALLATION

Prerequisites

# Install Node.js and npm
sudo dnf install nodejs npm

# Install Electron dependencies
sudo dnf install libXScrnSaver gtk3 nss alsa-lib

Installation

# From source-code directory
cd source-code

# Install 
sudo ./install.sh

# Select variants in the install.sh. There is Zalo (light mode) and ZaDark (dark mode).

🔐 Security Note

This is an unofficial Linux port. Use at your own risk.

🙏 Credits

  • Original Zalo: VNG Corporation
  • ZaDark theme: ZaDark project
  • Linux port: Community contributors

For complete documentation, see RELEASE-NOTES

v0.0.1-rev.01

Choose a tag to compare

@ruskicoder ruskicoder released this 04 Oct 20:16

Zalo Linux v0.0.1-rev.01 - Wayland Window Controls Fix

First stable release with full Wayland support! 🎉

What's New

This release fixes critical Wayland window control issues, making Zalo fully functional on modern Linux desktop environments.

✅ Fixed Issues

  • Wayland Window Controls - All window controls (minimize, maximize, close) now work correctly
  • Native Window Frame - Uses native window decorations on Linux for better desktop integration
  • Titlebar Drag - Window can be moved by dragging the titlebar
  • Window Resize - Window can be resized from corners and edges
  • KDE Plasma Support - Full support for KDE Plasma 42 on Fedora

🎯 Features

  • ✅ Native window frame for Linux (Wayland + X11)
  • ✅ Working window controls (minimize, maximize, close)
  • ✅ Draggable titlebar
  • ✅ Resizable window
  • ✅ Native appearance matching system theme
  • ✅ Full KDE Plasma integration
  • ✅ System tray support

📦 Download

File: zalo-linux-v24.9.1-wayland-fix.tar.gz (129 MB)

Checksums:

  • MD5: f570ddcbef737251b137756bc9062a7c
  • SHA256: e9646820a35f648c441dc388e6b5efcc7a3c647978b3ed8b3845dd184e4bb2a8

💻 System Requirements

Supported Distributions

  • Fedora 38+ (Recommended: Fedora 42)
  • Ubuntu 22.04+
  • Debian 11+
  • Other Linux distributions (may require manual dependency installation)

Desktop Environments

  • KDE Plasma (Recommended - Tested on Plasma 42)
  • GNOME
  • XFCE
  • Other desktop environments with X11 or Wayland support

Display Servers

  • ✅ Wayland (Fully supported and tested)
  • ✅ X11 (Fully supported)

🚀 Quick Start

Installation

# Extract
tar -xzf zalo-linux-v24.9.1-wayland-fix.tar.gz
cd zalo-linux-v24.9.1-wayland-fix

# Install
chmod +x install.sh
./install.sh

Launch

# From application menu
Search for "Zalo" and click

# Or from command line
~/.local/share/Zalo/start.sh

Uninstall

~/.local/share/Zalo/uninstall.sh

📝 What Was Fixed

Original Issue:

  • Application used frameless window design from macOS
  • Window controls were missing/non-functional on Wayland
  • Titlebar was not draggable
  • Application was unusable on Wayland

Solution:

  • Enabled native window frame on Linux
  • Changed frame: false to frame: process.platform === 'linux'
  • Maintains frameless design on macOS/Windows
  • Provides native window controls on Linux

🧪 Testing

This release has been thoroughly tested on:

  • OS: Fedora Linux
  • Desktop: KDE Plasma 42
  • Display Server: Wayland
  • Electron: v22.3.27

All window controls tested and verified working ✅

⚠️ Known Issues

Message Sync Not Working

  • Status: Known issue (will be fixed in future release)
  • Impact: Messages may not sync across devices in real-time
  • Workaround: Restart application to force sync
  • Planned Fix: Next release

📄 Documentation

🙏 Credits

  • Zalo by VNG Corporation
  • ZaloZaDark theme by community
  • Wayland Fix by community contributors
  • Tested on Fedora KDE Plasma 42

⚖️ Disclaimer

This is an unofficial community port of Zalo for Linux with Wayland fixes.

  • ❌ NOT affiliated with VNG Corporation or Zalo
  • ❌ NOT officially supported by VNG Corporation
  • ✅ Community-maintained and provided as-is
  • ✅ Open to contributions and improvements

Use at your own risk.

📊 Package Contents

  • Zalo v24.9.1 (Standard version)
  • ZaloZaDark v24.9.1 (Dark theme version)
  • Installation script with Wayland fix
  • Uninstallation script
  • Full documentation

Version: v0.0.1-rev.01
Release Date: October 5, 2025
Status: Stable ✅