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

Uploaded Python 3

File details

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

File metadata

  • Download URL: discord_protos-1.2.301.tar.gz
  • Upload date:
  • Size: 191.8 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.301.tar.gz
Algorithm Hash digest
SHA256 5bc84f7ee566562fb030c474c0a1b4fac39b69641437c693ad9be6bf2d85d992
MD5 12d07f045b0170190e0c88a6a353185f
BLAKE2b-256 b1dd23c4251e890db696177309a825f0a47920006bcd0e857e597492851c3b00

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for discord_protos-1.2.301-py3-none-any.whl
Algorithm Hash digest
SHA256 5ab25cab3f38f074dcd4e2c9541ab7f53ccfe1791c86e858a3b45d319f48e7c9
MD5 bc565d933f3fab3c00b5af7ca787ce65
BLAKE2b-256 3bd67eddb3997ff88c412c131f6ffb3fa2c8713302ef40a44e579a6be0d8c79c

See more details on using hashes here.

Provenance

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

1.2.302

2 files

This release

1.2.301 This release

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