C++ library for interfacing with Discord IPC socket. This library was initial made for the parent project apple-music-rpc-cpp, and thus may not be contain full compatibility with Discord IPC protocols. Because of the criteria for the parent project, this library is entirely self-contained, and does not include any external libraries. Feel free to create a new issue or submit pull requests if you encounter any issues.

Documentation

Read the full documentation here: https://plduanm.com/projects/documentation/discord_ipc_cpp

Installation

Requirements:

A Unix system
CMake >= 3.14
C++ >= 20

Clone this repository as a submodule under src/:

git submodule add https://github.com/TheMoonThatRises/discord_ipc_cpp src/discord_ipc_cpp

And add the following into your CMakeLists.txt:

...
 
add_subdirectory(src/discord_ipc_cpp)
 
...
 
target_link_libraries(<EXECUTABLE> PRIVATE discord_ipc_cpp)

Basic Usage

All of the code below will incorporate the following metacode:

#include <discord_ipc_cpp/discord_ipc_client.hpp>
#include <discord_ipc_cpp/ipc_types.hpp>
 
using discord_ipc_cpp::DiscordIPCClient;
 
using discord_ipc_cpp::ipc_types::RichPresence;

Create a Discord IPC client and connect to it:

DiscordIPCClient client("<APPLICATION ID>");
 
// indicates success of connecting to socket
bool ret = client.connect();

Construct a rich presence:

RichPresence presence = {
  .name = "Apple Music",
  .type = RichPresence::at_listening,
  .status_display_type = RichPresence::sdt_details,
  .assets = {
    .large_text = "Kawakiwoameku - EP"
  },
  .details = "Hollowness",
  .state = "Minami"
}

Set the user's rich presence:

client.set_presence(presence);

Clear the user's rich presence:

client.set_empty_presence();

Close the IPC connection:

client.close();