Skip to content

cybernattor/khandaq

 
 

Repository files navigation

Khandaq Messenger

Open-source, decentralized messenger built on the Tox protocol. Khandaq adds branded clients, optional Khandaq-owned bootstrap nodes, and a privacy-preserving push wake relay — without replacing the public Tox network.

Repository: https://github.com/ummalife/khandaq
Website: https://khandaq.org
Downloads: Latest release


What is in this repository

Path Description
khandaq-desktop/ Desktop client (Qt/C++), forked from qTox
khandaq-ios/ iOS client (Swift), forked from Antidote
khandaq-android-trifa/ Android client (Java/Kotlin), forked from TRIfA
khandaq-android/ Legacy Android reference (aTox-based)
config/ Public network config (bootstrap registry, push relay URLs)
infra/ Bootstrap node & push relay deployment templates (Docker, nginx)
scripts/ Build, bundle, and deploy automation
web/ Static project & download landing page
docs/ Public documentation (English)

Message content is end-to-end encrypted by Tox. Khandaq infrastructure provides bootstrap discovery and push wake notifications (no message body; optional sender public key for chat routing — see docs/PUSH_RELAY.md).


Download pre-built clients

All binaries are hosted on GitHub Releases (not in git):

Platform Download
Android khandaq-android.apk
Windows khandaq-windows-installer.exe
macOS khandaq-macos.zip
Linux x86_64 (portable) khandaq-linux-x86_64-portable.tar.gz
Debian / Ubuntu (.deb) khandaq-messenger_0.2.5_amd64.deb
iOS TestFlight (not distributed as IPA here)

Windows portable zip: khandaq-x86_64-Release.zip

Verify downloads with SHA256SUMS.txt.


Public network endpoints (auditable)

These URLs are embedded in client builds and configuration files:

Service URL Purpose
Bootstrap registry https://bootstrap.khandaq.org/nodes.json Khandaq + public Tox bootstrap list
Push wake relay https://push.khandaq.org/toxfcm/fcm.php FCM/APNs wake only (no message body; see PUSH_RELAY.md)
Main site https://khandaq.org Project website

Source of truth: config/khandaq_bootstrap_nodes.json, config/khandaq_push.json.

See docs/NETWORK.md and docs/BOOTSTRAP.md.


Build from source

See docs/BUILDING.md for platform-specific instructions.

Quick overview:

# Desktop (Linux host or Docker)
./scripts/build-linux-docker.sh

# Windows (cross-compile from macOS/Linux)
./scripts/build-windows-cross.sh

# macOS
./scripts/build-macos.sh

# Android
./scripts/build-android-trifa.sh

# iOS (macOS + Xcode)
cd khandaq-ios && pod install
# Open Antidote.xcworkspace in Xcode

Security & transparency

  • No message content is stored on Khandaq servers.
  • Push relay accepts only device tokens; see docs/PUSH_RELAY.md.
  • Report vulnerabilities: SECURITY.md.
  • We welcome code review and reproducible builds.

Upstream projects

Khandaq is a fork/rebrand. Core protocol and libraries:

  • c-toxcore — Tox protocol implementation
  • qTox — desktop base
  • Antidote — iOS base
  • TRIfA (ToxAndroidRefImpl) — Android base

Khandaq maintains Tox wire compatibility — clients can talk to standard Tox peers.


License

This repository contains multiple upstream codebases with different licenses:

Component License
khandaq-desktop/ GNU GPL v3+
khandaq-android-trifa/ GNU GPL v3+
khandaq-ios/ (Antidote fork) Mozilla Public License 2.0

See LICENSE and per-directory license files for details.


Contributing

See CONTRIBUTING.md.

About

Khandaq Messenger

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • C 76.7%
  • C++ 9.4%
  • Java 7.8%
  • Objective-C 3.1%
  • Swift 1.1%
  • Shell 0.5%
  • Other 1.4%