<div align="center"> <img src="docs/assets/dinox-512.png" width="200" alt="DinoX Logo">

DinoX

The First XMPP Messenger with Extensible REST API, AI Support, MQTT & Advanced Security Features

Built for ultimate privacy with OMEMO 1 + 2, integrated OpenPGP Key Manager, integrated Tor & Obfs4proxy and full local database encryption. WebRTC Audio/Video Calls, decentralized MUJI Group Video Calls (hardware accelerated), voice messages, video messages, message retraction and advanced MUC moderation — all in a modern GTK4/libadwaita interface with System Tray support.

Local API Server, Botmother Bot Management and AI Integration (9 providers incl. OpenClaw). MQTT Plugin for IoT sensor data, topic subscriptions, sparkline charts, XMPP bridging, Home Assistant integration, ejabberd & Prosody support, and Node-RED integration. DTMF Support (RFC 4733) with Dialpad UI for XMPP SIP Provider telephony.

Website • Download • Features • XEP Support • Build • Debug • Testing • Changelog • API & Botmother AI Guide • MQTT Plugin • MQTT User Guide • Development Plan • Contributing • Security Audit

</div>

---

Key Features

| Feature | Description | |---------|-------------| | Encrypted File Upload | AES-GCM URI Scheme & XEP-0448 support for secure file sharing | | Full Local Encryption | All local files (avatars, stickers, transfers) are encrypted at rest (AES-256-GCM) | | Secure Deletion | Global history deletion (both sides) with smart throttling & zero-trace cache cleanup | | OMEMO Encryption | End-to-end encryption for messages and files (OMEMO Legacy + OMEMO 2) | | OpenPGP Encryption | XEP-0027 (Legacy) + XEP-0373/0374 with key management, generation, deletion & revocation | | Encrypted Local Database | Local data is stored in an encrypted SQLCipher database (password required at startup) | | Change Database Password | Change the local database password via Preferences (SQLCipher rekey) | | Panic Wipe | Quickly wipe local DinoX data (Ctrl+Shift+Alt+P) and exit (also triggered after 3 failed unlock attempts) | | OpenPGP Keyring Isolation | Uses an app-scoped GNUPGHOME so Panic Wipe removes OpenPGP material | | Disappearing Messages | Auto-delete messages after 15min, 30min, 1h, 24h, 7d or 30d | | MUJI Group Calls | Multi-party audio/video conferences (mesh-based) | | 1:1 Voice & Video | Crystal clear calls with Echo Cancellation, Noise Suppression, AGC & Transient Suppression | | DTMF & Dialpad | RFC 4733 telephone-event support with Dialpad UI for XMPP SIP Provider telephony (hotlines, IVR, conference controls) | | Voice Messages | Record and send audio messages (AAC format) | | Video Messages | Record and send video messages with camera preview (H.264+AAC in MP4, max 720p, 120s) | | Inline Video Player | Play videos directly in chat (no external player) | | Group Chats (MUC) | Full support with moderation, roles, private rooms | | Out-of-the-Box Tor | Integrated Tor & Obfs4proxy (ZERO-Config) for instant privacy & anonymity | | System Tray | Background mode with StatusNotifierItem | | Message Retraction | Delete messages for everyone (XEP-0424) | | Emoji Reactions | React to messages (XEP-0444) | | Stickers | Send & receive sticker packs (XEP-0449) | | Message Replies | Quote and reply to messages (XEP-0461) | | MQTT Plugin | IoT sensor data via MQTT 5.0 — topic subscriptions, alerts, sparkline charts, XMPP bridging, Home Assistant integration, Prosody mod_pubsub_mqtt support, ejabberd mod_mqtt support, Node-RED integration with free-text publish/response | | MUC Moderation | Kick, ban (timed), manage roles (XEP-0425) | | TLS Certificate Pinning | Trust self-signed certs for self-hosted servers | | TLS Certificate Info | View TLS certificate details (issuer, validity, fingerprint) in account settings | | Backup & Restore | Full data backup with optional GPG encryption (AES-256) | | Database Maintenance | Clean orphaned records, optimize storage | | PGP Key Management | Generate, select, delete, revoke OpenPGP keys in-app. Automatic key exchange via PEP | | 47 Languages | ~85% translated — help translate on Weblate | | Dark Mode | System theme or manual toggle |

Installation

Windows

Download the latest Windows build from GitHub Releases. Extract the ZIP archive and run dinox.exe.

To build DinoX from source on Windows, see the build instructions: Deutsch | English

The first time you start it up after unpacking may take a little while; just skip the Windows warning. GStreamer and the necessary databases are being set up in the background; on the second start, Windows Defender will run a scan again, which also causes a slight delay, but after that Dinox will start up normally. The same applies if you build it yourself from the package repositories.

Geolocation for locations is not available on Windows.

Flatpak

Download from GitHub Releases

# 1. Install the GNOME runtime (required, one-time setup)
flatpak install flathub org.gnome.Platform//48

# 2. Install DinoX (replace ARCH with x86_64 or aarch64)
flatpak install --user dinox-*-ARCH.flatpak

# 3. Run
flatpak run im.github.rallep71.DinoX

AppImage

• Download from GitHub Releases

  chmod +x DinoX-*.AppImage
  ./DinoX-*.AppImage
  

• Install via AppMan (rootless)

  appman -i dinox
  

• Install via AM

  am -i dinox
  

AUR

Install on Arch Linux using the AUR dinox package.

Replace with your preferred AUR helper.

paru -S dinox

Build from Source

DinoX uses Meson/Ninja and requires several custom dependencies (SQLCipher with FTS5, webrtc-audio-processing 2.1, libnice 0.1.23, etc.). For complete build instructions including all dependencies, distro-specific notes (Debian/Ubuntu, Fedora, Arch), and the automated build script, see BUILD.md.

Local data encryption

DinoX stores your local data (accounts, messages, settings, cached metadata) in an encrypted SQLCipher database.

• You will be prompted for a password on startup.
• If you forget the password, the database cannot be recovered.
• A Panic Wipe action is available via the app menu and the shortcut Ctrl+Shift+Alt+P.

Audio/Video calling notes

DinoX 1:1 calling focuses on cross-client interoperability (notably with Conversations (Android) and Monal (iOS)) while keeping the existing media stack:

• Media stack: GStreamer (RTP/rtpbin + WebRTC elements), libnice (ICE), gnutls (DTLS), libsrtp2 (SRTP).
• PipeWire Support: DinoX integrates explicitly with PipeWire for modern audio support.

  Important: If your system uses PipeWire (common on Fedora, Manjaro, Mint 22+), you must install the GStreamer PipeWire plugin (usually gstreamer1.0-pipewire or gst-plugin-pipewire). This is a separate package from standard GStreamer plugins! Without it, calls or voice notes will fallback to the legacy sound server (Pulse/ALSA), which may lead to stability issues or incorrect device selection.

• Security profile: DTLS-SRTP only (no SDES-SRTP).
• Baseline codecs: Opus (audio) and VP8 (video) for reliable interop.
• Optional audio quality: webrtc-audio-processing enables AEC/NS/AGC if present.

  Note: Many distributions ship outdated versions. For best quality (Echo Cancellation), we strongly recommend building version 2.1+ from source. See BUILD.md.

If you are building from source using distro packages, ensure you are on a sufficiently new libnice (recommended: >= 0.1.23). For collecting reproducible call logs, see DEBUG.md.

XEP Support

DinoX implements 90+ XMPP Extension Protocols. Here are the key ones with full UI support:

Messaging

| XEP | Name | Status | |-----|------|--------| | XEP-0080 | User Location (Send & Receive) | Full | | XEP-0085 | Chat State Notifications | Full | | XEP-0184 | Message Delivery Receipts | Full | | XEP-0308 | Last Message Correction | Full | | XEP-0313 | Message Archive Management | Full | | XEP-0333 | Chat Markers | Full | | XEP-0424 | Message Retraction | Full | | XEP-0444 | Message Reactions | Full | | XEP-0449 | Stickers | Full | | XEP-0461 | Message Replies | Full |

Profile & Contact

| XEP | Name | Status | |-----|------|--------| | XEP-0054 | vCard-temp | Full | | XEP-0055 | Jabber Search | Full | | XEP-0077 | In-Band Registration | Full | | XEP-0158 | CAPTCHA Forms | Full | | XEP-0172 | User Nickname | Full | | XEP-0292 | vCard4 | Full |

Security

| XEP | Name | Status | |-----|------|--------| | XEP-0384 | OMEMO Encryption (Legacy + OMEMO 2