A modern C++17 client library for Centrifugo real-time messaging server. This library provides an asynchronous, WebSocket-based client implementation using Boost.Beast and Boost.Asio.
- 🚀 Asynchronous I/O - Built on Boost.Asio for high-performance networking
- 🔐 JWT Authentication - Full support for JWT token-based authentication
- 📡 Real-time Subscriptions - Subscribe to channels and receive publications
- 🔄 Automatic Reconnection - Configurable reconnection logic with exponential backoff
- 📝 Modern C++17 - Clean, type-safe API using modern C++ features
- 🛡️ Error Handling - Comprehensive error handling with boost::outcome
- 📊 Logging Support - Configurable logging with structured log entries
- C++17 or later
- CMake 3.17 or later
- OpenSSL
Can be automatically installed by CPM:
- Boost (ASIO, Beast, Outcome, Signals2, System, URL)
- nlohmann/json
cmake -S . -B build
cmake --build buildcmake -S . -B build -DBUILD_EXAMPLES=ON
cmake --build buildThe examples/ directory contains complete working examples:
full.cpp- Complete example with JWT authentication, subscriptions, and event handlingstaging.cpp- Staging environment example
This project uses devenv for development environment management:
# Install devenv (if not already installed)
# Then run:
devenv shellThe project includes Docker services for development:
docker compose up -d # Starts Centrifugo server and JWT generator service to be used with "full" example- Client - Main client class managing connections and subscriptions
- Subscription - Individual channel subscription management
- Transport - WebSocket transport layer using Boost.Beast
- Protocol - Centrifugo protocol implementation
- Error - Comprehensive error handling system
The project uses CMake with CPM (CMake Package Manager) for dependency management:
- Boost - Networking, WebSocket, and utilities
- OpenSSL - TLS/SSL support
- nlohmann/json - JSON serialization/deserialization
This project is licensed under the MIT License - see the LICENSE file for details.
Copyright (c) 2025 Spinner Systems, Inc. (DBA Scorbit), scrobit.io, All Rights Reserved