EasyRPC

Are you tired of these overcomplexed libraries for Discord RPC when all you want is a simple and straightforward syntax? Well, EasyRPC might be for you.

EasyRPC is a dead-simple, zero-dependency Discord Rich Presence library for .NET 8+

Features

• One‑line setup – just call InitializeAsync() with your Discord Application ID.
• Auto‑reconnect – restores the presence when Discord restarts.
• Fully async – non‑blocking operations.
• Rich Presence support – buttons, timestamps, party info, images.

Getting Started

1. Install / Reference

Either Clone the repository or download the source. Reference the EasyRPC project in your solution.

Or use .NET CLI

dotnet add package Skavam.EasyRPC --version 1.0.2

2. In your code

Example 1 with no buttons

using EasyRPC;

await EasyRpc.InitializeAsync("YOUR_DISCORD_APPLICATION_ID");

await EasyRpc.SetPresenceAsync(
    details: "YOUR_APP_DETAILS",
    state: "YOUR_APP_STATE",
    startTimestamp: DateTime.UtcNow
);

// Keep the app running while you want the presence active.
Console.ReadKey();

await EasyRpc.ShutdownAsync();

Example 2 with buttons

using EasyRPC;
using System.Collections.Generic; // REQUIRED because we're using "List<Button>". 

await EasyRpc.InitializeAsync("YOUR_DISCORD_APPLICATION_ID");

var buttons = new List<Button>
{
    // NOTE: Each RPCs can only feature two buttons, each with a label and a valid URL
    new Button { Label = "YOUR_BUTTON_NAME", Url = "YOUR_URL" },
    new Button { Label = "YOUR_BUTTON_NAME", Url = "YOUR_URL" }
};

await EasyRpc.SetPresenceAsync(
    details: "YOUR_APP_DETAILS",
    state: "YOUR_APP_STATE",
    startTimestamp: DateTime.UtcNow,
    buttons: buttons
);

// Keep the app running while you want the presence active.
Console.ReadKey();

await EasyRpc.ShutdownAsync();

Example 3 with a party

using EasyRPC;

await EasyRpc.InitializeAsync("YOUR_DISCORD_APPLICATION_ID");

await EasyRpc.SetPresenceAsync(
    details: "YOUR_APP_DETAILS",
    state: "YOUR_APP_STATE",
    startTimestamp: DateTime.UtcNow,
    partyId: "YOUR_PARTY_ID",
    partySize: 5, // Number of people currently in the party
    partyMax: 10 // Maximum number of people allowed in the party
);

// Keep the app running while you want the presence active.
Console.ReadKey();

await EasyRpc.ShutdownAsync();

Example 4 with the addition of a large and small image

using EasyRPC;

await EasyRpc.InitializeAsync("YOUR_DISCORD_APPLICATION_ID");

await EasyRpc.SetPresenceAsync(
    details: "YOUR_APP_DETAILS",
    state: "YOUR_APP_STATE",
    startTimestamp: DateTime.UtcNow,
    largeImageKey: "YOUR_ASSET_NAME",     
    largeImageText: "YOUR_HOVER_TEXT",        
    smallImageKey: "YOUR_ASSET_NAME",     
    smallImageText: "YOUR_HOVER_TEXT"        
);

// Keep the app running while you want the presence active.
Console.ReadKey();

await EasyRpc.ShutdownAsync();

Example 5 usage of EasyRPC's events

using EasyRPC;

EasyRpcEvents.OnReady += (sender, userId) => Console.WriteLine($"EasyRPC is ready! User: {userId}"); // Write in the console when the library is ready
EasyRpcEvents.OnError += (sender, error) => Console.WriteLine($"!!! Error: {error.Message}"); // Write in the console an error
EasyRpcEvents.OnPresenceUpdate += (sender, presence) => Console.WriteLine($"Presence: {presence.Details}"); // Write in the console when a change got applied to your RPC
EasyRpcEvents.OnLog += (sender, message) => Console.WriteLine($"LOG: {message}"); // Write in console logs of what the library is doing

await EasyRpc.InitializeAsync("YOUR_DISCORD_APPLICATION_ID");

await EasyRpc.SetPresenceAsync(
    details: "YOUR_APP_DETAILS",
    state: "YOUR_APP_STATE",
    startTimestamp: DateTime.UtcNow
);

// Keep the app running while you want the presence active.
Console.ReadKey();

await EasyRpc.ShutdownAsync();