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.302.tar.gz (191.9 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.302-py3-none-any.whl (211.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: discord_protos-1.2.302.tar.gz
  • Upload date:
  • Size: 191.9 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.302.tar.gz
Algorithm Hash digest
SHA256 86cd2f099feaa79a80876900bbd4899abb16092b667f5866ef29ee202b8f6008
MD5 a5c179ec6f07230c82c67d3314fe6432
BLAKE2b-256 dfcc23f9138db53e1a153f3ef89dfbbfb41d325fdf89fda5044f481aaeed2bd6

See more details on using hashes here.

Provenance

The following attestation bundles were made for discord_protos-1.2.302.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.302-py3-none-any.whl.

File metadata

File hashes

Hashes for discord_protos-1.2.302-py3-none-any.whl
Algorithm Hash digest
SHA256 6d26e21814192fce32f58e7369619c4a745ac4ae709c60a13d51c20560cc2763
MD5 56135c49c84633dd5c997695b05d35ef
BLAKE2b-256 ef9412ac806bea804686260ab5f4abaab7333458a84e12142a33aab15d2d4c3e

See more details on using hashes here.

Provenance

The following attestation bundles were made for discord_protos-1.2.302-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

1.2.309

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

This release

1.2.302 This release

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