arrpc

An open implementation of Discord's local RPC servers

Allowing RPC where it was otherwise impossible, like Discord Web and custom clients

arRPC is an open source implementation of Discord's half-documented local RPC servers for their desktop client. This open source implementation purely in NodeJS allows it to be used in many places where it is otherwise impossible to do: Discord web and alternative clients like ArmCord/etc. It opens a simple bridge WebSocket server which messages the JSON of exactly what to dispatch with in the client with no extra processing needed, allowing small and simple mods or plugins. arRPC is experimental and a work in progress, so expect bugs, etc.

Rich Presence (RPC) is the name for how some apps can talk to Discord desktop on your PC via localhost servers to display detailed info about the app's state. This usually works via parts of Discord desktop natively doing things + parts of Discord web interpreting that and setting it as your status. arRPC is an open source implementation of the local RPC servers on your PC, allowing apps to talk to it thinking it was just normal Discord. It can then send that info to apps which usually don't get RPC, like Discord Web, ArmCord, etc. which can then set that as your status. This would otherwise not be possible, as web apps/browsers/etc can't just use Discord's already existing code and version.

• App with Discord RPC
• Discord Desktop's native server arRPC
• Discord Web's setting mod/plugin

Usage

Server

Run npx arrpc in a terminal. Make sure you have a modern (>=18) version of Node.js installed.

Web

No Mods

• Get the arRPC server running
• With Discord open, run the content of examples/bridge_mod.js in Console (Ctrl+Shift+I).

Vencord

• Get the arRPC server running
• Just enable the WebRichPresence (arRPC) Vencord plugin!

Custom Clients

ArmCord, Vesktop

These clients have arRPC specially integrated, just enable the option in its settings (server not required)!

Webcord

• Get the arRPC server running
• Disable the Use built-in Content Security Policy option in Advanced settings:
• With Webcord open, run the content of examples/bridge_mod.js in the DevTools Console (Ctrl+Shift+I).

Then just use apps with Discord RPC like normal and they should work!

Supported

Transports

• WebSocket Server
  • JSON
  • Erlpack
• HTTP Server
• IPC
• Process Scanning

Commands

• DISPATCH
• SET_ACTIVITY
• INVITE_BROWSER
• GUILD_TEMPLATE_BROWSER
• DEEP_LINK
• CONNECTIONS_CALLBACK