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.276.tar.gz (187.7 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.276-py3-none-any.whl (206.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: discord_protos-1.2.276.tar.gz
  • Upload date:
  • Size: 187.7 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.276.tar.gz
Algorithm Hash digest
SHA256 87c1c77e67cddf84dc683eee43f93e09d5415ce4731ae88e9fada92b58478de7
MD5 d9f66de0015a3f13a04665922adacde0
BLAKE2b-256 b2a026bc4f5aeb6ad0e36bb2976883cd97fdd8b5e2ecc1267dc083df5263ed0f

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for discord_protos-1.2.276-py3-none-any.whl
Algorithm Hash digest
SHA256 71038b2f841e3acf3b19e623933083f8bdb25831edf31f92c649d1a237ce9caf
MD5 3d408ead5a89128050c27cdd42aaceb7
BLAKE2b-256 85da5767f86384c77dc16c4b993aa04245bf834e36db94efa4c24cc1b6e83cf1

See more details on using hashes here.

Provenance

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

1.2.279

2 files

1.2.278

2 files

1.2.277

2 files

This release

1.2.276 This release

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