Discord Protocol Buffers

Reverse-engineering Discord's protobufs.

This repository provides protocol buffer files for all protobufs found in Discord's client source, automatically generated and automatically updated. The protobufs are provided as .proto files in the out/ directory.

These protobufs are used by Discord clients for transmitting data like user settings and premium marketing.

Usage

Installation

Note: These packages are automatically updated when changes are detected in the protobufs. As Discord often updates their protobufs, pinning to a specific version may be advisable.

# with npm
npm install discord-protos

# with yarn
yarn add discord-protos

# with pnpm
pnpm add discord-protos

# with pip
pip install discord-protos

Example

JavaScript:

const { PreloadedUserSettings } = require('discord-protos');

const encoded = PreloadedUserSettings.toBase64({
    status: {
        status: {
            value: "online",
        },
        customStatus: {
            text: "Hello World",
            emojiId: 0n,
            emojiName: "",
            expiresAtMs: 0n,
            createdAtMs: 0n,
        },
    },
});

const decoded = PreloadedUserSettings.fromBase64(encoded);

console.log(encoded, decoded);

Python:

import base64

from google.protobuf.json_format import ParseDict
from discord_protos import PreloadedUserSettings

settings = PreloadedUserSettings()
payload = ParseDict({
    'status': {
        'status': 'online',
        'custom_status': {
            'text': 'Hello World',
        },
    },
}, settings).SerializeToString()

encoded = base64.b64encode(payload).decode('ascii')
decoded = PreloadedUserSettings.FromString(base64.b64decode(encoded))

print(encoded, decoded, sep='\n')

The following table shows which protobuf user settings correspond to which .proto file (the Python package also provides a UserSettingsType enum for convenience).

Type Value File Use
1 PRELOADED_USER_SETTINGS PreloadedUserSettings.proto General Discord user settings.
2 FRECENCY_AND_FAVORITES_SETTINGS FrecencyUserSettings.proto Frecency and favorites storage for various things.
3 TEST_SETTINGS - Unknown.

See Userdoccers for more information.

Development

Running pnpm load will extract and save the latest protobufs to the discord_protos/ directory.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.2.316)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for dolfies from gravatar.com dolfies

Credits

Author: Dolfies

License

MIT License (MIT)

Requires

Python >=3.8.0

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

discord_protos-1.2.309.tar.gz (197.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

discord_protos-1.2.309-py3-none-any.whl (218.4 kB view details)

Uploaded Python 3

File details

Details for the file discord_protos-1.2.309.tar.gz.

File metadata

  • Download URL: discord_protos-1.2.309.tar.gz
  • Upload date:
  • Size: 197.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for discord_protos-1.2.309.tar.gz
Algorithm Hash digest
SHA256 3bf2d01b09a2c4a84728123af94a51895500061b9b1905b79768bfae968be58d
MD5 4e26bcd0d806b4a48340d69d8e3b7df8
BLAKE2b-256 64a9b1255830be5ff2d1739c7ad5ae2a8797a4e2c71124f8dc8b336c5b20ef15

See more details on using hashes here.

Provenance

The following attestation bundles were made for discord_protos-1.2.309.tar.gz:

Publisher: update.yml on discord-userdoccers/discord-protos

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file discord_protos-1.2.309-py3-none-any.whl.

File metadata

File hashes

Hashes for discord_protos-1.2.309-py3-none-any.whl
Algorithm Hash digest
SHA256 d4d495347108ddb03eb38d5115f7bed9c16d96d41e85b3a3184e126d3152de14
MD5 6dca885adfe8e811bdff48b3960957f9
BLAKE2b-256 894ecfd40366e6e00d1e32b26a2f597f0c46e1bd15d568dcbc30ea1994676f66

See more details on using hashes here.

Provenance

The following attestation bundles were made for discord_protos-1.2.309-py3-none-any.whl:

Publisher: update.yml on discord-userdoccers/discord-protos

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.2.316

2 files

1.2.315

2 files

1.2.314

2 files

1.2.312

2 files

1.2.311

2 files

1.2.310

2 files

This release

1.2.309 This release

2 files

1.2.308

2 files

1.2.307

2 files

1.2.306

2 files

1.2.305

2 files

1.2.304

2 files

1.2.303

2 files

1.2.302

2 files

1.2.301

2 files

1.2.300

2 files

1.2.299

2 files

1.2.298

2 files

1.2.297

2 files

1.2.296

2 files

1.2.295

2 files

1.2.294

2 files

1.2.293

2 files

1.2.292

2 files

1.2.291

2 files

1.2.290

2 files

1.2.289

2 files

1.2.288

2 files

1.2.287

2 files

1.2.286

2 files

1.2.285

2 files

1.2.284

2 files

1.2.283

2 files

1.2.282

2 files

1.2.281

2 files

1.2.280

2 files

1.2.279

2 files

1.2.278

2 files

1.2.277

2 files

1.2.276

2 files

1.2.275

2 files

1.2.274

2 files

1.2.273

2 files

1.2.272

2 files

1.2.271

2 files

1.2.270

2 files

1.2.269

2 files

1.2.268

2 files

1.2.267

2 files

1.2.266

2 files

1.2.265

2 files

1.2.264

2 files

1.2.263

2 files

1.2.262

2 files

1.2.261

2 files

1.2.260

2 files

1.2.259

2 files

1.2.258

2 files

1.2.257

2 files

1.2.256

2 files

1.2.255

2 files

1.2.254

2 files

1.2.253

2 files

1.2.252

2 files

1.2.251

2 files

1.2.250

2 files

1.2.249

2 files

1.2.248

2 files

1.2.247

2 files

1.2.246

2 files

1.2.245

2 files

1.2.244

2 files

1.2.243

2 files

1.2.242

2 files

1.2.241

2 files

1.2.240

2 files

1.2.239

2 files

1.2.238

2 files

1.2.237

2 files

1.2.236

2 files

1.2.235

2 files

1.2.234

2 files

1.2.233

2 files

1.2.232

2 files

1.2.231

2 files

1.2.230

2 files

1.2.229

2 files

1.2.228

2 files

1.2.227

2 files

1.2.226

2 files

1.2.225

2 files

1.2.224

2 files

1.2.223

2 files

1.2.222

2 files

1.2.221

2 files

1.2.220

2 files

1.2.219

2 files

1.2.218

2 files

1.2.217

2 files

1.2.216

2 files

1.2.215

2 files

1.2.214

2 files

1.2.213

2 files

1.2.212

2 files

1.2.211

2 files

1.2.210

2 files

1.2.209

2 files

1.2.208

2 files

1.2.207

2 files

1.2.206

2 files

1.2.205

2 files

1.2.204

2 files

1.2.203

2 files

1.2.202

2 files

1.2.201

2 files

1.2.200

2 files

1.2.199

2 files

1.2.198

2 files

1.2.197

2 files

1.2.196

2 files

1.2.195

2 files

1.2.194

2 files

1.2.193

2 files

1.2.192

2 files

1.2.191

2 files

1.2.190

2 files

1.2.189

2 files

1.2.188

2 files

1.2.187

2 files

1.2.186

2 files

1.2.185

2 files

1.2.184

2 files

1.2.183

2 files

1.2.182

2 files

1.2.181

2 files

1.2.180

2 files

1.2.179

2 files

1.2.178

2 files

1.2.177

2 files

1.2.176

2 files

1.2.175

2 files

1.2.174

2 files

1.2.173

2 files

1.2.172

2 files

1.2.171

2 files

1.2.170

2 files

1.2.169

2 files

1.2.168

2 files

1.2.167

2 files

1.2.166

2 files

1.2.165

2 files

1.2.164

2 files

1.2.163

2 files

1.2.162

2 files

1.2.161

2 files

1.2.160

2 files

1.2.159

2 files

1.2.158

2 files

1.2.157

2 files

1.2.156

2 files

1.2.155

2 files

1.2.154

2 files

1.2.153

2 files

1.2.152

2 files

1.2.151

2 files

1.2.150

2 files

1.2.149

2 files

1.2.148

2 files

1.2.147

2 files

1.2.146

2 files

1.2.145

2 files

1.2.144

2 files

1.2.143

2 files

1.2.142

2 files

1.2.141

2 files

1.2.140

2 files

1.2.139

2 files

1.2.138

2 files

1.2.137

2 files

1.2.136

2 files

1.2.135

2 files

1.2.134

2 files

1.2.133

2 files

1.2.131

2 files

1.2.130

2 files

1.2.129

2 files

1.2.128

2 files

1.2.127

2 files

1.2.126

2 files

1.2.125

2 files

1.2.123

2 files

1.2.122

2 files

1.2.121

2 files

1.2.120

2 files

1.2.119

2 files

1.2.118

2 files

1.2.117

2 files

0.0.2

1 file

0.0.1

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page