go-discordrpc

⚡ Cross-Platform Discord Rich Presence implementation in Go

go-discordrpc is a Go module for interacting with Discord Rich Presence (RPC), inspired by and forked from rich-go. It provides a simple, cross-platform way to set custom activities, buttons, timestamps, and more, all from Go applications.

---

Installation

You can install go-discordrpc using go get:

go get github.com/tr1xem/go-discordrpc/client@v1.1.0-1

---

Usage

Import the client and create a new Discord RPC client instance. Then log in, set your activity, and optionally logout:

package main

import (
	"fmt"
	"time"

	"github.com/tr1xem/go-discordrpc/client"
)

func main() {
	// 1. Create a new Discord RPC client
	c := client.NewClient("DISCORD_APP_ID")

	// 2. Login to Discord via IPC
	if err := c.Login(); err != nil {
		panic(fmt.Errorf("login failed: %w", err))
	}
	fmt.Println("Logged in!")

	// 3. Get the current time for timestamps
	now := time.Now()

	// 4. Set Rich Presence activity
	if err := c.SetActivity(client.Activity{
		Type:       0, // 0=Playing, 1=Streaming, 2=Listening, 3=Watching
		State:      "Playing Chess with Ai Hoshino",
		Details:    "If you like Ai Hoshino, we are 🤝",
		LargeImage: "largeimageid",
		LargeText:  "Large image tooltip",
		SmallImage: "smallimageid",
		SmallText:  "Small image tooltip",
		Party: &client.Party{
			ID:         "-1",
			Players:    5,
			MaxPlayers: 10,
		},
		Timestamps: &client.Timestamps{
			Start: &now,
		},
		Buttons: []*client.Button{
			{
				Label: "GitHub",
				Url:   "https://github.com/tr1xem/go-discordrpc",
			},
		},
	}); err != nil {
		panic(fmt.Errorf("set activity failed: %w", err))
	}
	fmt.Println("Activity set!")

	// 5. Sleep to allow Discord to display the presence
	fmt.Println("Sleeping for 10 seconds...")
	time.Sleep(10 * time.Second)

	// 6. Logout from Discord and close the IPC socket
	if err := c.Logout(); err != nil {
		panic(fmt.Errorf("logout failed: %w", err))
	}
	fmt.Println("Logged out!")
}

---

Contributing / Support

If you want to contribute, report a bug, or suggest a feature, please open an issue or a pull request. All contributions are welcome!

---

License

This project is licensed under the GNU General Public License v3. See the LICENSE file for details.

---

Thanks

Special thanks to rich-go for the original idea and inspiration!