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.279.tar.gz (187.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.279-py3-none-any.whl (207.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: discord_protos-1.2.279.tar.gz
  • Upload date:
  • Size: 187.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.279.tar.gz
Algorithm Hash digest
SHA256 e60d2c8bef71fa487f01207b6fc7f2b75f47a20e4126e53c0290bae263af2916
MD5 8ca5433d09f6ee058a41697e5171c813
BLAKE2b-256 c3c2eb1fbb4e8c8e860d8bf9eee35ff2edbcde07cefb650755a92016b034dfd8

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for discord_protos-1.2.279-py3-none-any.whl
Algorithm Hash digest
SHA256 3e46ed5b4b384823c0c8b8dad5fa38342a659236ff34dbb3830ff1036432a86e
MD5 00e9a7d536e5ff9ab47f1e853854ef1c
BLAKE2b-256 d456c04b28f9acce3e5bf30b3070532515ee28f6ab39034d0bc35fd5aa7ddb83

See more details on using hashes here.

Provenance

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

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

This release

1.2.279 This release

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