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.

Release files for discord-protos 1.2.330

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for discord-protos 1.2.330
File	Size	Uploaded
discord_protos-1.2.330.tar.gz	207.4 kB	Sep 15, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for discord-protos 1.2.330
File	Interpreter	ABI	Platform	Reset
discord_protos-1.2.330-py3-none-any.whl 237.3 kB Sep 15, 2026	Python 3	none	any	Details

Total release size: 444.7 kB

Release files / discord_protos-1.2.330.tar.gz

Download URL	discord_protos-1.2.330.tar.gz
Size	207.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`1d26589f9ba40ef2a6e2e1acc5075612eed4272a93ed50808e6ca0056f36f921`
BLAKE2b-256 checksum How to use checksums	`2d6658e3abebbb25861820c1c61b4990d2c1dc8c6ff484f82ea6f828cb67cc86`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/discord-userdoccers/discord-protos
Publishing commit: github.com/discord-userdoccers/discord-protos/tree/5e8428cfbb1dfa857edbe90f3e28e7f78eafe8b4

Workflow

Publishing configuration: github.com/discord-userdoccers/discord-protos/blob/5e8428cfbb1dfa857edbe90f3e28e7f78eafe8b4/.github/workflows/update.yml
Publishing logs: github.com/discord-userdoccers/discord-protos/actions/runs/35035909185/attempts/1

Artifact

Subject: discord_protos-1.2.330.tar.gz
SHA-256 checksum: 1d26589f9ba40ef2a6e2e1acc5075612eed4272a93ed50808e6ca0056f36f921 Verifying attestations

Release files / discord_protos-1.2.330-py3-none-any.whl

Download URL	discord_protos-1.2.330-py3-none-any.whl
Size	237.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b40998ab1054d03c310a79519bbf48403ea803d33f6dfead0c7e90ed88631b4c`
BLAKE2b-256 checksum How to use checksums	`170bcd92c716dee8b77455f718d468052ca7d286a6a3c885f29cb0208e9e061f`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/discord-userdoccers/discord-protos
Publishing commit: github.com/discord-userdoccers/discord-protos/tree/5e8428cfbb1dfa857edbe90f3e28e7f78eafe8b4

Workflow

Publishing configuration: github.com/discord-userdoccers/discord-protos/blob/5e8428cfbb1dfa857edbe90f3e28e7f78eafe8b4/.github/workflows/update.yml
Publishing logs: github.com/discord-userdoccers/discord-protos/actions/runs/35035909185/attempts/1

Artifact

Subject: discord_protos-1.2.330-py3-none-any.whl
SHA-256 checksum: b40998ab1054d03c310a79519bbf48403ea803d33f6dfead0c7e90ed88631b4c Verifying attestations