Soheab

Components V2 to discord.py' LayoutView

A small helper class for discord.py that builds a discord.ui.LayoutView straight from a raw Components V2 payload (the plain dict/JSON shape Discord itself sends and expects), and converts it back.

Normally you build a LayoutView by instantiating the discord.ui items yourself (discord.ui.Container(...), discord.ui.Section(...), etc) and adding them to the view with add_item. That's fine when you're writing the layout by hand, but it gets annoying if you want to store layouts somewhere (a database, a JSON file, a layout editor) and load them dynamically.

Soheab

These settings and "tricks" are split into Mobile, Desktop, and both as they may differ. I personally use iOS, but it should be the same on Android too. I will probably mention it per topic if it's not.

Feel free to send me a direct message requests while being in the discord developers server if you see any mistakes or want me to add anything.

Go To

Mobile

• Shortcut 1

Desktop

Soheab

• "Advaith" mentioned
• "AI" mentioned
• "AIX" mentioned
• "!report"
• "!support"
• "CV2"
• "DAVE" mentioned
• "Do mods here get paid?"
• "How to remove x badge"
• "MLS" mentioned

Soheab

The following approach is needed because Discord has effectively abandoned the voice status feature.

It is not documented in the official Discord API documentation, which means it is considered unstable and may change at any time without notice.

That level of uncertainty is not ideal for a library like discord.py. The behavior described below is not necessarily undocumented or explicitly discouraged, but you are largely on your own. You are working directly with the raw data that the Discord API sends to the library, before it is parsed or exposed through any higher-level abstractions.

For more information or questions about this approach, you can ask in the discord.py server.

Also see discord/discord-api-docs#6398

Soheab

Basics

• (Forum) posts are threads in forum channels.
• Threads can be created per message or per channel.
• Only channel threads can be private.
• For message and forum threads, the thread's ID matches the starter message's ID.
• You can lock threads so only users with the right permissions can send messages.
• Threads can be archived, which removes them from the channel list. This also happens automatically after a period of inactivity.
  • You can set how long a thread stays active before auto-archiving with auto_archive_duration.
  • Get the archive time with archive_timestamp.

Soheab

• automod commands (https://github.com/demoutrei/discord-autobot)
• channel commands
  • name
  • topic
  • thread name (https://github.com/demoutrei/discord-commands)
  • overwrites
  • invite
  • typing event
• user commands
• nickname

Soheab

from __future__ import annotations
import datetime
from typing import Any, Literal, Self, overload

import discord

type ValidMediaType = (
    str
    | Media
    | discord.MediaGalleryItem

Soheab

Components V2 Paginator

Looking for a non-cv2 paginator? Go to https://gist.github.com/Soheab/f226fc06a3468af01ea3168c95b30af8

Usage

0. Give this gist a ⭐️ :P
1. Copy and paste the contents above into a file like utils/paginator.py
2. Import ButtonPaginator and subclass it or use it directly anywhere.

Arguments

Soheab

Components V2

Looking to paginate with v2 components like a Container? Go to https://gist.github.com/Soheab/891c39d7294b1bdbadc7ecf35ce51cc5

Usage

1. Copypaste the contents above into a file like utils/paginator.py
2. Import ButtonPaginator and subclass it or use it directly anywhere.

Options

ButtonPaginator has a couple of arguments.

Soheab

What is self.bot and how does it work?

TLDR: it's a custom attribute which you define.

self = class instance
bot = attribute that's usually assigned to the bot instance given in an extension's setup function.

Basically:

class MyCog(Cog):
    # this function is called when we do MyCog()