Zalo for Linux 🐧

An unofficial, community-driven port of the Zalo desktop application for Linux only, created by repackaging the official macOS client into a standard AppImage with integrated ZaDark.

Thanks realdtn2 for the solution: realdtn2/zalo-linux-unofficial-2024.

⚠️ Important: Known Issues

• Message Synchronization (E2EE): Due to missing native macOS libraries for End-to-End Encryption.For more details, see issue #1. Solution: using Wine to run the Windows version of Zalo to perform the initial data sync, and then migrating the data to this Linux version. For more details, see issue #2.
• Can't make or receive calls: Due to missing native macOS libraries
• Can't see message reactions: You won't see reactions in the UI (no badges/counters), but reacting still works and others can see your reaction.
• No Photos/Videos, Files and Links on the Conversation Info panel for some reason (you can still viewing image/video, file or link like normal, it just don't appear on the conversation info panel like this)
• Crash when click Screenshot without Zalo window button
• ✅ Fixed: No title bar with minimize/maximize/close buttons - Thanks to @NanKillBro for the solution. For more details, see issue #4
• ✅ Fixed: No tray menu icon

This project is best suited for users who need a native-feeling Zalo client on Linux and are comfortable with the technical workarounds required for full functionality.

🌙 ZaDark Integration

This project includes integrated ZaDark, ZaDark is an extension that helps you enable Dark Mode, more privacy features, and additional functionality.

ZaDark helps you experience Zalo 🔒 more privately ✨ more personalized.

Features

• 🌙 Dark Mode optimized specifically for Zalo - Complete dark theme tailored for Zalo interface
• 🆃 Customize fonts and font sizes - Personalize text appearance to your preference
• 🖼️ Custom chat backgrounds - Set personalized backgrounds for conversations
• 🔤 Quick message translation - Instantly translate messages to your preferred language
• 😊 Express emotions with 80+ Emojis - Enhanced emoji reactions for messages
• 🔒 Anti-message peeking protection - Prevent others from secretly viewing your messages
• 👁️ Hide status indicators - Hide "typing", "delivered" and "read" status from others
• 📱 Native Integration - Seamlessly integrated during build process

Note: ZaDark is licensed under MPL-2.0 and is developed by Quaric. The setup process automatically prepares ZaDark, and build process integrates it seamlessly!

🚀 Quick Start

Usage (Recommended)

Method 1: Using Gear Lever (AppImage Manager)

This is the easiest method to manage and integrate the AppImage into your application menu.

1. Download the latest .AppImage file from the Releases page.
2. Install Gear Lever from Flathub. It's a utility to manage AppImages with ease.
3. Open Gear Lever.
4. Click the "Open" button in the top-left corner and select the .AppImage file you downloaded.
5. The app will now appear in Gear Lever. Click the "Unlock" button, then choose "Move to the app menu" to integrate it into your system's application launcher.

Method 2: Direct Execution

If you prefer to run the AppImage directly:

1. Download the latest .AppImage file from the Releases page.
2. Open a terminal, navigate to the download directory, and make the file executable:

   chmod +x Zalo-*.AppImage
   

3. You can now run the application by double-clicking it or executing it from the terminal:

   ./Zalo-*.AppImage
   

Enable Automatic Updates with Gear Lever

To enable automatic update checks for Zalo in Gear Lever, follow these steps:

1. Open Gear Lever and select Zalo from your list of applications.

2. Scroll down to the Update Management section.

3. For the Source field, select GitHub.

4. In the Update URL field, paste one of the following patterns, depending on which variant of Zalo you are using:

   For Non-ZaDark Variant

   https://github.com/doandat943/zalo-for-linux/releases/download/*/Zalo-*-*.AppImage
   

   For ZaDark Variant

   https://github.com/doandat943/zalo-for-linux/releases/download/*/Zalo-*+ZaDark-*-*.AppImage
   

5. Click Save. If the URL field turns green, the pattern has been accepted successfully.

6. Finally, click the Reload metadata button to fetch the latest version information.

How to Update Zalo

Once the update source is configured, you can check for updates at any time by:

1. Opening Gear Lever.
2. Clicking the Check for updates button.

Build from Source

Prerequisites:

• Linux x86_64
• Node.js and npm
• 7z (p7zip-full) for extracting the macOS app during setup

On Debian/Ubuntu:

sudo apt-get update && sudo apt-get install -y p7zip-full

Steps:

# Clone the repository
git clone https://github.com/doandat943/zalo-for-linux.git
cd zalo-for-linux

# Option 1: Auto-download latest version (recommended)
npm run setup

# Option 2: Download specific version
DMG_VERSION="25.8.2" npm run setup

# Build AppImage
npm run build

The final AppImage will be in the dist/ directory!

🛠️ Development Scripts

Command	Description
npm run setup*	Equal download-dmg + prepare-zadark + prepare-app
npm run start	Runs the app in development mode
npm run build	Builds AppImage
npm run download-dmg*	Download Zalo DMG
npm run prepare-app*	Extract Zalo DMG
npm run prepare-zadark	Clones and builds ZaDark assets for later integration

🌍 Environment Variables

Variable	Description	Example
DMG_VERSION	Specify exact Zalo version to download/extract	DMG_VERSION="25.8.2"
FORCE_DOWNLOAD	Force re-download even if file exists	FORCE_DOWNLOAD=true

Example

🆕 Auto using latest version (Default - Meant without any environtment variable):

# Automatically downloads the latest Zalo version from https://zalo.me/download/zalo-pc
npm run download-dmg

# If only one DMG file in `temp/` directory, auto select that file and extract
# If multiple DMG file in `temp/` directory, show DMG selection menu
npm run prepare-app

# Automatically downloads the latest Zalo version from https://zalo.me/download/zalo-pc
# Extract DMG version selected from previous step
# Prepare ZaDark
npm run setup

🎯 Version Mode (Meant with environtment variable):

# Just specify the version number! Script constructs the URL automatically
# Uses pattern: https://res-download-pc.zadn.vn/mac/ZaloSetup-universal-{DMG_VERSION}.dmg
# Zalo servers handle redirect to the actual download location
DMG_VERSION="25.8.2" npm run download-dmg

# Extract DMG version specificed
DMG_VERSION="25.8.2" npm run prepare-app

# Forces re-download even if file already exists
FORCE_DOWNLOAD=true npm run download-dmg

# Example: Specific version with force re-download
DMG_VERSION="25.8.2" FORCE_DOWNLOAD=true npm run download-dmg
DMG_VERSION="25.8.2" FORCE_DOWNLOAD=true npm run setup

🎯 Interactive DMG Selection

When running npm run prepare-app with multiple DMG files in the temp/ directory:

• 📋 Modern interface: Arrow key navigation with radio button selection
• 🔍 Smart sorting: Files ordered by version (highest first), then by date
• 📊 Detailed info: Displays version, file size, and download date for each option
• ⚡ Intuitive controls: Use ↑↓ arrows to navigate, Enter to select, Esc to cancel
• 🎯 Single file: Auto-selects if only one DMG file exists

Example interactive session:

📋 Available DMG files:
   Use ↑↓ arrow keys to navigate, Enter to select, Esc to cancel

  ● ZaloSetup-universal-26.1.0.dmg
    Version: v26.1.0 | Size: 198.5MB | Date: 12/20/2024, 3:45:12 PM

  ○ ZaloSetup-universal-25.8.2.dmg
    Version: v25.8.2 | Size: 195.2MB | Date: 12/15/2024, 10:23:45 AM

  ○ ZaloSetup-universal-25.5.3.dmg
    Version: v25.5.3 | Size: 192.1MB | Date: 12/10/2024, 2:15:30 PM

🎯 Selected: ZaloSetup-universal-26.1.0.dmg (v26.1.0)

Navigation:

• ↑↓ Arrow keys to move selection
• Enter to confirm selection
• Esc or Ctrl+C to cancel

⚙️ How It Works

This project is not a from-scratch rewrite of Zalo. It works by:

1. Downloading the official macOS .dmg file.
2. Using 7z to extract the app.asar archive, which contains the main application logic written in JavaScript.
3. Removing incompatible native macOS files.
4. Wrapping the extracted application in a minimal, Linux-compatible Electron shell.
5. Using electron-builder to package everything into a single, portable AppImage file.

🤝 Contributing

Contributions are welcome, especially for improving Linux integration, fixing bugs, and enhancing the build scripts.

1. Fork the repository.
2. Create your feature branch.
3. Commit your changes.
4. Submit a Pull Request.

📄 License

This project is licensed under the MIT License. Zalo is a trademark of VNG Corporation. This project is not affiliated with or endorsed by VNG Corporation.