Skip to content
Projects

ctdoteam1110/ctdozlite has 357 GitHub stars and 153 forks. GitHot measured +2 stars in 24 hours. Last checked 2026-11-18 02:04 UTC. Last push 2026-11-15.

How these counts are measured

Measured star growth

in 24h
+2
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Client Zalo Desktop viết bằng Rust (eframe/egui + ratatui), giao tiếp trực tiếp với hệ thống API và WebSocket của Zalo Web/PC mà không qua Electron hay Chromium.

Developer Tools

docs/i18n/README_EN.md

Original

ctdozlite

Tiếng Việt · English · 한국어 · 日本語 · 简体中文

A pure Rust Zalo Desktop client (eframe/egui + ratatui) communicating directly with Zalo Web/PC APIs and WebSocket services without Electron or Chromium.


⚡ Highlights

  • Pure Rust Performance: Cold startup in ~0.18s (<200ms), idle Working Set RAM ~149.5 MB (vs ~1.8-1.9 GB on official Electron client), 1 single native process, near-zero idle CPU.
  • Cross-Platform: Native builds for Windows 10/11 (MSVC & GNU), macOS (Apple Silicon arm64 & Intel x86_64), and Linux (Debian, Ubuntu, Fedora Wayland/X11).
  • Dual Mode: Full-featured GUI (Atom One Dark theme) and terminal-based TUI (ratatui).
  • VoIP Audio & Video Calls: 100% Rust VoIP engine supporting Annex-B H.264 video decoding, RTP/RTCP protocols, and Opus audio resampling.
  • Security & Privacy: Local SQLite storage (zalo_history.db), configurable data directory via --data-dir, zero telemetry.

📥 Download & Installation

Prebuilt installers and portable binaries are available on GitHub Releases:

OS Package Instructions
Windows .exe Installer / Portable .zip Run installer or extract and run ctdozlite.exe
macOS Universal .dmg (Apple Silicon & Intel) Open .dmg, drag ctdozlite.app to /Applications
Linux .deb / .rpm / .AppImage / .tar.gz Install via package manager or run directly with chmod +x

CLI Options

Option Description Example
--data-dir <PATH> Set custom directory for session, database, cache, and logs ctdozlite --data-dir ./my-data --gui
--print-data-dir Print resolved data directory and exit ctdozlite --print-data-dir
--gui Launch graphical user interface (default) ctdozlite --gui
--tui Launch terminal user interface ctdozlite --tui
--qr Request login QR code immediately ctdozlite --tui --qr
--logout Clear saved session and exit ctdozlite --logout
--version / -V Print version and exit without initializing storage ctdozlite --version

🛠️ Building from Source

Prerequisites

  • Rust Toolchain: Stable Rust (1.80+ recommended) via rustup.
  • System Dependencies:
    • Linux: libasound2-dev, libfontconfig1-dev, libx11-dev, libxcursor-dev, libxi-dev, libgl1-mesa-dev, ffmpeg.
    • Windows / macOS: Standard C toolchain and ffmpeg (for media/video calls).
# Clone the repository
git clone https://github.com/ctdoteam1110/ctdozlite.git
cd ctdozlite

# Build optimized release binary
cargo build --release

# Run GUI
./target/release/ctdozlite --gui

🏆 Key Contributors

Core contributors with representative code commits in the repository:

Contributor GitHub Key Role Code Volume
TIPC1110 @TIPC1110 Core architecture, VoIP call engine, egui framework, Contacts & Social Feed, cross-platform & v0.1.0 release > 75,600+ lines
Đỗ Trung Thành (thanhdo1110) @thanhdo1110 Modular GUI refactoring, Atom One Dark, MCP/REST API, Message Scheduler, GitHub API Auto-Updater, 25+ Issue fixes & v0.1.0 release > 35,600+ lines 🏆
Thuong Tin @thuongtin 10 PRs: OS timezone, customizable data-dir, macOS helpers, session atomic, media cache, updater, message state, exact message identity (#61), quote navigation (#60), macOS notification permissions (#59) > 11,500+ lines 🏆
ngxccc @ngxccc 5 PRs: Engineering standards, session safety, domain resolution > 3,400+ lines
GrootTheDeveloper @GrootTheDeveloper 8 PRs: SQLite startup speedup, resumable history sync (#45), worker poll timer (#46), chat virtualization, CJK font lazy loading ~950+ lines

Note: The complete hall of fame honoring all contributors (bug reports, feature requests, pull requests) is published at Contributors Wall.



🙏 Acknowledgements

ctdozlite expresses its deepest gratitude to VNG Corporation and the Zalo development team, who built an excellent messaging platform serving tens of millions of users in Vietnam.

Purpose of this project

  • This project exists for one purpose only: learning and systems-engineering research, specifically understanding how a modern messaging application operates at the network-protocol, encryption, and native desktop architecture layers.
  • All source code is written from scratch in Rust. To understand packet framing, request signing and parameter encoding, the maintainers performed static analysis (reading and decompiling) of the publicly distributed Zalo installer and its bundled native libraries. Those findings were used only as reference for an independent reimplementation — no Zalo machine code, JS/WASM source, .so, .dex or APK file is copied, embedded or redistributed in this repository. The unpacked analysis directories (xapk_extracted/, test_lab/) live outside the repository and are never committed.
  • Third-party artwork notice: the bundled sticker set under src/assets/ami_fat_cat/ is the work of a third party (the original artist). It is not a VNG/Zalo asset, we claim no rights over it, and it is included for UI testing only — it will be removed immediately upon request from the rights holder.
  • We do not own and do not claim ownership of the Zalo trademark, logo, or any VNG intellectual property. The name Zalo is used descriptively only, to state which service's protocol this software is compatible with, so users understand the product's nature.
  • The project is entirely non-commercial: 100% open source, no fees, no advertising, no data sales, no monetization of any kind.

Data privacy

  • All messages and user data are stored locally on your machine (zalo_history.db, session.json, threads_cache.json).
  • The application sends no data to the maintainer's servers or any third party. The only network connection is to the official Zalo system, identical to a browser opening chat.zalo.me.

Takedown policy

If VNG Corporation or an authorized Zalo representative has any request regarding this project (including but not limited to takedown, renaming, or content adjustment), please contact us via GitHub Issues or the maintainer's email. We commit to responding within 72 hours and complying with any legitimate request.

In short: We are deeply grateful to VNG and the Zalo team for building a great product. This project is only a learning effort by a small group of developers who love Rust and want to understand modern messaging systems more deeply. If anything is incorrect, we are ready to listen and change.

📜 License

Distributed under the dual MIT OR Apache-2.0 license. Developed strictly for educational and system-level engineering research purposes.