---
id: discord-protos
version: "1.2.296"
license: MIT
license_treatment: permissive
maintenance: active
---

# discord-protos — Discord user settings protobufs.

License: permissive · Maintenance: active · Downloads: 110.5K/mo

## What it is and what it does

discord-protos is a Python package containing automatically-generated protocol buffer definitions extracted from Discord's client source code. It provides ready-to-use message classes for encoding and decoding Discord's internal data formats, particularly user settings like PreloadedUserSettings and FrecencyUserSettings. The package is maintained by tracking changes in Discord's protobufs and releasing updates automatically when new definitions are detected.

The package depends on protobuf and mypy-protobuf for runtime support. It is designed for developers who need to work with Discord's wire protocol or settings data outside the official Discord API—for example, building custom clients, analyzing settings structures, or integrating with Discord's internal message formats. The protobufs are provided as compiled Python modules ready for import and use.

Use it for:

- Serialize and deserialize Discord user settings (status, custom status, preferences) for custom Discord client implementations.
- Encode user settings data to base64 for transmission or storage in a format compatible with Discord's protocol.
- Parse and inspect Discord's internal protobuf messages when reverse-engineering or analyzing Discord client behavior.
- Build Discord bots or tools that need to work with user settings data at the protocol level.
- Test or validate Discord protocol changes by comparing generated protobufs against known message structures.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python bindings for Discord's protocol buffer definitions, enabling serialization and deserialization of Discord user settings and related data structures.

Yes, if you are building custom Discord clients or tools that need to work with Discord's internal protobuf formats. The package is actively maintained, has low install friction, carries a permissive MIT license, and has no known security vulnerabilities. However, be aware that reverse-engineered protobufs may change without notice as Discord updates its client, and you should verify compatibility with your use case before relying on it in production.

## Install

pip install discord-protos
uv add discord-protos
poetry add discord-protos

## Installing discord-protos

Before you install: Low install friction with a pure-wheel distribution. Active maintenance with a release on 2026-08-14 and regular updates tied to Discord client changes. Depends on protobuf and mypy-protobuf, both standard tooling.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal restrictions, making this suitable for both open-source and commercial projects.

Quickstart:

pip install discord-protos

import base64
from discord_protos import PreloadedUserSettings

settings = PreloadedUserSettings()
payload = settings.SerializeToString()
encoded = base64.b64encode(payload).decode('ascii')

Requires Python 3.8 or later; protobuf library must be installed as a runtime dependency.

Verify before relying:

- Whether the automatically-generated protobufs remain compatible across Discord client versions without breaking changes.
- Performance characteristics when handling large or deeply-nested protobuf messages.
- Whether reverse-engineered protobufs are subject to Discord's terms of service or legal constraints.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 110.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

discord protocol buffers python, discord protobufs bindings, discord user settings serialization, discord data structures protobuf, discord client protocol messages, protobuf discord integration, discord settings encoding decoding, protobuf, discord-api, reverse-engineered

[View on SkillFed](https://skillfed.io/packages/discord-protos) · [View on PyPI](https://pypi.org/project/discord-protos/)