ToxProxy

Offline Messages for Tox

ToxProxy provides offline message relay functionality for the Tox messaging protocol, acting as a persistent proxy that buffers messages when your primary device is offline and delivers them when you reconnect.

ToxProxy is designed to run continuously on a server or always-on device, configured to accept control commands only from a specific Master device's public key.

Key Features

• Message Buffering: Stores messages when your "Master" device (typically a mobile phone) is offline
• Push Notifications: Can wake up your Master device when new messages arrive via configurable push servers
• Cross-Platform: Builds on Linux, macOS, and Windows (via cross-compilation)
• SQLite Storage: Uses a custom C ORM (csorma) for persistent message storage

Technical Stack

• Core: C implementation using toxcore amalgamation for Tox protocol support
• Dependencies: libsodium (encryption), libcurl (push notifications), pthread (threading)
• Database: SQLite with custom csorma ORM for schema management
• Build: Requires openjdk-17-jdk for code generation during build process

building on Linux and macOS

# install libsodium-dev libcurl4-gnutls-dev openjdk-17-jdk (depending on your OS)
git clone https://github.com/zoff99/ToxProxy
cd ToxProxy/src/
make
ls -al ToxProxy
# openjdk-17-jdk is not needed to run ToxProxy, only for building it

build for Windows on a Linux machine

# install docker.io rsync (depending on your Linux Distro)
git clone https://github.com/zoff99/ToxProxy
cd ToxProxy/.localrun/
./docker_it_win.sh build
./docker_it_win.sh
ls -al windows_ub20/artefacts/ToxProxy.exe
# copy ToxProxy.exe to your windows machine

🚀 Featured Applications

Join a growing community of security-conscious people. Check out these featured applications:

• TRIfA: The Tox flagship secure messenger for Android.
• TRIfA for Desktop: The feature rich Tox Desktop Messaging Client.
• Tox Push Msgs: The Companion App for TRIfA and TRIfA for Desktop to enable Push Messages.
• ToxProxy: Offline message relay functionality for TRIfA and TRIfA for Desktop.
• ToLoShare: A specialized Android application for secure, peer-to-peer real-time location sharing.
• ToLoShare for Desktop: A cross-platform desktop application for secure peer-to-peer real-time location sharing.
• ToFShare: Secure decentralized file sharing for Android using the Tox protocol.
• tox_videoplayer: A command-line application that streams video and audio content over the Tox network.

Any use of this project's code by GitHub Copilot, past or present, is done without our permission. We do not consent to GitHub's use of this project's code in Copilot.
No part of this work may be used or reproduced in any manner for the purpose of training artificial intelligence technologies or systems.