Fix Red.send_interactive() permission check again (#6697)

Co-authored-by: Michael Oliveira <34169552+Flame442@users.noreply.github.com>

.github/labeler.yml

@@ -50,10 +50,6 @@
   - redbot/cogs/downloader/*
   # Docs
   - docs/cog_guides/downloader.rst
-  # Tests
-  - redbot/pytest/downloader.py
-  - redbot/pytest/downloader_testrepo.*
-  - tests/cogs/downloader/**/*
 "Category: Cogs - Economy":
   # Source
   - redbot/cogs/economy/*
@@ -212,6 +208,13 @@
   - redbot/core/_cli.py
   - redbot/core/_debuginfo.py
   - redbot/setup.py
+"Category: Core - Downloader":
+  # Source
+  - redbot/core/_downloader/**/*
+  # Tests
+  - redbot/pytest/downloader.py
+  - redbot/pytest/downloader_testrepo.*
+  - tests/core/_downloader/**/*
 "Category: Core - Help":
   - redbot/core/commands/help.py
 "Category: Core - i18n":
@@ -263,7 +266,6 @@
   - docs/framework_events.rst
   - docs/guide_cog_creation.rst
   - docs/guide_cog_creators.rst
-  - docs/guide_migration.rst
   - docs/guide_publish_cogs.rst
   - docs/guide_slash_and_interactions.rst
 "Category: Docs - Install Guides":
@@ -273,6 +275,7 @@
   - docs/bot_application_guide.rst
   - docs/install_guides/**/*
   - docs/update_red.rst
+  - docs/backup_red.rst
 "Category: Docs - Other":
   - docs/host-list.rst
   - docs/index.rst

.github/workflows/check_label_pattern_exhaustiveness.yaml

@@ -17,7 +17,7 @@ jobs:
       - name: Install script's pre-requirements
         run: |
           python -m pip install -U pip
-          python -m pip install -U pathspec pyyaml rich
+          python -m pip install -U pathspec pyyaml rich typing_extensions
       - name: Check label pattern exhaustiveness
         run: |
           python .github/workflows/scripts/check_label_pattern_exhaustiveness.py

.github/workflows/prepare_release.yml

@@ -7,18 +7,24 @@ on:
         required: false
         default: 'auto'
 
-permissions:
-  contents: write
-  pull-requests: write
-
 jobs:
   crowdin_download_translations:
+    environment: Prepare Release
     needs: pr_stable_bump
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/create-github-app-token@v2
+        id: app-token
+        with:
+          app-id: ${{ secrets.RED_RELEASER_CLIENT_ID }}
+          private-key: ${{ secrets.RED_RELEASER_PRIVATE_KEY }}
+
+      # Checkout repository and install Python
+      - uses: actions/checkout@v6
+        with:
+          token: ${{ steps.app-token.outputs.token }}
       - name: Set up Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v6
         with:
           python-version: '3.8'
       - name: Install dependencies
@@ -43,7 +49,7 @@ jobs:
         id: cpr_crowdin
         uses: peter-evans/create-pull-request@v4
         with:
-          token: ${{ secrets.GITHUB_TOKEN }}
+          token: ${{ steps.app-token.outputs.token }}
           commit-message: Automated Crowdin downstream
           title: "Automated Crowdin downstream"
           body: |
@@ -51,31 +57,32 @@ jobs:
             Please ensure that there are no errors or invalid files are in the PR.
           labels: "Automated PR, Changelog Entry: Skipped"
           branch: "automated/i18n"
-          author: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
+          committer: >-
+            ${{ steps.app-token.outputs.app-slug }}[bot]
+            <263745220+${{ steps.app-token.outputs.app-slug }}[bot]@users.noreply.github.com>
+          author: >-
+            ${{ steps.app-token.outputs.app-slug }}[bot]
+            <263745220+${{ steps.app-token.outputs.app-slug }}[bot]@users.noreply.github.com>
           milestone: ${{ needs.pr_stable_bump.outputs.milestone_number }}
 
-      - name: Close and reopen the PR with different token to trigger CI
-        uses: actions/github-script@v6
-        env:
-          PR_NUMBER: ${{ steps.cpr_crowdin.outputs.pull-request-number }}
-          PR_OPERATION: ${{ steps.cpr_crowdin.outputs.pull-request-operation }}
-        with:
-          github-token: ${{ secrets.cogcreators_bot_repo_scoped }}
-          script: |
-            const script = require(
-              `${process.env.GITHUB_WORKSPACE}/.github/workflows/scripts/close_and_reopen_pr.js`
-            );
-            console.log(script({github, context}));
-
   pr_stable_bump:
+    environment: Prepare Release
     runs-on: ubuntu-latest
     outputs:
       milestone_number: ${{ steps.get_milestone_number.outputs.result }}
     steps:
+      - uses: actions/create-github-app-token@v2
+        id: app-token
+        with:
+          app-id: ${{ secrets.RED_RELEASER_CLIENT_ID }}
+          private-key: ${{ secrets.RED_RELEASER_PRIVATE_KEY }}
+
       # Checkout repository and install Python
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
+        with:
+          token: ${{ steps.app-token.outputs.token }}
       - name: Set up Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v6
         with:
           python-version: '3.8'
 
@@ -105,7 +112,7 @@ jobs:
         id: cpr_bump_stable
         uses: peter-evans/create-pull-request@v4
         with:
-          token: ${{ secrets.GITHUB_TOKEN }}
+          token: ${{ steps.app-token.outputs.token }}
           commit-message: Version bump to ${{ steps.bump_version_stable.outputs.new_version }}
           title: Version bump to ${{ steps.bump_version_stable.outputs.new_version }}
           body: |
@@ -113,18 +120,10 @@ jobs:
             Please ensure that there are no errors or invalid files are in the PR.
           labels: "Automated PR, Changelog Entry: Skipped"
           branch: "automated/pr_bumps/${{ steps.bump_version_stable.outputs.new_version }}"
-          author: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
+          committer: >-
+            ${{ steps.app-token.outputs.app-slug }}[bot]
+            <263745220+${{ steps.app-token.outputs.app-slug }}[bot]@users.noreply.github.com>
+          author: >-
+            ${{ steps.app-token.outputs.app-slug }}[bot]
+            <263745220+${{ steps.app-token.outputs.app-slug }}[bot]@users.noreply.github.com>
           milestone: ${{ steps.get_milestone_number.outputs.result }}
-
-      - name: Close and reopen the PR with different token to trigger CI
-        uses: actions/github-script@v6
-        env:
-          PR_NUMBER: ${{ steps.cpr_bump_stable.outputs.pull-request-number }}
-          PR_OPERATION: ${{ steps.cpr_bump_stable.outputs.pull-request-operation }}
-        with:
-          github-token: ${{ secrets.cogcreators_bot_repo_scoped }}
-          script: |
-            const script = require(
-              `${process.env.GITHUB_WORKSPACE}/.github/workflows/scripts/close_and_reopen_pr.js`
-            );
-            console.log(await script({github, context}));

.github/workflows/publish_release.yml

@@ -147,9 +147,7 @@ jobs:
           print-hash: true
 
   pr_dev_bump:
-    permissions:
-      contents: write
-      pull-requests: write
+    environment: Prepare Release
     needs: release_to_pypi
     name: Update Red version number to dev
     runs-on: ubuntu-latest
@@ -160,11 +158,18 @@ jobs:
         run: |
           echo "BASE_BRANCH=${TAG_BASE_BRANCH#'refs/heads/'}" >> $GITHUB_ENV
 
-      - uses: actions/checkout@v4
+      - uses: actions/create-github-app-token@v2
+        id: app-token
+        with:
+          app-id: ${{ secrets.RED_RELEASER_CLIENT_ID }}
+          private-key: ${{ secrets.RED_RELEASER_PRIVATE_KEY }}
+
+      - uses: actions/checkout@v6
         with:
           ref: ${{ env.BASE_BRANCH }}
+          token: ${{ steps.app-token.outputs.token }}
       - name: Set up Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v6
         with:
           python-version: '3.8'
 
@@ -194,7 +199,7 @@ jobs:
         id: cpr_bump_dev
         uses: peter-evans/create-pull-request@v4
         with:
-          token: ${{ secrets.GITHUB_TOKEN }}
+          token: ${{ steps.app-token.outputs.token }}
           commit-message: Version bump to ${{ steps.bump_version_dev.outputs.new_version }}
           title: Version bump to ${{ steps.bump_version_dev.outputs.new_version }}
           body: |
@@ -202,19 +207,11 @@ jobs:
             Please ensure that there are no errors or invalid files are in the PR.
           labels: "Automated PR, Changelog Entry: Skipped"
           branch: "automated/pr_bumps/${{ steps.bump_version_dev.outputs.new_version }}"
-          author: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
+          committer: >-
+            ${{ steps.app-token.outputs.app-slug }}[bot]
+            <263745220+${{ steps.app-token.outputs.app-slug }}[bot]@users.noreply.github.com>
+          author: >-
+            ${{ steps.app-token.outputs.app-slug }}[bot]
+            <263745220+${{ steps.app-token.outputs.app-slug }}[bot]@users.noreply.github.com>
           milestone: ${{ steps.get_milestone_number.outputs.result }}
           base: ${{ env.BASE_BRANCH }}
-
-      - name: Close and reopen the PR with different token to trigger CI
-        uses: actions/github-script@v6
-        env:
-          PR_NUMBER: ${{ steps.cpr_bump_dev.outputs.pull-request-number }}
-          PR_OPERATION: ${{ steps.cpr_bump_dev.outputs.pull-request-operation }}
-        with:
-          github-token: ${{ secrets.cogcreators_bot_repo_scoped }}
-          script: |
-            const script = require(
-              `${process.env.GITHUB_WORKSPACE}/.github/workflows/scripts/close_and_reopen_pr.js`
-            );
-            console.log(await script({github, context}));

.github/workflows/scripts/merge_requirements.py

@@ -137,25 +137,27 @@ for name in names:
             python_version_marker = (
                 # Requirement present on less Python versions than not.
                 " or ".join(
-                    f"python_version == '{python_version}'" for python_version in python_versions
+                    f"python_version == '{python_version}'"
+                    for python_version in sorted(python_versions)
                 )
                 if len(python_versions) < len(all_python_versions - python_versions)
                 # Requirement present on more Python versions than not
                 # This may generate an empty string when Python version is irrelevant.
                 else " and ".join(
                     f"python_version != '{python_version}'"
-                    for python_version in all_python_versions - python_versions
+                    for python_version in sorted(all_python_versions - python_versions)
                 )
             )
 
             platform_marker = (
                 # Requirement present on less platforms than not.
-                " or ".join(f"sys_platform == '{platform}'" for platform in platforms)
+                " or ".join(f"sys_platform == '{platform}'" for platform in sorted(platforms))
                 if len(platforms) < len(all_platforms - platforms)
                 # Requirement present on more platforms than not
                 # This may generate an empty string when platform is irrelevant.
                 else " and ".join(
-                    f"sys_platform != '{platform}'" for platform in all_platforms - platforms
+                    f"sys_platform != '{platform}'"
+                    for platform in sorted(all_platforms - platforms)
                 )
             )
 
@@ -169,12 +171,12 @@ for name in names:
                 # Requirement present on less envs than not.
                 " or ".join(
                     f"(sys_platform == '{platform}' and python_version == '{python_version}')"
-                    for platform, python_version in iter_envs(envs)
+                    for platform, python_version in iter_envs(sorted(envs))
                 )
                 if len(envs) < len(all_envs - envs.keys())
                 else " and ".join(
                     f"(sys_platform != '{platform}' and python_version != '{python_version}')"
-                    for platform, python_version in iter_envs(all_envs - envs.keys())
+                    for platform, python_version in iter_envs(sorted(all_envs - envs.keys()))
                 )
             )
 

.readthedocs.yml

@@ -7,6 +7,10 @@ build:
   jobs:
     install:
       - pip install .[doc]
+    post_build:
+      - mkdir -p docs/_build/doctrees docs/_build/markdown "$READTHEDOCS_OUTPUT/html/_markdown"
+      - python -m sphinx -T -b markdown -d docs/_build/doctrees -D "language=$READTHEDOCS_LANGUAGE" docs docs/_build/markdown
+      - cp docs/_build/markdown/changelog.md "$READTHEDOCS_OUTPUT/html/_markdown/changelog.md"
 
 sphinx:
   configuration: docs/conf.py

README.md

@@ -64,6 +64,12 @@ liking, making it completely customizable. This is a *self-hosted bot* – meani
 to host and maintain your own instance. You can turn Red into an admin bot, music bot, trivia bot,
 new best friend or all of these together!  
 
+Red is built for [Discord](https://discord.com/), a popular VOIP and instant messaging platform.
+It's best suited for use in guilds (also known as servers), where it utilizes Discord's
+well-documented API to communicate and deliver its many features. Discord offers its API to
+encourage developers to explore their creativity by building programs, tools, and services that
+enhance the Discord experience.
+
 [Installation](#installation) is easy, and you do **NOT** need to know anything about coding! Aside
 from installing and updating, every part of the bot can be controlled from within Discord.
 

docs/_ext/changelog_contributors.py

@@ -0,0 +1,43 @@
+from typing import Any, Dict, List
+
+from docutils import nodes
+from sphinx.application import Sphinx
+from sphinx.util.docutils import SphinxDirective
+
+
+class ChangelogContributors(SphinxDirective):
+    has_content = True
+
+    def run(self) -> List[nodes.Node]:
+        contributors = [contributor for line in self.content for contributor in line.split()]
+
+        comment_value = " ".join(contributors)
+        line_nodes = []
+        for contributor in contributors:
+            if line_nodes:
+                line_nodes.append(nodes.Text(", "))
+            line_nodes.append(
+                nodes.reference(
+                    contributor,
+                    f"@{contributor}",
+                    internal=False,
+                    refuri=f"https://github.com/sponsors/{contributor}",
+                )
+            )
+
+        node = nodes.line_block(
+            "",
+            nodes.comment("", f"RED-CHANGELOG-CONTRIBUTORS: {comment_value}"),
+            nodes.line("", "Thanks to all these amazing people who contributed to this release:"),
+            nodes.line("", "", *line_nodes),
+        )
+        return [node]
+
+
+def setup(app: Sphinx) -> Dict[str, Any]:
+    app.add_directive("changelog-contributors", ChangelogContributors)
+    return {
+        "version": "1.0",
+        "parallel_read_safe": True,
+        "parallel_write_safe": True,
+    }

docs/_ext/prompt_builder.py

@@ -0,0 +1,154 @@
+from __future__ import annotations
+
+import json
+import os
+from typing import Any, Dict, List, Set
+
+from docutils import nodes
+from docutils.io import StringOutput
+from docutils.nodes import Element
+
+from sphinx.application import Sphinx
+from sphinx.builders.text import TextBuilder
+from sphinx.writers.text import TextWriter
+from sphinx.util import logging
+from sphinx.util.docutils import SphinxTranslator
+
+logger = logging.getLogger(__name__)
+
+
+class PromptTranslator(SphinxTranslator):
+    builder: PromptBuilder
+
+    def __init__(self, document: nodes.document, builder: PromptBuilder) -> None:
+        super().__init__(document, builder)
+        self.body = ""
+        self.prompts: List[Dict[str, str]] = []
+
+    def visit_document(self, node: Element) -> None:
+        pass
+
+    def depart_document(self, node: Element) -> None:
+        if not self.prompts:
+            self.body = ""
+            return
+        if self.builder.out_suffix.endswith(".json"):
+            self.body = json.dumps(self.prompts, indent=4)
+        else:
+            self.body = "\n".join(prompt["content"] for prompt in self.prompts)
+
+    def unknown_visit(self, node: Element) -> None:
+        pass
+
+    def unknown_departure(self, node: Element) -> None:
+        pass
+
+    def visit_prompt(self, node: Element) -> None:
+        self.prompts.append(
+            {
+                "language": node.attributes["language"],
+                "prompts": node.attributes["prompts"],
+                "modifiers": node.attributes["modifiers"],
+                "rawsource": node.rawsource,
+                "content": node.children[0],
+            }
+        )
+
+
+class PromptWriter(TextWriter):
+    def translate(self) -> None:
+        visitor = self.builder.create_translator(self.document, self.builder)
+        self.document.walkabout(visitor)
+        self.output = visitor.body
+
+
+class prompt(nodes.literal_block):
+    pass
+
+
+class PromptBuilder(TextBuilder):
+    """Extract prompts from documents."""
+
+    format = "json"
+    epilog = "The files with prompts are in %(outdir)s."
+
+    out_suffix = ".json"
+    default_translator_class = PromptTranslator
+    writer: PromptWriter
+
+    def init(self) -> None:
+        sphinx_prompt = __import__("sphinx-prompt")
+
+        def run(self) -> List[prompt]:
+            self.assert_has_content()
+            rawsource = "\n".join(self.content)
+            language = self.options.get("language") or "text"
+            prompts = [
+                p
+                for p in (
+                    self.options.get("prompts") or sphinx_prompt.PROMPTS.get(language, "")
+                ).split(",")
+                if p
+            ]
+            modifiers = [
+                modifier for modifier in self.options.get("modifiers", "").split(",") if modifier
+            ]
+            content = rawsource
+            if "auto" in modifiers:
+                parts = []
+                for line in self.content:
+                    for p in prompts:
+                        if line.startswith(p):
+                            line = line[len(p) + 1 :].rstrip()
+                    parts.append(line)
+                content = "\n".join(parts)
+            node = prompt(
+                rawsource,
+                content,
+                directive_content=self.content,
+                language=language,
+                prompts=self.options.get("prompts") or sphinx_prompt.PROMPTS.get(language, ""),
+                modifiers=modifiers,
+            )
+            return [node]
+
+        sphinx_prompt.PromptDirective.run = run
+
+    def prepare_writing(self, docnames: Set[str]) -> None:
+        del docnames
+        self.writer = PromptWriter(self)
+
+    def write_doc(self, docname: str, doctree: nodes.document) -> None:
+        self.writer.write(doctree, StringOutput(encoding="utf-8"))
+        if not self.writer.output:
+            # don't write empty files
+            return
+
+        filename = os.path.join(self.outdir, docname.replace("/", os.path.sep) + self.out_suffix)
+        os.makedirs(os.path.dirname(filename), exist_ok=True)
+        try:
+            with open(filename, "w", encoding="utf-8") as f:
+                f.write(self.writer.output)
+        except OSError as err:
+            logger.warning("error writing file %s: %s", filename, err)
+
+
+class JsonPromptBuilder(PromptBuilder):
+    name = "jsonprompt"
+    out_suffix = ".json"
+
+
+class TextPromptBuilder(PromptBuilder):
+    name = "textprompt"
+    out_suffix = ".txt"
+
+
+def setup(app: Sphinx) -> Dict[str, Any]:
+    app.add_builder(JsonPromptBuilder)
+    app.add_builder(TextPromptBuilder)
+
+    return {
+        "version": "1.0",
+        "parallel_read_safe": True,
+        "parallel_write_safe": True,
+    }

docs/about_venv.rst

@@ -3,16 +3,14 @@
 ==========================
 About Virtual Environments
 ==========================
-Creating a virtual environment is really easy and usually prevents many common installation
-problems.
+Creating a virtual environment is simple and helps prevent installation problems.
 
 **What Are Virtual Environments For?**
 
-Virtual environments allow you to isolate Red's library dependencies, cog dependencies and python
-binaries from the rest of your system. There is no performance overhead to using virtual environment
-and it saves you from a lot of troubles during setup. It also makes sure Red and its dependencies
-are installed to a predictable location which makes uninstalling Red as simple as removing a single folder,
-without worrying about losing your data or other things on your system becoming broken.
+Virtual environments allow you to isolate Red's library dependencies, cog dependencies, and Python
+binaries from the rest of your system with no performance overhead, ensuring those dependencies 
+and Red are installed to a predictable location. This makes uninstalling Red as simple as removing 
+a single folder, preventing any data loss or breaking other things on your system.
 
 
 --------------------------------------------
@@ -21,19 +19,21 @@ Virtual Environments with Multiple Instances
 If you are running multiple instances of Red on the same machine, you have the option of either
 using the same virtual environment for all of them, or creating separate ones.
 
-.. note::
+Using a *single* virtual environment for all of your instances means you:
 
-    This only applies for multiple instances of V3. If you are running a V2 instance as well,
-    you **must** use separate virtual environments.
+- Only need to update Red once for all instances.
+- Must shut down all instances prior to updating.
+- Will save space on your hard drive.
+- Want all instances to share the same version/dependencies.
 
-The advantages of using a *single* virtual environment for all of your V3 instances are:
+Using *multiple* virtual environments for each individual or select groups of instances means you:
 
-- When updating Red, you will only need to update it once for all instances (however you will still need to restart all instances for the changes to take effect)
-- It will save space on your hard drive
-
-On the other hand, you may wish to update each of your instances individually.
+- Need to update Red within each virtual environment separately.
+- Can update Red without needing to update all instances.
+- Only need to shut down the instance(s) being updated.
+- Want different Red/dependency versions on different instances.
 
 .. important::
 
-    Windows users with multiple instances should create *separate* virtual environments, as
-    updating multiple running instances at once is likely to cause errors.
+    Regardless of which option you choose, do not update while any instances within that virtual 
+    environment are running. This is especially true for Windows, as files are locked by the system while in use.

docs/backup_red.rst

@@ -0,0 +1,35 @@
+.. _backup-red:
+
+============================
+Backing Up and Restoring Red
+============================
+
+Red can be backed up and restored to any device as long as it is a supported operating system. See page: :ref:`end-user-guarantees`.
+
+Backup steps are to be done in order and carefully to avoid any issues.
+
+#. Take note of the installed cogs with ``[p]cogs``; and cog repositories with ``[p]load downloader``, then ``[p]repo list`` (``[p]`` is your bot's prefix).
+#. Stop the bot, ideally with ``[p]shutdown``.
+#. Activate your venv, and run ``redbot-setup backup <instancename>``, replacing ``<instancename>`` with the name of your instance.
+#. Copy your backup file to the new machine/location.
+#. Extract the file to a location of your choice (remember the full path and make sure that the user you are going to install/run Red under can access this path).
+#. :ref:`Install Red <install-guides>` as normal on the new machine/location.
+#. Run ``redbot-setup`` in your venv to create a new instance, using the path you remembered above as your data path.
+#. Start your new instance.
+#. Re-add the cog repositories using the same names as before.
+#. Do ``[p]cog update``.
+#. Re-add any cogs that were not re-installed (you may have to uninstall them first as Downloader may think they are still installed).
+
+    .. note::
+
+        The config (data) from cogs has been saved, but not the code itself.
+
+    .. tip::
+
+        You can fix permissions (if needed) on your directory using:
+
+        .. code-block:: bash
+
+            sudo chown -R <user>:<user> ~/.local
+
+        Replace ``<user>`` with your actual username.

docs/bot_application_guide.rst

@@ -21,25 +21,34 @@ Creating a Bot account is a pretty straightforward process.
     .. image:: /.resources/bot-guide/discord_create_app_button.png
         :alt: The new application button.
 
-4. Give the application a name and click "Create".
+4. Give the application a name, check the box to accept the Terms of Service, and click "Create".
 
     .. image::  /.resources/bot-guide/discord_create_app_form.png
         :alt: The new application form filled in.
 
-5. Create a Bot User by navigating to the "Bot" tab and clicking "Add Bot".
+5. Navigate to the "Install" tab on the left side of the screen.
 
-    - Click "Yes, do it!" to continue.
+    .. image:: /.resources/bot-guide/discord_installation_tab.png
+        :alt: The installation tab in the application page.
 
-    .. image::  /.resources/bot-guide/discord_create_bot_user.png
-        :alt: The Add Bot button.
-6. If you want others to be able to invite your bot tick the **Public Bot**. Keeping it unticked will prevent others from inviting your bot to their servers and only you will be able to add the bot to servers (provided that you have needed permissions in the server you want to add the bot to).
+6. Uncheck "User Install" and set "Install Link" to "None"
+
+    .. image:: /.resources/bot-guide/discord_installation_options.png
+        :alt: How the Installation options should look like for most people.
+
+7. Navigate to the "Bot" tab on the left side of the screen.
+
+    .. image:: /.resources/bot-guide/discord_bot_tab.png
+        :alt: The bot tab in the application page.
+
+8. If you want others to be able to invite your bot tick the **Public Bot**. Keeping it unticked will prevent others from inviting your bot to their servers and only you will be able to add the bot to servers (provided that you have needed permissions in the server you want to add the bot to).
 
     - Make sure **Require OAuth2 Code Grant** is unchecked.
 
     .. image::  /.resources/bot-guide/discord_bot_user_options.png
         :alt: How the Bot User options should look like for most people.
 
-7. Copy the token using the "Copy" button.
+9. Acquire the token using the "Reset Token" button, then "Copy" after it is revealed.
 
     - **This is not the Client Secret at the General Information page**
 

docs/cog_guides/audio.rst

@@ -116,18 +116,18 @@ How can I use this playlist link with playlist commands in audio?**
     :ref:`setting up Audio for multiple bots<multibots>`. Otherwise, another process is using the 
     port, so you need to figure out what is using port 2333 and terminate/disconnect it yourself.
     
-**Q: My terminal is saying that I "must install Java 17 or 11 for Lavalink to run". How can I fix this?**
+**Q: My terminal is saying that I "must install Java 21 or 17 for Lavalink to run". How can I fix this?**
 
     You are getting this error because you have a different version of Java installed, or you don't have
-    Java installed at all. As the error states, Java 17 or 11 is required, and can be installed from
-    `here <https://adoptium.net/temurin/releases/?version=17>`__.
+    Java installed at all. As the error states, Java 21 or 17 is required, and can be installed from
+    `here <https://adoptium.net/temurin/releases/?version=21>`__.
     
-    If you have Java 17 or 11 installed, and are still getting this error, you will have to manually tell Audio where your Java install is located.
-    Use ``[p]llset java <path_to_java_17_or_11_executable>``, to make Audio launch Lavalink with a
+    If you have Java 21 or 17 installed, and are still getting this error, you will have to manually tell Audio where your Java install is located.
+    Use ``[p]llset java <path_to_java_21_or_17_executable>``, to make Audio launch Lavalink with a
     specific Java binary. To do this, you will need to locate your ``java.exe``/``java`` file
-    in your **Java 17 or 11 install**.
+    in your **Java 21 or 17 install**.
     
-    Alternatively, update your PATH settings so that Java 17 or 11 is the one used by ``java``. However,
+    Alternatively, update your PATH settings so that Java 21 or 17 is the one used by ``java``. However,
     you should confirm that nothing other than Red is running on the machine that requires Java.
 
 .. _queue_commands:
@@ -550,7 +550,7 @@ uses OpenJDK 17 in the managed Lavalink configuration. It can be installed by ru
 
     sudo apt install openjdk-17-jre-headless -y
 
-Otherwise, Lavalink works well with most versions of Java 11, 13, 15, 16, 17, and 18. Azul 
+Otherwise, Lavalink works well with most versions of Java 17 and higher. Azul 
 Zulu builds are suggested, see `here <https://github.com/lavalink-devs/Lavalink/#requirements>`__ for more information.
 
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -3651,7 +3651,7 @@ This command shouldn't need to be used most of the time,
 and is only useful if the host machine has conflicting Java versions.
 
 If changing this make sure that the Java executable you set is supported by Audio.
-The current supported versions are Java 17 and 11.
+The current supported versions are Java 21 or 17.
 
 **Arguments**
 

docs/cog_guides/core.rst

@@ -1829,7 +1829,10 @@ Commands to add servers or channels to the ignore list.
 
 The ignore list will prevent the bot from responding to commands in the configured locations.
 
-.. Note:: Owners and Admins override the ignore list.
+.. Note::
+
+    - Category ignores are ignored by user-installed commands
+    - Owners and Admins override the ignore list.
 
 
 .. _core-command-ignore-channel:
@@ -1850,7 +1853,10 @@ Ignore commands in the channel, thread, or category.
 
 Defaults to the current thread or channel.
 
-.. Note:: Owners, Admins, and those with Manage Channel permissions override ignored channels.
+.. Note::
+
+    - Category ignores are ignored by user-installed commands
+    - Owners and Admins override the ignore list.
 
 
 **Examples:**

docs/cog_guides/mod.rst

@@ -253,7 +253,23 @@ modset dm
 
 .. code-block:: none
 
-    [p]modset dm [enabled]
+    [p]modset dm
+
+**Description**
+
+Settings for messaging the user when being kicked or banned.
+
+.. _mod-command-modset-dm-sendmessage:
+
+"""""""""""""""""""""
+modset dm sendmessage
+"""""""""""""""""""""
+
+**Syntax**
+
+.. code-block:: none
+
+    [p]modset dm sendmessage [enabled]
 
 **Description**
 
@@ -266,6 +282,72 @@ and reason as to why they were kicked/banned.
 
 * ``[enabled]``: Whether a message should be sent to a user when they are kicked/banned. |bool-input|
 
+.. _mod-command-modset-banshowextrafield:
+
+"""""""""""""""""""""""""""
+modset dm banshowextrafield
+"""""""""""""""""""""""""""
+
+**Syntax**
+
+.. code-block:: none
+
+    [p]modset dm banshowextrafield [enabled]
+
+**Description**
+
+Toggle whether to show an extra customizable field when banning.
+
+This can be used to add additional information for the banned user, such as a ban appeal link.
+
+**Arguments**
+
+* ``[enabled]``: If an extra customizable embed field should appear when banning. |bool-input|
+
+.. _mod-command-modset-banextrafieldtitle:
+
+""""""""""""""""""""""""""""
+modset dm banextrafieldtitle
+""""""""""""""""""""""""""""
+
+**Syntax**
+
+.. code-block:: none
+
+    [p]modset dm banextrafieldtitle [title]
+
+**Description**
+
+Set the title for the optional extra embed on ban.
+
+Cannot be over 252 characters long.
+
+**Arguments**
+
+* ``[title]``: The title of the embed field. Can by any string of text under 252 charcters long.
+
+.. _mod-command-modset-banextrafieldcontents:
+
+"""""""""""""""""""""""""""""""
+modset dm banextrafieldcontents
+"""""""""""""""""""""""""""""""
+
+**Syntax**
+
+.. code-block:: none
+
+    [p]modset dm banextrafieldcontents [contents]
+
+**Description**
+
+Set the contents for the optional extra embed on ban
+
+Cannot be over 1024 characters long.
+
+**Arguments**
+
+* ``[contents]``: The contents of the embed field. Can by any string of text under 1024 charcters long.
+
 .. _mod-command-modset-requirereason:
 
 """"""""""""""""""""

docs/cog_guides/streams.rst

@@ -324,7 +324,7 @@ Explains how to set the Twitch token.
 
 To set the Twitch API tokens, follow these steps:
 
-1. Go to this page: https://dev.twitch.tv/dashboard/apps.
+1. Go to this page: https://dev.twitch.tv/console/apps.
 
 2. Click Register Your Application.
 

docs/cog_guides/warnings.rst

@@ -291,7 +291,7 @@ warningset showmoderator
 
 **Description**
 
-Decide whether the name of the moderator warning a user should be included in the DM to that user.
+Decide whether the name of the moderator warning a user should be included in the DM to that user when being warned or self requesting their warnings.
 
 **Arguments**
 
@@ -337,6 +337,26 @@ Set the channel where warnings should be sent to.
 
 * ``[channel]``: |channel-input| Leave empty to use the channel ``[p]warn`` command was called in.
 
+.. _warnings-command-warningset-mywarnings-sendtodms:
+
+"""""""""""""""""""""""""""""""
+warningset mywarnings sendtodms
+"""""""""""""""""""""""""""""""
+
+**Syntax**
+
+.. code-block:: none
+
+    [p]warningset mywarnings sendtodms <true_or_false>
+
+**Description**
+
+Whether a member self requesting their warnings with ``[p]mywarnings`` should get them sent to DMs or in the current channel.
+
+**Arguments**
+
+* ``<true_or_false>``: |bool-input|
+
 .. _warnings-command-warnreason:
 
 ^^^^^^^^^^

docs/conf.py

@@ -44,8 +44,11 @@ extensions = [
     "sphinx.ext.napoleon",
     "sphinx.ext.doctest",
     "sphinxcontrib_trio",
+    "sphinx_markdown_builder",
     "sphinx-prompt",
+    "changelog_contributors",
     "deprecated_removed",
+    "prompt_builder",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -229,6 +232,14 @@ linkcheck_ignore = [r"https://java.com*", r"https://chocolatey.org*"]
 linkcheck_retries = 3
 
 
+# -- Options for markdown builder ----------------------------------------
+
+markdown_http_base = os.environ.get(
+    "READTHEDOCS_CANONICAL_URL", "https://docs.discord.red/en/stable"
+)
+markdown_uri_doc_suffix = ".html"
+
+
 # -- Options for extensions -----------------------------------------------
 
 if dpy_version_info.releaselevel == "final":

docs/framework_bank.rst

@@ -7,9 +7,6 @@
 Bank
 ====
 
-Bank has now been separated from Economy for V3. New to bank is support for
-having a global bank.
-
 ***********
 Basic Usage
 ***********

docs/framework_bot.rst

@@ -9,7 +9,7 @@ Bot
 Red
 ^^^
 
-.. autoclass:: Red
+.. autoclass:: Red()
     :members:
     :exclude-members: get_context, get_embed_color
 

docs/framework_config.rst

@@ -155,6 +155,22 @@ Here is an example of the :code:`async with` syntax:
             blah.append(new_blah)
         await ctx.send("The new blah value has been added!")
 
+There is also a :py:meth:`Group.all` method. This will return all the stored data associated
+with a specific config group as a :py:class:`dict`. By negating the need to excessively call config,
+this method can be particularly useful when multiple values are to be retrieved from the same group.
+
+Here is an example of :py:meth:`Group.all` usage:
+
+.. code-block:: python
+
+    @commands.command()
+    async def getall(self, ctx):
+        all_global_data = await self.config.all()
+        await ctx.send("Foobar is {foobar}, foo baz is {foo_baz}".format(
+            foobar=str(all_global_data["foobar"]),
+            foo_baz=str(all_global_data["foo"]["baz"])
+        ))
+
 
 .. important::
 
@@ -398,7 +414,7 @@ We're responsible pet owners here, so we've also got to have a way to feed our p
             # We could accomplish the same thing a slightly different way
             await self.config.user(ctx.author).pets.get_attr(pet_name).hunger.set(new_hunger)
 
-            await ctx.send("Your pet is now at {}/100 hunger!".format(new_hunger)
+            await ctx.send("Your pet is now at {}/100 hunger!".format(new_hunger))
 
 Of course, if we're less than responsible pet owners, there are consequences::
 
@@ -430,49 +446,6 @@ Of course, if we're less than responsible pet owners, there are consequences::
                 "how poorly it was taken care of."
             )
 
-
-*************
-V2 Data Usage
-*************
-There has been much conversation on how to bring V2 data into V3 and, officially, we recommend that cog developers
-make use of the public interface in Config (using the categories as described in these docs) rather than simply
-copying and pasting your V2 data into V3. Using Config as recommended will result in a much better experience for
-you in the long run and will simplify cog creation and maintenance.
-
-However.
-
-We realize that many of our cog creators have expressed disinterest in writing converters for V2 to V3 style data.
-As a result we have opened up config to take standard V2 data and allow cog developers to manipulate it in V3 in
-much the same way they would in V2. The following examples will demonstrate how to accomplish this.
-
-.. warning::
-
-    By following this method to use V2 data in V3 you may be at risk of data corruption if your cog is used on a bot
-    with multiple shards. USE AT YOUR OWN RISK.
-
-.. code-block:: python
-
-    from redbot.core import Config, commands
-
-
-    class ExampleCog(commands.Cog):
-        def __init__(self):
-            self.config = Config.get_conf(self, 1234567890)
-            self.config.init_custom("V2", 1)
-            self.data = {}
-
-        async def load_data(self):
-            self.data = await self.config.custom("V2", "V2").all()
-
-        async def save_data(self):
-            await self.config.custom("V2", "V2").set(self.data)
-
-
-    async def setup(bot):
-        cog = ExampleCog()
-        await cog.load_data()
-        await bot.add_cog(cog)
-
 ************************************
 Best practices and performance notes
 ************************************
@@ -481,7 +454,7 @@ Config prioritizes being a safe data store without developers needing to
 know how end users have configured their bot. 
 
 This does come with some performance costs, so keep the following in mind when choosing to
-develop using config
+develop using config.
 
 * Config use in events should be kept minimal and should only occur
   after confirming the event needs to interact with config

docs/framework_i18n.rst

@@ -14,36 +14,96 @@ Basic Usage
 .. code-block:: python
 
     from redbot.core import commands
-    from redbot.core.i18n import Translator, cog_i18n
+    from redbot.core.i18n import Translator, cog_i18n, set_contextual_locales_from_guild
     
+    # The translator should be defined in the module scope, with __file__ as the second parameter
     _ = Translator("ExampleCog", __file__)
 
+    # This decorator must be used for cog and command docstrings to be translated!
     @cog_i18n(_)
-    class ExampleCog:
-        """description"""
+    class ExampleCog(commands.Cog):
+        """Cog description"""
+        def __init__(self, bot):
+            self.bot = bot
 
         @commands.command()
         async def mycom(self, ctx):
-            """command description"""
-            await ctx.send(_("This is a test command"))
+            """Command description"""
+            # Correct way to translate strings:
+            await ctx.send(_("This is a test command run by {author}!").format(author=ctx.author.display_name))
+
+            # !!! Do not do this - String interpolation should happen after translation
+            await ctx.send(_("This is a test command run by {author}!".format(author=ctx.author.display_name)))
+
+            # !!! Do not use f-strings - String interpolation should happen after translation
+            await ctx.send(_(f"This is a test command run by {ctx.author.display_name}!"))
+        
+        @commands.Cog.listener()
+        async def on_message(self, message):
+            # In non-command locations, you must manually call this method for guild locale settings to apply
+            await set_contextual_locales_from_guild(self.bot, message.guild)
+            if message.author.bot:
+                return
+            await message.channel.send(_("This is a non command with translation support!"))
 
 --------
 Tutorial
 --------
 
-After making your cog, generate a :code:`messages.pot` file
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Preparing your cog for translations
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-We recommend using redgettext - a modified version of pygettext for Red.
-You can install redgettext by running :code:`pip install redgettext` in a command prompt.
+The first step to adding translations to your cog is to add Red's internationalization framework
+to the strings in your cog. The first step is to instantiate an instance of
+`redbot.core.i18n.Translator` just after the imports in each file. This object is traditionally 
+stored in the variable ``_`` to reduce its character count and visual impact on the code. Next,
+add the `redbot.core.i18n.cog_i18n` decorator to your cog class. This will allow docstrings of
+the class and its commands to be translated. Every user-facing string that is not a docstring
+should then be wrapped by the Translator object. If variables are included in a string,
+``.format()`` must be used, and should be called after the translation function call. This is
+because ``.format()`` within the translation function call and f-strings cause the interpolation
+to happen **before** the translation is applied. The translation logic needs to match the template
+string to translate it, and will be unable to successfully match after interpolation occurs.
+Finally, any non-command portions of your code, including listeners, tasks, and views, should call
+`redbot.core.i18n.set_contextual_locales_from_guild` prior to translating any strings, as only
+commands are able to implicitly determine which guild's configured locale to use. See the example
+above for the exact recommended syntax.
+
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Generating a messages.pot file
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+A ``messages.pot`` file is a template for translating all of the strings in your cog. It should
+be generated using ``redgettext`` - a modified version of ``pygettext`` for use with Red cogs.
+You can install ``redgettext`` by running :code:`pip install redgettext` in your development
+environment.
+
+Once you have ``redgettext`` installed, you will now need to run
+
+:code:`python -m redgettext -c [path_to_cog_folder]`
+
+This will generate a ``messages.pot`` file in ``path_to_cog_folder/locales``. This file will
+contain all strings to be translated, including docstrings.
 
-To generate the :code:`messages.pot` file, you will now need to run
-:code:`python -m redgettext -c [path_to_cog]`
-This file will contain all strings to be translated, including
-docstrings.
 (For advanced usage check :code:`python -m redgettext -h`)
 
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Creating language specific translations
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
 You can now use a tool like `poedit
-<https://poedit.net/>`_ to translate the strings in your messages.pot file.
+<https://poedit.net/>`_ to translate the strings in your ``messages.pot`` file.
+
+Alternatively, you can use any text editor to manually create translations. To do this, first
+create a copy of the ``messages.pot`` file in the same folder, and name the copy
+``LANGUAGE-CODE.po``, where ``LANGUAGE-CODE`` is a five character language code supported by
+``[p]set locale``. Open the copy in your text editor of choice. This file contains the strings
+in your cog prefixed by ``msgid`` and an empty string for you to apply translations prefixed by
+``msgstr``. The original string should be translated to the target language by modifying the
+associated ``msgstr``. Any variables within curly braces should **not** be translated to avoid
+breaking the code when translations are applied. If keyword arguments were used in ``.format()``
+calls, it may be safe to re-order variables if the grammer of the language requires doing so.
 
 -------------
 API Reference
@@ -51,4 +111,4 @@ API Reference
 
 .. automodule:: redbot.core.i18n
     :members:
-    :special-members: __call__
+    :special-members: __call__, __init__

docs/framework_modlog.rst

@@ -8,8 +8,6 @@
 Mod log
 =======
 
-Mod log has now been separated from Mod for V3.
-
 ***********
 Basic Usage
 ***********

docs/framework_rpc.rst

@@ -9,7 +9,7 @@ RPC
   RPC support is included in Red on a `provisional <developer-guarantees-exclusions>` basis.
   Backwards incompatible changes (up to and including removal of the RPC) may occur if deemed necessary.
 
-V3 comes default with an internal RPC server that may be used to remotely control the bot in various ways.
+Red comes default with an internal RPC server that may be used to remotely control the bot in various ways.
 Cogs must register functions to be exposed to RPC clients.
 Each of those functions must only take JSON serializable parameters and must return JSON serializable objects.
 

docs/guide_cog_creation.rst

@@ -3,11 +3,11 @@
 .. role:: python(code)
     :language: python
 
-========================
-Creating cogs for Red V3
-========================
+=====================
+Creating cogs for Red
+=====================
 
-This guide serves as a tutorial on creating cogs for Red V3.
+This guide serves as a tutorial on creating cogs for Red.
 It will cover the basics of setting up a package for your
 cog and the basics of setting up the file structure. We will
 also point you towards some further resources that may assist
@@ -111,8 +111,8 @@ Make sure that both files are saved.
 Testing your cog
 ----------------
 
-To test your cog, you will need a running instance of V3.
-Assuming you installed V3 as outlined above, run :code:`redbot-setup`
+To test your cog, you will need a running instance of Red.
+Assuming you installed Red as outlined above, run :code:`redbot-setup`
 and provide the requested information. Once that's done, run Red
 by doing :code:`redbot <instance name> --dev` to start Red.
 Complete the initial setup by providing a valid token and setting a
@@ -169,6 +169,4 @@ Becoming an Approved Cog Creator
 Additional resources
 --------------------
 
-Be sure to check out the :doc:`/guide_migration` for some resources
-on developing cogs for V3. This will also cover differences between V2 and V3 for
-those who developed cogs for V2.
+If you've developed cogs for V2, you might find `incompatible_changes/v2_migration` document helpful.

docs/guide_publish_cogs.rst

@@ -1,7 +1,7 @@
 .. Publishing cogs for V3
 
-Publishing cogs for Red V3
-==========================
+Publishing cogs for Red
+=======================
 
 Users of Red install 3rd-party cogs using Downloader cog. To make your cog available
 to install for others, you will have to create a git repository
@@ -47,7 +47,7 @@ Keys common to both repo and cog info.json (case sensitive)
   is installed or a repo is added
   
   .. tip:: You can use the ``[p]`` key in your string to use the prefix
-      used for installing.
+      used for installing, and ``[botname]`` to show the bot's username.
 
 - ``short`` (string) - A short description of the cog or repo. For cogs, this info 
   is displayed when a user executes ``[p]cog list``

docs/host-list.rst

@@ -32,12 +32,11 @@ First, we would like to make something clear:
 Hosting on a VPS or Dedicated Server
 ------------------------------------
 
-| You can host Red in a VPS running Linux or Windows. Using a Linux VPS is the
+| You can host Red on a VPS running Linux or Windows. Using a Linux VPS is the
   recommended option. Dedicated servers also work but are overpowered and cost 
   ineffective unless one plans to run a very large bot or use their server for 
   more than just hosting Red. If you have already created an instance, Red can be moved to a different 
-  server for hosting with a backup/restore process. More information and guidance
-  about this process is available in the `Red Support Server <https://discord.com/invite/red>`_.
+  server for hosting using the :doc:`backup/restore process </backup_red>`.
 
 .. warning::
     Please be aware that a Linux server is controlled through a command line.
@@ -87,7 +86,7 @@ Average Providers
 | `OVH <https://us.ovhcloud.com/vps/>`_ is a company focused on providing hosting
  and cloud services with locations in Europe, North America and Asia Pacific.
 
-| `Time4VPS <https://www.time4vps.eu/>`_ is a Lithuanian VPS provider mainly focused
+| `Time4VPS <https://www.time4vps.com/>`_ is a Lithuanian VPS provider mainly focused
  on lower cost.
 
 | `GalaxyGate <https://galaxygate.net/>`_ is a VPS and dedicated server provider
@@ -114,7 +113,7 @@ Average Providers
 | `LowEndBox <http://lowendbox.com/>`_ is a website where hosting providers are
  discussed and curated, often with lower costs and less known providers.
 
-| `AlphaVps <https://alphavps.com>`_ is a Bulgaria VPS and dedicated server provider 
+| `AlphaVps <https://alphavps.com>`_ is a Bulgarian VPS and dedicated server provider 
  with locations in Los Angeles, New York, England, Germany and Bulgaria.
 
 --------------------

docs/incompatible_changes/index.rst

@@ -10,3 +10,4 @@ Backward incompatible changes
 
    future
    3.5
+   v2_migration

docs/incompatible_changes/v2_migration.rst

@@ -38,6 +38,49 @@ per-server/member/user/role/channel or global basis. Be sure to check
 out :doc:`/framework_config` for the API docs for Config as well as a
 tutorial on using Config.
 
+*************
+V2 Data Usage
+*************
+
+There has been much conversation on how to bring V2 data into V3 and, officially, we recommend that cog developers
+make use of the public interface in Config (using the categories as described in these docs) rather than simply
+copying and pasting your V2 data into V3. Using Config as recommended will result in a much better experience for
+you in the long run and will simplify cog creation and maintenance.
+
+However.
+
+We realize that many of our cog creators have expressed disinterest in writing converters for V2 to V3 style data.
+As a result we have opened up config to take standard V2 data and allow cog developers to manipulate it in V3 in
+much the same way they would in V2. The following examples will demonstrate how to accomplish this.
+
+.. warning::
+
+    By following this method to use V2 data in V3 you may be at risk of data corruption if your cog is used on a bot
+    with multiple shards. USE AT YOUR OWN RISK.
+
+.. code-block:: python
+
+    from redbot.core import Config, commands
+
+
+    class ExampleCog(commands.Cog):
+        def __init__(self):
+            self.config = Config.get_conf(self, 1234567890)
+            self.config.init_custom("V2", 1)
+            self.data = {}
+
+        async def load_data(self):
+            self.data = await self.config.custom("V2", "V2").all()
+
+        async def save_data(self):
+            await self.config.custom("V2", "V2").set(self.data)
+
+
+    async def setup(bot):
+        cog = ExampleCog()
+        await cog.load_data()
+        await bot.add_cog(cog)
+
 ----
 Bank
 ----

docs/index.rst

@@ -15,6 +15,7 @@ Welcome to Red - Discord Bot's documentation!
     install_guides/index
     bot_application_guide
     update_red
+    backup_red
     about_venv
     autostart_windows
     autostart_mac
@@ -61,7 +62,6 @@ Welcome to Red - Discord Bot's documentation!
     :maxdepth: 2
     :caption: Red Development Framework Reference:
 
-    guide_migration
     guide_cog_creation
     guide_slash_and_interactions
     guide_publish_cogs

docs/install_guides/_includes/install-and-setup-red-unix.rst

@@ -8,6 +8,7 @@ To install without additional config backend support:
 
 .. prompt:: bash
     :prompts: (redenv) $
+    :modifiers: red-install-guide-install-normal
 
     python -m pip install -U pip wheel
     python -m pip install -U Red-DiscordBot
@@ -16,6 +17,7 @@ Or, to install with PostgreSQL support:
 
 .. prompt:: bash
     :prompts: (redenv) $
+    :modifiers: red-install-guide-install-postgres
 
     python -m pip install -U pip wheel
     python -m pip install -U "Red-DiscordBot[postgres]"
@@ -29,6 +31,7 @@ After installation, set up your instance with the following command:
 
 .. prompt:: bash
     :prompts: (redenv) $
+    :modifiers: red-install-guide-setup
 
     redbot-setup
 
@@ -40,6 +43,7 @@ Once done setting up the instance, run the following command to run Red:
 
 .. prompt:: bash
     :prompts: (redenv) $
+    :modifiers: red-install-guide-run
 
     redbot <your instance name>
 

docs/install_guides/_includes/install-guide-rhel8-derivatives.rst

@@ -6,7 +6,7 @@
 Installing the pre-requirements
 -------------------------------
 
-Red Hat Enterprise Linux (RHEL) 8.8-8.x and its derivatives have all required packages available in official repositories.
+Red Hat Enterprise Linux (RHEL) 8.10 and its derivatives have all required packages available in official repositories.
 Install them with dnf:
 
 .. prompt:: bash

docs/install_guides/_includes/install-guide-rhel9-derivatives.rst

@@ -6,7 +6,7 @@
 Installing the pre-requirements
 -------------------------------
 
-Red Hat Enterprise Linux (RHEL) 9.2-9.x and its derivatives have all required packages available in official repositories.
+Red Hat Enterprise Linux (RHEL) 9.4-9.x and its derivatives have all required packages available in official repositories.
 Install them with dnf:
 
 .. prompt:: bash

docs/install_guides/_includes/linux-preamble.rst

@@ -2,4 +2,4 @@
 
     For safety reasons, DO NOT install Red with a root user. If you are unsure how to create
     a new user on Linux, see `DigitalOcean's tutorial: How To Create a New Sudo-enabled User
-    <https://www.digitalocean.com/community/tutorials/how-to-create-a-new-sudo-enabled-user-on-ubuntu-20-04-quickstart>`_.
+    <https://www.digitalocean.com/community/tutorials/how-to-create-a-new-sudo-enabled-user-on-ubuntu>`_.

docs/install_guides/fedora.rst

@@ -12,12 +12,14 @@ Installing Red on Fedora Linux
 Installing the pre-requirements
 -------------------------------
 
-Fedora Linux 40 and above has all required packages available in official repositories. Install
+Fedora Linux 42 and above has all required packages available in official repositories. Install
 them with dnf:
 
 .. prompt:: bash
 
-    sudo dnf -y install python3.11 python3.11-devel git java-17-openjdk-headless @development-tools nano
+    sudo dnf -y install python3.11 python3.11-devel git adoptium-temurin-java-repository @development-tools nano
+    sudo dnf config-manager setopt adoptium-temurin-java-repository.enabled=1
+    sudo dnf -y install temurin-17-jre
 
 .. Include common instructions:
 

docs/install_guides/index.rst

@@ -24,13 +24,11 @@ we recommend **Ubuntu 24.04 LTS**.
    opensuse-tumbleweed
    oracle-linux-8
    oracle-linux-9
-   raspberry-pi-os-11
    raspberry-pi-os-12
    rhel-8
    rhel-9
    rocky-linux-8
    rocky-linux-9
-   ubuntu-2004
    ubuntu-2204
    ubuntu-2404
    ubuntu-non-lts

docs/install_guides/raspberry-pi-os-11.rst

@@ -1,44 +0,0 @@
-.. _install-raspberry-pi-os-11:
-
-======================================================
-Installing Red on Raspberry Pi OS (Legacy) 11 Bullseye
-======================================================
-
-.. include:: _includes/supported-arch-aarch64+armv7l.rst
-
-.. note::
-
-    While we do provide support and install instructions for running Red
-    on Raspberry Pi OS (Legacy) 11 Bullseye, we highly recommend installing/upgrading to
-    the new version - Raspberry Pi OS 12 Bookworm.
-
-    If you're not sure what version you are using,
-    you can check your version of Raspberry Pi OS by running:
-
-    .. prompt:: bash
-
-        lsb_release -a
-
-    If you're running Bookworm already, read `install-raspberry-pi-os-12` document instead.
-
-    If you're using Bullseye, please consider performing a clean install of Bookworm if possible.
-
-.. include:: _includes/linux-preamble.rst
-
--------------------------------
-Installing the pre-requirements
--------------------------------
-
-Raspberry Pi OS "Bullseye" has all required packages available in official repositories. Install them
-with apt:
-
-.. prompt:: bash
-
-    sudo apt update
-    sudo apt -y install python3 python3-dev python3-venv git openjdk-17-jre-headless build-essential nano
-
-.. Include common instructions:
-
-.. include:: _includes/create-env-with-venv3.9.rst
-
-.. include:: _includes/install-and-setup-red-unix.rst

docs/install_guides/raspberry-pi-os-12.rst

@@ -1,8 +1,8 @@
 .. _install-raspberry-pi-os-12:
 
-=============================================
-Installing Red on Raspberry Pi OS 12 Bookworm
-=============================================
+======================================================
+Installing Red on Raspberry Pi OS (Legacy) 12 Bookworm
+======================================================
 
 .. include:: _includes/supported-arch-aarch64+armv7l.rst
 

docs/install_guides/rhel-8.rst

@@ -1,7 +1,7 @@
 .. _install-rhel-8:
 
-=========================================================
-Installing Red on Red Hat Enterprise Linux (RHEL) 8.8-8.x
-=========================================================
+======================================================
+Installing Red on Red Hat Enterprise Linux (RHEL) 8.10
+======================================================
 
 .. include:: _includes/install-guide-rhel8-derivatives.rst

docs/install_guides/rhel-9.rst

@@ -1,7 +1,7 @@
 .. _install-rhel-9:
 
 =========================================================
-Installing Red on Red Hat Enterprise Linux (RHEL) 9.2-9.x
+Installing Red on Red Hat Enterprise Linux (RHEL) 9.4-9.x
 =========================================================
 
 .. include:: _includes/install-guide-rhel9-derivatives.rst

docs/install_guides/ubuntu-2004.rst

@@ -1,27 +0,0 @@
-.. _install-ubuntu-2004:
-
-==================================
-Installing Red on Ubuntu 20.04 LTS
-==================================
-
-.. include:: _includes/supported-arch-x64+aarch64.rst
-
-.. include:: _includes/linux-preamble.rst
-
--------------------------------
-Installing the pre-requirements
--------------------------------
-
-Ubuntu 20.04 LTS has all required packages available in official repositories. Install them
-with apt:
-
-.. prompt:: bash
-
-    sudo apt update
-    sudo apt -y install python3.9 python3.9-dev python3.9-venv git openjdk-17-jre-headless build-essential nano
-
-.. Include common instructions:
-
-.. include:: _includes/create-env-with-venv3.9.rst
-
-.. include:: _includes/install-and-setup-red-unix.rst

docs/install_guides/windows.rst

@@ -133,6 +133,7 @@ Run **one** of the following set of commands, depending on what extras you want
 
     .. prompt:: batch
         :prompts: (redenv) C:\\>
+        :modifiers: red-install-guide-install-normal
 
         python -m pip install -U pip wheel
         python -m pip install -U Red-DiscordBot
@@ -141,6 +142,7 @@ Run **one** of the following set of commands, depending on what extras you want
 
     .. prompt:: batch
         :prompts: (redenv) C:\\>
+        :modifiers: red-install-guide-install-postgres
 
         python -m pip install -U pip wheel
         python -m pip install -U Red-DiscordBot[postgres]
@@ -153,6 +155,7 @@ After installation, set up your instance with the following command:
 
 .. prompt:: batch
     :prompts: (redenv) C:\\>
+    :modifiers: red-install-guide-setup
 
     redbot-setup
 
@@ -164,6 +167,7 @@ Once done setting up the instance, run the following command to run Red:
 
 .. prompt:: batch
     :prompts: (redenv) C:\\>
+    :modifiers: red-install-guide-run
 
     redbot <your instance name>
 

docs/intents.rst

@@ -8,40 +8,20 @@ About (privileged) intents and public bots
 ==========================================
 
 This page aims to explain Red's current intents requirements,
-our stance regarding "public bots" and the impact of some announced
-Discord changes coming in April 2022.
+our stance regarding "public bots", and the discord bot verification process.
 
 To clarify:
 
 - **Small bots** are bots under 100 servers. They currently do not need to undergo Discord's
   bot verification process
 - **Public bots** (or big bots) are bots that have reached 100 servers. They need to be
-  `verified <https://support.discord.com/hc/en-us/articles/360040720412-Bot-Verification-and-Data-Whitelisting>`_
+  `verified <https://support-dev.discord.com/hc/en-us/articles/23926564536471-How-Do-I-Get-My-App-Verified>`_
   by Discord to join more than 100 servers and gain privileged intents
 
 .. warning::
 
   It is **very** important that you fully read this page if you're the owner of a public bot or strive to scale your bot at that level.
 
-.. _intents-intents:
-
--------
-Intents
--------
-
-Red currently requires **all intents** to be active in order to function properly.
-
-The reason for this requirement is that there are some technical challenges that need
-to be overcome before we're able to adapt Red to function with only *some* intents:
-these challenges are mainly due to the modular / extensible nature of Red and the fact
-that Red has a long history (dating back to 2016!), making big changes naturally slower
-to happen. In comparison, intents have been introduced fairly recently. |br|
-This is not a problem if you have a small bot: you can simply go to the
-`Discord development portal <https://discord.com/developers/applications/me>`_
-and enable them. However, if you have a public bot Discord will want you to attain
-verified status: you should read :ref:`our stance regarding public bots <intents-public-bots>`
-and our guidelines for the :ref:`verification process <intents-bot-verification-process>`.
-
 .. _intents-public-bots:
 
 -----------
@@ -54,8 +34,10 @@ Red was designed with one single goal in mind: a bot that you can host on your o
 and customize to your needs, making it really *your* bot. **The target audience of Red are server
 owners with a few servers**, often with specific needs that can be covered by the vast cog ecosystem
 that the community has built over the years. |br| Red was never built with big bots in mind,
-bots with thousands upon thousands of servers: these bots face unique challenges.
-Such Red instances *do exist*, it is not impossible to adapt Red and meet those criteria,
+bots with thousands upon thousands of servers: these bots face unique challenges. Large bots need
+to be extremely efficient to handle the large amount of requests they receive, and often need to
+distribute this work across multiple processes or machines to keep up.
+Such Red instances *do exist*, and it is not impossible to adapt Red and meet those criteria,
 but it requires work and bot owners with the technical knowledge to make it happen.
 It is **not** something that we support. |br|
 When your bot reaches the public bot scale and it is therefore required to be verified it
@@ -75,8 +57,8 @@ the verification process.
 
 Regardless of our stance, we do feel the need to give some pointers: many bot owners reach this point
 and become fairly lost, as they've simply been *users* so far.
-They have installed their bot, some cogs, personalized it, yadda yadda. Again, they have been users,
-not developers. Unless they also have an interest in development, they will likely not have a clue about
+They have installed their bot, some cogs, personalized it, but have not needed to write any code.
+Unless they also have an interest in development, they will likely not have a clue about
 what's going under the hood, much like you're not expected to be a mechanic to drive your car. And there's
 nothing wrong with that! Red has been designed to be as user friendly as possible. |br|
 The problem is this: Red is an outlier. Discord has built the bot verification process with the expectation
@@ -94,41 +76,44 @@ out your application:
   of people that in their naivety went with the bad answer and it seems that at this point merely mentioning Red
   is a guaranteed way to have your application rejected.
 
-.. _intents-slash-commands:
+.. _intents-intents:
 
----------------------------------
-Message intent and slash commands
----------------------------------
+-------
+Intents
+-------
 
-.. warning::
+Red expects **all intents** to be active. It is possible, but not recommended, to disable
+specific intents using the ``--disable-intent`` flag. If an intent is missing, you may
+experience errors due to Red expecting information provided by the intent to be present.
 
-  If you own a public bot it is extremely important that you read this section.
+Discord currently considers 3 intents to be
+`privileged <https://support-dev.discord.com/hc/en-us/articles/6205754771351-How-do-I-get-Privileged-Intents-for-my-bot>`_,
+and requires large bots to additionally apply for access to these intents. **If you have a small
+bot**, you can simply follow :ref:`these instructions <enabling-privileged-intents>` to enable them.
 
-Discord has announced that **starting April 2022** the content of users' messages
-`will be "locked" behind message intent <https://support-dev.discord.com/hc/en-us/articles/4404772028055>`_ |br|
-If you're the owner of a small bot, fear not, this is yet another box that you have to tick from the
-`Discord development portal <https://discord.com/developers/applications/me>`_. |br|
-But if you're the owner of a public bot, things might be a lot less pleasant.
+A breakdown of how privileged intents are used in Red is provided below.
 
-To recap, unless you have
-message intent, you will only receive message content for:
+The **Message Content** intent is required to use text based commands and inputs for
+configuration and all built in functionality. App commands (also known as slash commands)
+are limited to a total of 100 top level commands, which is difficult to manage on
+a modular bot. The approach we have taken to address this issue is to allow 3rd party
+cogs to provide slash commands, but require bot owners to pick which slash commands
+they actually want to use with the ``[p]slash`` command.
+Under this system, bot management commands that are not exposed to users are still
+expected to be provided as text commands, which requires the bot to be able to access
+message content. There are no current plans to provide slash versions of core commands.
 
-- Messages that your bot sends
-- Messages that your bot receives in DM
-- Messages in which your bot is mentioned
+.. note::
+  It is possible to work around this intent by using the ``--mentionable``
+  flag, and using the bot mention as a prefix to use text based commands.
 
-In case it's not clear by now, your bot needs message content to parse (see) the commands it receives. And if
-you don't attain message intent, your bot will not be able to... well, do anything. |br|
-The *bandaid fix* is for you to change your bot's prefix to a mention and a good portion of your commands will likely
-still work. You will however lose many functions, namely anything that relies on seeing message content to act. |br|
-The more *proper fix* is also not easy. You will need to justify your need for the message intent to Discord and
-they will only accept "compelling use cases".
-`It is not known what those even entail <https://gist.github.com/spiralw/091714718718379b6efcdbcaf807a024#q-what-usecases-will-be-valid>`_ at this point, but they have already stated that "parsing commands" is not a valid justification. |br|
-To make the matter worse, Discord is making `a huge push for all bot developers to implement slash commands <https://support.discord.com/hc/en-us/articles/1500000368501-Slash-Commands-FAQ>`_, which at the moment
-are rather lacking in features and cannot cover all the functionalities that standard commands offer. |br|
-Discord staff
-`stated that they will want your bot to have slash commands when you ask for message intent <https://gist.github.com/spiralw/091714718718379b6efcdbcaf807a024#q-if-we-are-granted-this-intent-will-bots-be-sanctioned-if-they-use-it-for-their-own-use-case-but-also-to-continue-to-run-normal-non-slash-commands-or-do-we-assume-that-if-you-are-granted-the-intent-you-are-trusted-with-it-and-are-allowed-to-use-it-for-additional-uses>`_. |br|
-Slash commands might very well turn out to be a big undertaking for the Red team to implement, even more now that our
-underlying library, `discord.py <https://github.com/Rapptz/discord.py>`_, has been discontinued. |br|
-The time window that Discord is giving us to adapt is very narrow: **Red will likely not be able to support slash
-commands for April 2022** and you should plan accordingly.
+The **Guild Members** intent is required to properly cache member information, including
+what users are in each server, what roles they have, what their name is, etc. It is also
+required to receive events corresponding to when members join or leave a server, and when
+they change their nickname or other server options. Almost all cogs expect to be able
+to reference the member cache in order to avoid making API requests, and are not set
+up to check if the intent is present before doing so.
+
+The **Guild Presences** intent is required to view the activities and status of
+users. Cogs which perform actions on users based on their activity or status will
+be unable to access this information if this intent is not enabled.

docs/update_red.rst

@@ -108,7 +108,6 @@ If you have a Red version between 3.2.0 and 3.4.19, you can upgrade by following
     #. Start your bot with ``--no-cogs --load-cogs downloader`` flags, for example:
 
         .. prompt:: batch
-
             :prompts: (redenv) C:\\>
 
             redbot <your instance name> --no-cogs --load-cogs downloader

docs/version_guarantees.rst

@@ -50,34 +50,31 @@ their end-of-life date.
 ================================   =======================   ============================================================
 Operating system version           Supported architectures   Ideally supported until
 ================================   =======================   ============================================================
-Windows 10                         x86-64                    2025-10-14 (`End/Retirement Date <https://docs.microsoft.com/en-us/lifecycle/products/windows-10-home-and-pro>`__)
+Windows 10                         x86-64                    2026-10-13 (`End of Consumer Extended Security Updates (ESU) program <https://www.microsoft.com/en-us/windows/extended-security-updates>`__)
 Windows 11                         x86-64                    `Retirement Date <https://docs.microsoft.com/en-us/lifecycle/products/windows-11-home-and-pro-version-21h2>`__
-macOS 13 (Ventura)                 x86-64, aarch64           ~2025-10
 macOS 14 (Sonoma)                  x86-64, aarch64           ~2026-10
 macOS 15 (Sequoia)                 x86-64, aarch64           ~2027-10
-Alma Linux 8                       x86-64, aarch64           2029-05-31 (`How long will CloudLinux support AlmaLinux? <https://wiki.almalinux.org/FAQ.html#how-long-will-almalinux-be-supported>`__)
-Alma Linux 9                       x86-64, aarch64           2032-05-31
+macOS 26 (Tahoe)                   x86-64, aarch64           ~2028-10
+Alma Linux 8                       x86-64, aarch64           2029-05-31 (`security support <https://wiki.almalinux.org/release-notes/>`__)
+Alma Linux 9                       x86-64, aarch64           2032-05-31 (`security support <https://wiki.almalinux.org/release-notes/>`__)
 Amazon Linux 2023                  x86-64, aarch64           2028-03-15 (`end-of-life <https://docs.aws.amazon.com/linux/al2023/release-notes/support-info-by-support-statement.html#support-info-by-support-statement-eol>`__)
 Arch Linux                         x86-64                    forever (support is only provided for an up-to-date system)
-CentOS Stream 9                    x86-64, aarch64           2027-05-31 (`expected EOL <https://centos.org/stream9/#timeline>`__)
-Debian 12 Bookworm                 x86-64, aarch64, armv7l   ~2026-09 (`End of life <https://wiki.debian.org/DebianReleases#Production_Releases>`__)
-Fedora Linux 40                    x86-64, aarch64           2025-05-28 (`End of Life <https://docs.fedoraproject.org/en-US/releases/lifecycle/#_maintenance_schedule>`__)
-Fedora Linux 41                    x86-64, aarch64           2025-11-19 (`End of Life <https://docs.fedoraproject.org/en-US/releases/lifecycle/#_maintenance_schedule>`__)
-openSUSE Leap 15.6                 x86-64, aarch64           2025-12-31 (`end of maintenance life cycle <https://en.opensuse.org/Lifetime#openSUSE_Leap>`__)
+CentOS Stream 9                    x86-64, aarch64           2027-05-31 (`Expected EOL <https://centos.org/stream9/#timeline>`__)
+Debian 12 Bookworm                 x86-64, aarch64, armv7l   2026-06-10 (`End of life <https://wiki.debian.org/DebianReleases#Production_Releases>`__)
+Fedora Linux 42                    x86-64, aarch64           2026-05-13 (`End of Life <https://fedorapeople.org/groups/schedule/f-42/f-42-key-tasks.html>`__)
+Fedora Linux 43                    x86-64, aarch64           2026-12-09 (`End of Life <https://fedorapeople.org/groups/schedule/f-43/f-43-key-tasks.html>`__)
+openSUSE Leap 15.6                 x86-64, aarch64           2025-12-31 (`end of maintenance lifecycle <https://en.opensuse.org/Lifetime#openSUSE_Leap>`__)
 openSUSE Tumbleweed                x86-64, aarch64           forever (support is only provided for an up-to-date system)
 Oracle Linux 8                     x86-64, aarch64           2029-07-31 (`End of Premier Support <https://www.oracle.com/us/support/library/elsp-lifetime-069338.pdf>`__)
 Oracle Linux 9                     x86-64, aarch64           2032-06-31 (`End of Premier Support <https://www.oracle.com/us/support/library/elsp-lifetime-069338.pdf>`__)
-Raspberry Pi OS (Legacy) 11        armv7l                    ~2025-10 (approximate date of release of Raspberry Pi OS 13)
-Raspberry Pi OS 12                 aarch64, armv7l           ~2025-10 (approximate date of release of Raspberry Pi OS 13)
+Raspberry Pi OS (Legacy) 12        aarch64, armv7l           ~2027-10 (approximate date of release of Raspberry Pi OS 14)
 RHEL 8 (latest)                    x86-64, aarch64           2029-05-31 (`End of Maintenance Support <https://access.redhat.com/support/policy/updates/errata#Life_Cycle_Dates>`__)
-RHEL 8.8                           x86-64, aarch64           2025-05-31 (`End of Extended Update Support <https://access.redhat.com/support/policy/updates/errata#Extended_Update_Support>`__)
 RHEL 8.10                          x86-64, aarch64           2029-05-31 (`End of Extended Update Support <https://access.redhat.com/support/policy/updates/errata#Extended_Update_Support>`__)
 RHEL 9 (latest)                    x86-64, aarch64           2032-05-31 (`End of Maintenance Support <https://access.redhat.com/support/policy/updates/errata#Life_Cycle_Dates>`__)
-RHEL 9.2                           x86-64, aarch64           2025-05-31 (`End of Extended Update Support <https://access.redhat.com/support/policy/updates/errata#Extended_Update_Support>`__)
 RHEL 9.4                           x86-64, aarch64           2026-04-30 (`End of Extended Update Support <https://access.redhat.com/support/policy/updates/errata#Extended_Update_Support>`__)
-Rocky Linux 8                      x86-64, aarch64           2029-05-31 (`end-of-life <https://rockylinux.org/download/>`__)
-Rocky Linux 9                      x86-64, aarch64           2032-05-31 (`end-of-life <https://rockylinux.org/download/>`__)
-Ubuntu 20.04 LTS                   x86-64, aarch64           2025-06-30 (`End of Standard Support <https://wiki.ubuntu.com/Releases#Current>`__)
+RHEL 9.6                           x86-64, aarch64           2027-05-31 (`End of Extended Update Support <https://access.redhat.com/support/policy/updates/errata#Extended_Update_Support>`__)
+Rocky Linux 8                      x86-64, aarch64           2029-05-31 (`End of Life <https://wiki.rockylinux.org/rocky/version/>`__)
+Rocky Linux 9                      x86-64, aarch64           2032-05-31 (`End of Life <https://wiki.rockylinux.org/rocky/version/>`__)
 Ubuntu 22.04 LTS                   x86-64, aarch64           2027-06-30 (`End of Standard Support <https://wiki.ubuntu.com/Releases#Current>`__)
 Ubuntu 24.04 LTS                   x86-64, aarch64           2029-06-30 (`End of Standard Support <https://wiki.ubuntu.com/Releases#Current>`__)
 ================================   =======================   ============================================================

redbot/__init__.py

@@ -289,19 +289,6 @@ class VersionInfo:
         return version("Red-DiscordBot")
 
 
-def _update_event_loop_policy():
-    if _sys.implementation.name == "cpython":
-        # Let's not force this dependency, uvloop is much faster on cpython
-        try:
-            import uvloop
-        except ImportError:
-            pass
-        else:
-            import asyncio
-
-            asyncio.set_event_loop_policy(uvloop.EventLoopPolicy())
-
-
 def _ensure_no_colorama():
     # a hacky way to ensure that nothing initialises colorama
     # if we're not running with legacy Windows command line mode
@@ -334,12 +321,11 @@ def _early_init():
     # This function replaces logger so we preferably (though not necessarily) want that to happen
     # before importing anything that calls `logging.getLogger()`, i.e. `asyncio`.
     _update_logger_class()
-    _update_event_loop_policy()
     _ensure_no_colorama()
 
 
 # This is bumped automatically by release workflow (`.github/workflows/scripts/bump_version.py`)
-_VERSION = "3.5.16"
+_VERSION = "3.5.25.dev1"
 
 __version__, version_info = VersionInfo._get_version()
 

redbot/__main__.py

@@ -25,9 +25,9 @@ import rich
 import redbot.logging
 from redbot import __version__
 from redbot.core.bot import Red, ExitCodes, _NoOwnerSet
-from redbot.core._cli import interactive_config, confirm, parse_cli_flags
+from redbot.core._cli import interactive_config, confirm, parse_cli_flags, new_event_loop
 from redbot.setup import get_data_dir, get_name, save_config
-from redbot.core import data_manager, _drivers
+from redbot.core import data_manager, _drivers, _downloader
 from redbot.core._debuginfo import DebugInfo
 from redbot.core._sharedlibdeprecation import SharedLibImportWarner
 
@@ -182,32 +182,10 @@ async def _edit_owner(red, owner, no_prompt):
 
 def _edit_instance_name(old_name, new_name, confirm_overwrite, no_prompt):
     if new_name:
-        name = new_name
-        if name in _get_instance_names() and not confirm_overwrite:
-            name = old_name
-            print(
-                "An instance with this name already exists.\n"
-                "If you want to remove the existing instance and replace it with this one,"
-                " run this command with --overwrite-existing-instance flag."
-            )
+        name = get_name(new_name, confirm_overwrite=confirm_overwrite)
     elif not no_prompt and confirm("Would you like to change the instance name?", default=False):
-        name = get_name("")
-        if name in _get_instance_names():
-            print(
-                "WARNING: An instance already exists with this name. "
-                "Continuing will overwrite the existing instance config."
-            )
-            if not confirm(
-                "Are you absolutely certain you want to continue with this instance name?",
-                default=False,
-            ):
-                print("Instance name will remain unchanged.")
-                name = old_name
-            else:
-                print("Instance name updated.")
-        else:
-            print("Instance name updated.")
-        print()
+        name = get_name(confirm_overwrite=confirm_overwrite)
+        print("Instance name updated.\n")
     else:
         name = old_name
     return name
@@ -272,7 +250,7 @@ def early_exit_runner(
     """
     This one exists to not log all the things like it's a full run of the bot.
     """
-    loop = asyncio.new_event_loop()
+    loop = new_event_loop()
     asyncio.set_event_loop(loop)
     try:
         if not cli_flags.instance_name:
@@ -281,7 +259,7 @@ def early_exit_runner(
             return
 
         data_manager.load_basic_configuration(cli_flags.instance_name)
-        red = Red(cli_flags=cli_flags, description="Red V3", dm_help=None)
+        red = Red(cli_flags=cli_flags)
         driver_cls = _drivers.get_driver_class()
         loop.run_until_complete(driver_cls.initialize(**data_manager.storage_details()))
         loop.run_until_complete(func(red, cli_flags))
@@ -317,19 +295,23 @@ async def run_bot(red: Red, cli_flags: Namespace) -> None:
     redbot.logging.init_logging(
         level=cli_flags.logging_level,
         location=data_manager.core_data_path() / "logs",
-        cli_flags=cli_flags,
+        rich_logging=cli_flags.rich_logging,
+        rich_tracebacks=cli_flags.rich_tracebacks,
+        rich_traceback_extra_lines=cli_flags.rich_traceback_extra_lines,
+        rich_traceback_show_locals=cli_flags.rich_traceback_show_locals,
     )
 
     log.debug("====Basic Config====")
     log.debug("Data Path: %s", data_manager._base_data_path())
     log.debug("Storage Type: %s", data_manager.storage_type())
 
+    await _downloader._init(red)
+
     # lib folder has to be in sys.path before trying to load any 3rd-party cog (GH-3061)
     # We might want to change handling of requirements in Downloader at later date
-    LIB_PATH = data_manager.cog_data_path(raw_name="Downloader") / "lib"
-    LIB_PATH.mkdir(parents=True, exist_ok=True)
-    if str(LIB_PATH) not in sys.path:
-        sys.path.append(str(LIB_PATH))
+    lib_path = str(_downloader.LIB_PATH)
+    if lib_path not in sys.path:
+        sys.path.append(lib_path)
 
         # "It's important to note that the global `working_set` object is initialized from
         # `sys.path` when `pkg_resources` is first imported, but is only updated if you do
@@ -339,7 +321,7 @@ async def run_bot(red: Red, cli_flags: Namespace) -> None:
         # Source: https://setuptools.readthedocs.io/en/latest/pkg_resources.html#workingset-objects
         pkg_resources = sys.modules.get("pkg_resources")
         if pkg_resources is not None:
-            pkg_resources.working_set.add_entry(str(LIB_PATH))
+            pkg_resources.working_set.add_entry(lib_path)
     sys.meta_path.insert(0, SharedLibImportWarner())
 
     if cli_flags.token:
@@ -422,20 +404,13 @@ def handle_early_exit_flags(cli_flags: Namespace):
         sys.exit(ExitCodes.INVALID_CLI_USAGE)
 
 
-async def shutdown_handler(red, signal_type=None, exit_code=None):
-    if signal_type:
-        log.info("%s received. Quitting...", signal_type.name)
-        # Do not collapse the below line into other logic
-        # We need to renter this function
-        # after it interrupts the event loop.
-        sys.exit(ExitCodes.SHUTDOWN)
-    elif exit_code is None:
-        log.info("Shutting down from unhandled exception")
-        red._shutdown_mode = ExitCodes.CRITICAL
+async def signal_shutdown_handler(red: Red, signal_type: signal.Signals) -> NoReturn:
+    log.info("%s received. Quitting...", signal_type.name)
+    sys.exit(ExitCodes.SHUTDOWN)
 
-    if exit_code is not None:
-        red._shutdown_mode = exit_code
 
+async def shutdown_handler(red: Red, exit_code: int) -> None:
+    red._shutdown_mode = exit_code
     try:
         if not red.is_closed():
             await red.close()
@@ -473,7 +448,8 @@ def red_exception_handler(red, red_task: asyncio.Future):
     except Exception as exc:
         log.critical("The main bot task didn't handle an exception and has crashed", exc_info=exc)
         log.warning("Attempting to die as gracefully as possible...")
-        asyncio.create_task(shutdown_handler(red))
+        log.info("Shutting down from unhandled exception")
+        sys.exit(ExitCodes.CRITICAL)
 
 
 def main():
@@ -484,7 +460,7 @@ def main():
         early_exit_runner(cli_flags, edit_instance)
         return
     try:
-        loop = asyncio.new_event_loop()
+        loop = new_event_loop()
         asyncio.set_event_loop(loop)
 
         if cli_flags.no_instance:
@@ -499,7 +475,7 @@ def main():
 
         data_manager.load_basic_configuration(cli_flags.instance_name)
 
-        red = Red(cli_flags=cli_flags, description="Red V3", dm_help=None)
+        red = Red(cli_flags=cli_flags)
 
         if os.name != "nt":
             # None of this works on windows.
@@ -507,7 +483,7 @@ def main():
             signals = (signal.SIGHUP, signal.SIGTERM, signal.SIGINT)
             for s in signals:
                 loop.add_signal_handler(
-                    s, lambda s=s: asyncio.create_task(shutdown_handler(red, s))
+                    s, lambda s=s: asyncio.create_task(signal_shutdown_handler(red, s))
                 )
 
         exc_handler = functools.partial(global_exception_handler, red)
@@ -524,7 +500,7 @@ def main():
         log.warning("Please do not use Ctrl+C to Shutdown Red! (attempting to die gracefully...)")
         log.error("Received KeyboardInterrupt, treating as interrupt")
         if red is not None:
-            loop.run_until_complete(shutdown_handler(red, signal.SIGINT))
+            loop.run_until_complete(signal_shutdown_handler(red, signal.SIGINT))
     except SystemExit as exc:
         # We also have to catch this one here. Basically any exception which normally
         # Kills the python interpreter (Base Exceptions minus asyncio.cancelled)
@@ -536,11 +512,11 @@ def main():
             exit_code_name = "UNKNOWN"
         log.info("Shutting down with exit code: %s (%s)", exit_code, exit_code_name)
         if red is not None:
-            loop.run_until_complete(shutdown_handler(red, None, exc.code))
+            loop.run_until_complete(shutdown_handler(red, exc.code))
     except Exception as exc:  # Non standard case.
         log.exception("Unexpected exception (%s): ", type(exc), exc_info=exc)
         if red is not None:
-            loop.run_until_complete(shutdown_handler(red, None, ExitCodes.CRITICAL))
+            loop.run_until_complete(shutdown_handler(red, ExitCodes.CRITICAL))
     finally:
         # Allows transports to close properly, and prevent new ones from being opened.
         # Transports may still not be closed correctly on windows, see below

redbot/cogs/admin/locales/et-EE.po

@@ -0,0 +1,323 @@
+msgid ""
+msgstr ""
+"Project-Id-Version: red-discordbot\n"
+"POT-Creation-Date: 2023-06-14 02:57+0000\n"
+"Last-Translator: \n"
+"Language-Team: Estonian\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: redgettext 3.4.2\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"X-Crowdin-Project: red-discordbot\n"
+"X-Crowdin-Project-ID: 289505\n"
+"X-Crowdin-Language: et\n"
+"X-Crowdin-File-ID: 42\n"
+"Language: et_EE\n"
+
+#: redbot/cogs/admin/admin.py:20
+msgid "I attempted to do something that Discord denied me permissions for. Your command failed to successfully complete."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:25
+msgid "I can not give {role.name} to {member.display_name} because that role is higher than or equal to my highest role in the Discord hierarchy."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:31
+msgid "I can not remove {role.name} from {member.display_name} because that role is higher than or equal to my highest role in the Discord hierarchy."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:37
+msgid "I can not edit {role.name} because that role is higher than my or equal to highest role in the Discord hierarchy."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:43
+msgid "I can not let you give {role.name} to {member.display_name} because that role is higher than or equal to your highest role in the Discord hierarchy."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:49
+msgid "I can not let you remove {role.name} from {member.display_name} because that role is higher than or equal to your highest role in the Discord hierarchy."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:55
+msgid "I can not let you edit {role.name} because that role is higher than or equal to your highest role in the Discord hierarchy."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:61
+msgid "I need the \"Manage Roles\" permission to do that."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:63
+msgid "I am already announcing something. If you would like to make a different announcement please use `{prefix}announce cancel` first."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:73
+#, docstring
+msgid "A collection of server administration utilities."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:159
+msgid "{member.display_name} already has the role {role.name}."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:180
+msgid "I successfully added {role.name} to {member.display_name}"
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:190
+msgid "{member.display_name} does not have the role {role.name}."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:211
+msgid "I successfully removed {role.name} from {member.display_name}"
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:226
+#, docstring
+msgid "\n"
+"        Add a role to a user.\n\n"
+"        Use double quotes if the role contains spaces.\n"
+"        If user is left blank it defaults to the author of the command.\n"
+"        "
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:244
+#, docstring
+msgid "\n"
+"        Remove a role from a user.\n\n"
+"        Use double quotes if the role contains spaces.\n"
+"        If user is left blank it defaults to the author of the command.\n"
+"        "
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:256
+#, docstring
+msgid "Edit role settings."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:263
+#, docstring
+msgid "\n"
+"        Edit a role's colour.\n\n"
+"        Use double quotes if the role contains spaces.\n"
+"        Colour must be in hexadecimal format.\n"
+"        [Online colour picker](http://www.w3schools.com/colors/colors_picker.asp)\n\n"
+"        Examples:\n"
+"            `[p]editrole colour \"The Transistor\" #ff0000`\n"
+"            `[p]editrole colour Test #ff9900`\n"
+"        "
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:275
+msgid "{author} ({author.id}) changed the colour of role '{role.name}'"
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:294 redbot/cogs/admin/admin.py:327
+msgid "Done."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:298
+#, docstring
+msgid "\n"
+"        Edit a role's name.\n\n"
+"        Use double quotes if the role or the name contain spaces.\n\n"
+"        Example:\n"
+"            `[p]editrole name \"The Transistor\" Test`\n"
+"        "
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:308
+msgid "{author} ({author.id}) changed the name of role '{old_name}' to '{name}'"
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:332
+#, docstring
+msgid "Announce a message to all servers the bot is in."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:339
+msgid "The announcement has begun."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:346
+#, docstring
+msgid "Cancel a running announce."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:348
+msgid "There is no currently running announcement."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:351
+msgid "The current announcement has been cancelled."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:357
+#, docstring
+msgid "Change how announcements are sent in this guild."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:367
+#, docstring
+msgid "Change the channel where the bot will send announcements."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:370
+msgid "The announcement channel has been set to {channel.mention}"
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:375
+#, docstring
+msgid "Unsets the channel for announcements."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:400
+#, docstring
+msgid "\n"
+"        Add or remove a selfrole from yourself.\n\n"
+"        Server admins must have configured the role as user settable.\n"
+"        NOTE: The role is case sensitive!\n"
+"        "
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:413
+#, docstring
+msgid "\n"
+"        Add a selfrole to yourself.\n\n"
+"        Server admins must have configured the role as user settable.\n"
+"        NOTE: The role is case sensitive!\n"
+"        "
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:424
+#, docstring
+msgid "\n"
+"        Remove a selfrole from yourself.\n\n"
+"        Server admins must have configured the role as user settable.\n"
+"        NOTE: The role is case sensitive!\n"
+"        "
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:435
+#, docstring
+msgid "\n"
+"        Lists all available selfroles.\n"
+"        "
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:445
+msgid "Available Selfroles:\n"
+"{selfroles}"
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:451
+#, docstring
+msgid "Manage selfroles."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:456
+#, docstring
+msgid "\n"
+"        Add a role, or a selection of roles, to the list of available selfroles.\n\n"
+"        NOTE: The role is case sensitive!\n"
+"        "
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:465
+msgid "I cannot let you add {role.name} as a selfrole because that role is higher than or equal to your highest role in the Discord hierarchy."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:475
+msgid "The role \"{role.name}\" is already a selfrole."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:481
+msgid "Added {count} selfroles."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:483
+msgid "Added 1 selfrole."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:489
+#, docstring
+msgid "\n"
+"        Remove a role, or a selection of roles, from the list of available selfroles.\n\n"
+"        NOTE: The role is case sensitive!\n"
+"        "
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:498
+msgid "I cannot let you remove {role.name} from being a selfrole because that role is higher than or equal to your highest role in the Discord hierarchy."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:508
+msgid "Removed {count} selfroles."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:510
+msgid "Removed 1 selfrole."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:516
+#, docstring
+msgid "Clear the list of available selfroles for this server."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:520
+msgid "There are currently no selfroles."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:523
+msgid "Are you sure you want to clear this server's selfrole list?"
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:529
+msgid "You took too long to respond."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:538
+msgid "I cannot clear the selfroles because the selfrole '{role.name}' is higher than or equal to your highest role in the Discord hierarchy."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:544
+msgid "Selfrole list cleared."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:546
+msgid "No changes have been made."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:551
+#, docstring
+msgid "Lock a bot to its current servers only."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:556
+msgid "The bot is no longer serverlocked."
+msgstr ""
+
+#: redbot/cogs/admin/admin.py:558
+msgid "The bot is now serverlocked."
+msgstr ""
+
+#: redbot/cogs/admin/announcer.py:68
+msgid "I could not announce to the following server: "
+msgstr ""
+
+#: redbot/cogs/admin/announcer.py:70
+msgid "I could not announce to the following servers: "
+msgstr ""
+
+#: redbot/cogs/admin/converters.py:13
+msgid "The Admin cog is not loaded."
+msgstr ""
+
+#: redbot/cogs/admin/converters.py:30
+msgid "The role \"{role_name}\" is not a valid selfrole."
+msgstr ""
+
+#: redbot/cogs/admin/converters.py:36
+msgid "This selfrole has more than one case insensitive match. Please ask a moderator to resolve the ambiguity, or use the role ID to reference the role."
+msgstr ""
+

redbot/cogs/admin/locales/nl-NL.po

@@ -118,7 +118,7 @@ msgstr "\n"
 "        Bewerk een rolkleur.\n\n"
 "        Gebruik dubbele aanhalingstekens als de rol spaties bevat.\n"
 "        Kleur moet in hexadecimaal formaat zijn.\n"
-"        [Online kleur kiezer](http://www.w3schools. om/colors/colors_picker. sp)\n\n"
+"        [Online kleur kiezer](http://www.w3schools.com/colors/colors_picker. sp)\n\n"
 "        Voorbeelden:\n"
 "            `[p]editrole colour \"The Transistor\" #ff0000`\n"
 "            `[p]editrole colour Test #ff9900`\n"
@@ -126,7 +126,7 @@ msgstr "\n"
 
 #: redbot/cogs/admin/admin.py:275
 msgid "{author} ({author.id}) changed the colour of role '{role.name}'"
-msgstr ""
+msgstr "{author} ({author.id}) heeft de kleur van rol '{role.name} ' gewijzigd"
 
 #: redbot/cogs/admin/admin.py:294 redbot/cogs/admin/admin.py:327
 msgid "Done."
@@ -149,7 +149,7 @@ msgstr "\n"
 
 #: redbot/cogs/admin/admin.py:308
 msgid "{author} ({author.id}) changed the name of role '{old_name}' to '{name}'"
-msgstr ""
+msgstr "{author} ({author.id}) heeft de naam van rol '{old_name}' veranderd naar '{name}'"
 
 #: redbot/cogs/admin/admin.py:332
 #, docstring
@@ -181,7 +181,7 @@ msgstr "Verander hoe aankondigingen worden verzonden in deze gilde."
 #: redbot/cogs/admin/admin.py:367
 #, docstring
 msgid "Change the channel where the bot will send announcements."
-msgstr "Bewerk het kanaal waar deze bot aankondigingen maakt."
+msgstr "Bewerk het kanaal waar de bot aankondigingen maakt."
 
 #: redbot/cogs/admin/admin.py:370
 msgid "The announcement channel has been set to {channel.mention}"
@@ -361,5 +361,5 @@ msgstr "De rol \"{role_name}\" is geen geldige zelfrol."
 
 #: redbot/cogs/admin/converters.py:36
 msgid "This selfrole has more than one case insensitive match. Please ask a moderator to resolve the ambiguity, or use the role ID to reference the role."
-msgstr ""
+msgstr "Deze zelfrol heeft meer dan één hoofdlettergevoelig resultaat. Vraag een moderator om het dubbele resultaat op te lossen of gebruik de rol-ID om te verwijzen naar de rol."
 

redbot/cogs/admin/locales/pt-PT.po

@@ -21,7 +21,7 @@ msgstr "Tentei fazer uma coisa que o Discord negou permissão para fazer. O coma
 
 #: redbot/cogs/admin/admin.py:25
 msgid "I can not give {role.name} to {member.display_name} because that role is higher than or equal to my highest role in the Discord hierarchy."
-msgstr "Eu não posso dar {role.name} a {member.display_name} porque esse cargo é igual ou maior a meu cargo na hierarquia do Discord."
+msgstr "Eu não posso dar {role.name} a {member.display_name} porque esse cargo é igual ou maior ao meu cargo na hierarquia do Discord."
 
 #: redbot/cogs/admin/admin.py:31
 msgid "I can not remove {role.name} from {member.display_name} because that role is higher than or equal to my highest role in the Discord hierarchy."

redbot/cogs/admin/locales/sl-SI.po

@@ -8,7 +8,7 @@ msgstr ""
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Generated-By: redgettext 3.4.2\n"
-"Plural-Forms: nplurals=4; plural=(n%100==1 ? 1 : n%100==2 ? 2 : n%100==3 || n%100==4 ? 3 : 0);\n"
+"Plural-Forms: nplurals=4; plural=n%100==1 ? 0 : n%100==2 ? 1 : n%100==3 || n%100==4 ? 2 : 3;\n"
 "X-Crowdin-Project: red-discordbot\n"
 "X-Crowdin-Project-ID: 289505\n"
 "X-Crowdin-Language: sl\n"

redbot/cogs/admin/locales/sv-SE.po

@@ -361,5 +361,5 @@ msgstr "Rollen \"{role_name}\" är inte en giltig självroll."
 
 #: redbot/cogs/admin/converters.py:36
 msgid "This selfrole has more than one case insensitive match. Please ask a moderator to resolve the ambiguity, or use the role ID to reference the role."
-msgstr ""
+msgstr ".."
 

redbot/cogs/admin/locales/uk-UA.po

@@ -114,7 +114,15 @@ msgid "\n"
 "            `[p]editrole colour \"The Transistor\" #ff0000`\n"
 "            `[p]editrole colour Test #ff9900`\n"
 "        "
-msgstr ""
+msgstr "\n"
+"        Редагування кольору ролі.\n\n"
+"        Використовуйте подвійні лапки, якщо роль містить пробіли.\n"
+"        Колір повинен бути в шістнадцятковому форматі.\n"
+"        [Онлайн-палітра кольорів](http://www.w3schools.com/colors/colors_picker.asp)\n\n"
+"        Приклади:\n"
+"            `[p]editrole colour \"The Transistor\" #ff0000`\n"
+"            `[p]editrole colour Test #ff9900`\n"
+"        "
 
 #: redbot/cogs/admin/admin.py:275
 msgid "{author} ({author.id}) changed the colour of role '{role.name}'"
@@ -132,7 +140,12 @@ msgid "\n"
 "        Example:\n"
 "            `[p]editrole name \"The Transistor\" Test`\n"
 "        "
-msgstr ""
+msgstr "\n"
+"        Редагування назви ролі.\n\n"
+"        Використовуйте подвійні лапки, якщо роль або ім'я містять пробіли.\n\n"
+"        Наприклад:\n"
+"            `[p]editrole name \"The Transistor\" Test`\n"
+"        "
 
 #: redbot/cogs/admin/admin.py:308
 msgid "{author} ({author.id}) changed the name of role '{old_name}' to '{name}'"
@@ -198,7 +211,11 @@ msgid "\n"
 "        Server admins must have configured the role as user settable.\n"
 "        NOTE: The role is case sensitive!\n"
 "        "
-msgstr ""
+msgstr "\n"
+"        Додайте собі роль себе.\n\n"
+"        Адміністратори сервера повинні налаштувати роль як таку, що може бути встановлена користувачем.\n"
+"        ПРИМІТКА: У ролі враховується регістр символів!\n"
+"        "
 
 #: redbot/cogs/admin/admin.py:424
 #, docstring
@@ -207,7 +224,11 @@ msgid "\n"
 "        Server admins must have configured the role as user settable.\n"
 "        NOTE: The role is case sensitive!\n"
 "        "
-msgstr ""
+msgstr "\n"
+"        Приберіть собі селф-роль.\n\n"
+"        Адміністратори сервера повинні налаштувати роль як таку, що може бути встановлена користувачем.\n"
+"        ПРИМІТКА: У ролі враховується регістр символів!\n"
+"        "
 
 #: redbot/cogs/admin/admin.py:435
 #, docstring
@@ -235,7 +256,10 @@ msgid "\n"
 "        Add a role, or a selection of roles, to the list of available selfroles.\n\n"
 "        NOTE: The role is case sensitive!\n"
 "        "
-msgstr ""
+msgstr "\n"
+"        Додайте роль або вибір ролей до списку доступних саморолей.\n\n"
+"        ПРИМІТКА: У ролі враховується регістр символів!\n"
+"        "
 
 #: redbot/cogs/admin/admin.py:465
 msgid "I cannot let you add {role.name} as a selfrole because that role is higher than or equal to your highest role in the Discord hierarchy."
@@ -259,7 +283,10 @@ msgid "\n"
 "        Remove a role, or a selection of roles, from the list of available selfroles.\n\n"
 "        NOTE: The role is case sensitive!\n"
 "        "
-msgstr ""
+msgstr "\n"
+"        Видалити роль або вибір ролей зі списку доступних саморолей.\n\n"
+"        ПРИМІТКА: У ролі враховується регістр символів!\n"
+"        "
 
 #: redbot/cogs/admin/admin.py:498
 msgid "I cannot let you remove {role.name} from being a selfrole because that role is higher than or equal to your highest role in the Discord hierarchy."
@@ -300,20 +327,20 @@ msgstr "Список з селф-ролями був очищений."
 
 #: redbot/cogs/admin/admin.py:546
 msgid "No changes have been made."
-msgstr ""
+msgstr "Жодних змін не внесено."
 
 #: redbot/cogs/admin/admin.py:551
 #, docstring
 msgid "Lock a bot to its current servers only."
-msgstr ""
+msgstr "Заблокувати бота тільки на його поточних серверах."
 
 #: redbot/cogs/admin/admin.py:556
 msgid "The bot is no longer serverlocked."
-msgstr ""
+msgstr "Бот більше не прив'язаний до сервера."
 
 #: redbot/cogs/admin/admin.py:558
 msgid "The bot is now serverlocked."
-msgstr ""
+msgstr "Бот тепер заблокований сервером."
 
 #: redbot/cogs/admin/announcer.py:68
 msgid "I could not announce to the following server: "

redbot/cogs/alias/alias_entry.py

@@ -59,7 +59,11 @@ class AliasEntry:
         extra = []
         while not view.eof:
             prev = view.index
-            word = view.get_quoted_word()
+            try:
+                word = view.get_quoted_word()
+            except discord.ext.commands.errors.UnexpectedQuoteError:
+                view.skip_ws()
+                continue
             if len(word) < view.index - prev:
                 word = "".join((view.buffer[prev], word, view.buffer[view.index - 1]))
             extra.append(word.strip(" "))

redbot/cogs/alias/locales/ar-SA.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Arabic\n"
 "MIME-Version: 1.0\n"
@@ -179,11 +179,11 @@ msgstr "قائمة الأسماء المستعارة العامة المتاحة
 msgid "There are no global aliases."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "يجب أن يتم تحديد الحجج برقم."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "يجب أن تكون الحجج متتابعة. الحجج المفقودة: "
 

redbot/cogs/alias/locales/bg-BG.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Bulgarian\n"
 "MIME-Version: 1.0\n"
@@ -179,11 +179,11 @@ msgstr ""
 msgid "There are no global aliases."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr ""
 

redbot/cogs/alias/locales/cs-CZ.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Czech\n"
 "MIME-Version: 1.0\n"
@@ -187,11 +187,11 @@ msgstr "Seznam dostupných globálních aliasů pro tohoto bota."
 msgid "There are no global aliases."
 msgstr "Neexistují žádné globální aliasy."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Argumenty musí být zadány s číslem."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Argumenty musí být sekvenční. Chybějící argumenty: "
 

redbot/cogs/alias/locales/da-DK.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Danish\n"
 "MIME-Version: 1.0\n"
@@ -179,11 +179,11 @@ msgstr ""
 msgid "There are no global aliases."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr ""
 

redbot/cogs/alias/locales/de-DE.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: German\n"
 "MIME-Version: 1.0\n"
@@ -187,11 +187,11 @@ msgstr "Zeige die verfügbaren globalen Alias von diesem Bot."
 msgid "There are no global aliases."
 msgstr "Es gibt keine globalen Aliasse."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Die Argumente müssen mit einer Nummer angegeben werden."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Argumente müssen sequentiell sein. Fehlende Argumente: "
 

redbot/cogs/alias/locales/es-ES.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Spanish\n"
 "MIME-Version: 1.0\n"
@@ -186,11 +186,11 @@ msgstr "Muestra una lista de los alias globales disponibles en este bot."
 msgid "There are no global aliases."
 msgstr "No hay alias globales."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Los argumentos deben especificarse con un número."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Los argumentos deben ser secuenciales. Faltan argumentos: "
 

redbot/cogs/alias/locales/et-EE.po

@@ -0,0 +1,189 @@
+msgid ""
+msgstr ""
+"Project-Id-Version: red-discordbot\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
+"Last-Translator: \n"
+"Language-Team: Estonian\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: redgettext 3.4.2\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"X-Crowdin-Project: red-discordbot\n"
+"X-Crowdin-Project-ID: 289505\n"
+"X-Crowdin-Language: et\n"
+"X-Crowdin-File-ID: 8\n"
+"Language: et_EE\n"
+
+#: redbot/cogs/alias/alias.py:35
+#, docstring
+msgid "Create aliases for commands.\n\n"
+"    Aliases are alternative names/shortcuts for commands. They\n"
+"    can act as both a lambda (storing arguments for repeated use)\n"
+"    or as simply a shortcut to saying \"x y z\".\n\n"
+"    When run, aliases will accept any additional arguments\n"
+"    and append them to the stored alias.\n"
+"    "
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:190
+msgid "Aliases:\n"
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:192
+msgid "\n\n"
+"Page {page}/{total}"
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:202
+#, docstring
+msgid "Manage command aliases."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:207
+#, docstring
+msgid "Manage global aliases."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:214
+#, docstring
+msgid "Add an alias for a command."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:219
+msgid "You attempted to create a new alias with the name {name} but that name is already a command on this bot."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:230
+msgid "You attempted to create a new alias with the name {name} but that alias already exists."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:241
+msgid "You attempted to create a new alias with the name {name} but that name is an invalid alias name. Alias names may not contain spaces."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:253 redbot/cogs/alias/alias.py:312
+msgid "You attempted to create a new alias for a command that doesn't exist."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:267
+msgid "A new alias with the trigger `{name}` has been created."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:273
+#, docstring
+msgid "Add a global alias for a command."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:278
+msgid "You attempted to create a new global alias with the name {name} but that name is already a command on this bot."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:289
+msgid "You attempted to create a new global alias with the name {name} but that alias already exists."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:300
+msgid "You attempted to create a new global alias with the name {name} but that name is an invalid alias name. Alias names may not contain spaces."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:323
+msgid "A new global alias with the trigger `{name}` has been created."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:332
+#, docstring
+msgid "Edit an existing alias in this server."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:337 redbot/cogs/alias/alias.py:372
+msgid "The alias with the name {name} does not exist."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:343 redbot/cogs/alias/alias.py:378
+msgid "You attempted to edit an alias to a command that doesn't exist."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:352 redbot/cogs/alias/alias.py:385
+msgid "The alias with the trigger `{name}` has been edited successfully."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:359 redbot/cogs/alias/alias.py:392
+msgid "Alias with the name `{name}` was not found."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:367
+#, docstring
+msgid "Edit an existing global alias."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:399
+#, docstring
+msgid "Try to execute help for the base command of the alias."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:404
+msgid "No such alias exists."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:408
+#, docstring
+msgid "Show what command the alias executes."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:413
+msgid "The `{alias_name}` alias will execute the command `{command}`"
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:418
+msgid "There is no alias with the name `{name}`"
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:424
+#, docstring
+msgid "Delete an existing alias on this server."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:426 redbot/cogs/alias/alias.py:458
+msgid "There are no aliases on this server."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:431 redbot/cogs/alias/alias.py:446
+msgid "Alias with the name `{name}` was successfully deleted."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:434 redbot/cogs/alias/alias.py:449
+msgid "Alias with name `{name}` was not found."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:439
+#, docstring
+msgid "Delete an existing global alias."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:441
+msgid "There are no global aliases on this bot."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:455
+#, docstring
+msgid "List the available aliases on this server."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:464
+#, docstring
+msgid "List the available global aliases on this bot."
+msgstr ""
+
+#: redbot/cogs/alias/alias.py:467
+msgid "There are no global aliases."
+msgstr ""
+
+#: redbot/cogs/alias/alias_entry.py:200
+msgid "Arguments must be specified with a number."
+msgstr ""
+
+#: redbot/cogs/alias/alias_entry.py:207
+msgid "Arguments must be sequential. Missing arguments: "
+msgstr ""
+

redbot/cogs/alias/locales/fi-FI.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Finnish\n"
 "MIME-Version: 1.0\n"
@@ -180,11 +180,11 @@ msgstr "Listaa saatavilla olevat globaalit aliakset tässä botissa."
 msgid "There are no global aliases."
 msgstr "Tässä botissa ei ole globaaleja aliaksia."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Argumentit on määriteltävä numerolla."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Argumenttien on oltava peräkkäisiä. Puuttuvia argumentteja: "
 

redbot/cogs/alias/locales/fr-FR.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: French\n"
 "MIME-Version: 1.0\n"
@@ -185,11 +185,11 @@ msgstr "Liste les alias globaux disponibles sur ce bot."
 msgid "There are no global aliases."
 msgstr "Il n'y a aucun alias global."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Les arguments doivent être spécifiés avec un nombre."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Les arguments doivent être séquentiels. Arguments manquants : "
 

redbot/cogs/alias/locales/hi-IN.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Hindi\n"
 "MIME-Version: 1.0\n"
@@ -179,11 +179,11 @@ msgstr ""
 msgid "There are no global aliases."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr ""
 

redbot/cogs/alias/locales/hr-HR.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Croatian\n"
 "MIME-Version: 1.0\n"
@@ -186,11 +186,11 @@ msgstr "Navedite dostupne globalne nadimke na ovom botu."
 msgid "There are no global aliases."
 msgstr "Nema globalnih nadimaka."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Argumenti se moraju navesti brojem."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Argumenti moraju biti uzastopni. Nedostajući argumenti: "
 

redbot/cogs/alias/locales/hu-HU.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Hungarian\n"
 "MIME-Version: 1.0\n"
@@ -180,11 +180,11 @@ msgstr "A boton elérhető globális aliaszok listázása."
 msgid "There are no global aliases."
 msgstr "Nincsenek globális aliaszok."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr ""
 

redbot/cogs/alias/locales/id-ID.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Indonesian\n"
 "MIME-Version: 1.0\n"
@@ -186,11 +186,11 @@ msgstr "Buat daftar alias global yang tersedia di bot ini."
 msgid "There are no global aliases."
 msgstr "Tidak ada alias global."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Argumen harus ditentukan dengan angka."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Argumen harus berurutan. Argumen yang hilang: "
 

redbot/cogs/alias/locales/it-IT.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Italian\n"
 "MIME-Version: 1.0\n"
@@ -180,11 +180,11 @@ msgstr "Elenca gli pseudonimi globali disponibili su questo server."
 msgid "There are no global aliases."
 msgstr "Non ci sono pseudonimi globali."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Gli argomenti devono essere specificati con un numero."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Gli argomenti devono essere consecutivi. Argomenti mancanti: "
 

redbot/cogs/alias/locales/ja-JP.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Japanese\n"
 "MIME-Version: 1.0\n"
@@ -179,11 +179,11 @@ msgstr ""
 msgid "There are no global aliases."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr ""
 

redbot/cogs/alias/locales/ko-KR.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Korean\n"
 "MIME-Version: 1.0\n"
@@ -185,11 +185,11 @@ msgstr "이 봇에서 사용할 수 있는 글로벌 별칭들을 나열해주
 msgid "There are no global aliases."
 msgstr "전역적인 별칭이 없어요."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "인수는 숫자로 지정해줘야해요."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "인수는 순차적이어야해요. 미확인된 인수: "
 

redbot/cogs/alias/locales/nb-NO.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Norwegian Bokmal\n"
 "MIME-Version: 1.0\n"
@@ -186,11 +186,11 @@ msgstr "Liste over tilgjengelige globale aliaser på denne botten."
 msgid "There are no global aliases."
 msgstr "Det er ingen globale aliaser på denne boten."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Argumenter må spesifiseres med et nummer."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Argumenter må være sekvensielle. Manglende argumenter: "
 

redbot/cogs/alias/locales/nl-NL.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Dutch\n"
 "MIME-Version: 1.0\n"
@@ -180,11 +180,11 @@ msgstr "Maak een lijst van de beschikbare globale aliassen op deze bot."
 msgid "There are no global aliases."
 msgstr "Er zijn geen globale aliassen."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Argumenten moeten worden gespecificeerd met een getal."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Argumenten moeten sequentieel zijn. Ontbrekende argumenten: "
 

redbot/cogs/alias/locales/pl-PL.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Polish\n"
 "MIME-Version: 1.0\n"
@@ -187,11 +187,11 @@ msgstr "Wyświetla dostępne globalne aliasy dla tego bota."
 msgid "There are no global aliases."
 msgstr "Brak globalnych aliasów."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Argumenty należy określić liczbą."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Argumenty muszą być sekwencyjne. Brakujące argumenty: "
 

redbot/cogs/alias/locales/pt-BR.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Portuguese, Brazilian\n"
 "MIME-Version: 1.0\n"
@@ -188,11 +188,11 @@ msgstr "Liste os atalhos globais disponíveis neste bot."
 msgid "There are no global aliases."
 msgstr "Não há atalhos globais."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Os argumentos devem ser especificados por um número."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Os argumentos devem ser sequenciais. Argumentos faltando: "
 

redbot/cogs/alias/locales/pt-PT.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Portuguese\n"
 "MIME-Version: 1.0\n"
@@ -182,11 +182,11 @@ msgstr "Listar os alias globais disponíveis neste bot."
 msgid "There are no global aliases."
 msgstr "Não existem alias globais."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Os argumentos devem ser especificados com um número."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Os argumentos devem ser sequenciais. Faltam argumentos: "
 

redbot/cogs/alias/locales/ru-RU.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Russian\n"
 "MIME-Version: 1.0\n"
@@ -186,11 +186,11 @@ msgstr "Список доступных глобальных псевдоним
 msgid "There are no global aliases."
 msgstr "Нет всеобщих синонимов."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Аргументы должны быть указаны с числом."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Аргументы должны быть последовательными. Отсутствуют аргументы: "
 

redbot/cogs/alias/locales/sk-SK.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Slovak\n"
 "MIME-Version: 1.0\n"
@@ -179,11 +179,11 @@ msgstr ""
 msgid "There are no global aliases."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr ""
 

redbot/cogs/alias/locales/sl-SI.po

@@ -1,14 +1,14 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Slovenian\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Generated-By: redgettext 3.4.2\n"
-"Plural-Forms: nplurals=4; plural=(n%100==1 ? 1 : n%100==2 ? 2 : n%100==3 || n%100==4 ? 3 : 0);\n"
+"Plural-Forms: nplurals=4; plural=n%100==1 ? 0 : n%100==2 ? 1 : n%100==3 || n%100==4 ? 2 : 3;\n"
 "X-Crowdin-Project: red-discordbot\n"
 "X-Crowdin-Project-ID: 289505\n"
 "X-Crowdin-Language: sl\n"
@@ -180,11 +180,11 @@ msgstr "Seznam razpoložljivih globalnih vzdevkov na tem strežniku."
 msgid "There are no global aliases."
 msgstr "Globalnih vzdevkov ni."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Argumente je treba navesti s številko."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Argumenti morajo biti zaporedni. Manjkajoči argumenti: "
 

redbot/cogs/alias/locales/sv-SE.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Swedish\n"
 "MIME-Version: 1.0\n"
@@ -179,11 +179,11 @@ msgstr ""
 msgid "There are no global aliases."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr ""
 

redbot/cogs/alias/locales/tr-TR.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Turkish\n"
 "MIME-Version: 1.0\n"
@@ -187,11 +187,11 @@ msgstr "Bot üzerindeki global kullanılabilir kısaltmaları listeleyin."
 msgid "There are no global aliases."
 msgstr "Herhangi bir global kısaltma mevcut değil."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Değişkenler numara içermelidir."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Değişkenler sıralı olmalıdır. Eksik değişkenler: "
 

redbot/cogs/alias/locales/uk-UA.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Ukrainian\n"
 "MIME-Version: 1.0\n"
@@ -179,11 +179,11 @@ msgstr ""
 msgid "There are no global aliases."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr ""
 

redbot/cogs/alias/locales/vi-VN.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Vietnamese\n"
 "MIME-Version: 1.0\n"
@@ -186,11 +186,11 @@ msgstr "Danh sách tổng hợp những lối tắt toàn hệ thống tồn t
 msgid "There are no global aliases."
 msgstr "Không có lối tắt toàn hệ thống nào."
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "Giá trị phải được ghi rõ ràng bằng một con số."
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "Giá trị phải sắp xếp tuần tự. Bị thiếu cú pháp: "
 

redbot/cogs/alias/locales/zh-CN.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Chinese Simplified\n"
 "MIME-Version: 1.0\n"
@@ -179,11 +179,11 @@ msgstr ""
 msgid "There are no global aliases."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr ""
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr ""
 

redbot/cogs/alias/locales/zh-TW.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2024-01-09 00:35+0000\n"
+"POT-Creation-Date: 2025-08-09 20:56+0000\n"
 "Last-Translator: \n"
 "Language-Team: Chinese Traditional\n"
 "MIME-Version: 1.0\n"
@@ -186,11 +186,11 @@ msgstr "列出此機器人可用的全局別名。"
 msgid "There are no global aliases."
 msgstr "沒有全局別名。"
 
-#: redbot/cogs/alias/alias_entry.py:196
+#: redbot/cogs/alias/alias_entry.py:200
 msgid "Arguments must be specified with a number."
 msgstr "必須用數字指定參數。"
 
-#: redbot/cogs/alias/alias_entry.py:203
+#: redbot/cogs/alias/alias_entry.py:207
 msgid "Arguments must be sequential. Missing arguments: "
 msgstr "參數必須是連續的。 缺少參數： "
 

redbot/cogs/audio/apis/locales/et-EE.po

@@ -0,0 +1,81 @@
+msgid ""
+msgstr ""
+"Project-Id-Version: red-discordbot\n"
+"POT-Creation-Date: 2022-03-16 16:42+0000\n"
+"Last-Translator: \n"
+"Language-Team: Estonian\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: redgettext 3.4.2\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"X-Crowdin-Project: red-discordbot\n"
+"X-Crowdin-Project-ID: 289505\n"
+"X-Crowdin-Language: et\n"
+"X-Crowdin-File-ID: 698\n"
+"Language: et_EE\n"
+
+#: redbot/cogs/audio/apis/interface.py:270
+#: redbot/cogs/audio/apis/interface.py:600
+msgid "Failing to get tracks, skipping remaining."
+msgstr "Ebaõnnestus YouTube'i video hankimine, ülejäänud jäetakse vahele."
+
+#: redbot/cogs/audio/apis/interface.py:303
+#: redbot/cogs/audio/apis/spotify.py:175
+msgid "The Spotify API key or client secret has not been set properly. \n"
+"Use `{prefix}audioset spotifyapi` for instructions."
+msgstr "Spotify API võti või kliendi salajane võti ei ole õigesti seadistatud. \n"
+"Kasutage `{prefix}audioset spotifyapi` juhiste jaoks."
+
+#: redbot/cogs/audio/apis/interface.py:345
+msgid "This doesn't seem to be a valid Spotify playlist/album URL or code."
+msgstr "See ei tundu olevat kehtiv Spotify esitusloendi/albumi URL või kood."
+
+#: redbot/cogs/audio/apis/interface.py:471
+msgid "This doesn't seem to be a supported Spotify URL or code."
+msgstr "See ei tundu olevat toetatud Spotify URL või kood."
+
+#: redbot/cogs/audio/apis/interface.py:561
+msgid "The connection was reset while loading the playlist."
+msgstr "Ühendus taastati, kui esitusloendit laaditi."
+
+#: redbot/cogs/audio/apis/interface.py:572
+msgid "Player timeout, skipping remaining tracks."
+msgstr "Mängija aja ületamine, ülejäänud lood jäetakse vahele."
+
+#: redbot/cogs/audio/apis/interface.py:665
+msgid " {bad_tracks} tracks cannot be queued."
+msgstr "{bad_tracks} lugusid ei saa järjekorda lisada."
+
+#: redbot/cogs/audio/apis/interface.py:673
+msgid "Playlist Enqueued"
+msgstr "Esitusloend lisatud järjekorda"
+
+#: redbot/cogs/audio/apis/interface.py:674
+msgid "Added {num} tracks to the queue.{maxlength_msg}"
+msgstr "Lisatud {num} lugu järjekorda.{maxlength_msg}"
+
+#: redbot/cogs/audio/apis/interface.py:680
+msgid "{time} until start of playlist playback: starts at #{position} in queue"
+msgstr "{time} kuni esitusloendi esituse alguseni: algab järjekorras #{position} kohal"
+
+#: redbot/cogs/audio/apis/interface.py:691
+msgid "Nothing found.\n"
+"The YouTube API key may be invalid or you may be rate limited on YouTube's search service.\n"
+"Check the YouTube API key again and follow the instructions at `{prefix}audioset youtubeapi`."
+msgstr "Midagi ei leitud.  \n"
+"YouTube API võti võib olla kehtetu või võib YouTube'i otsinguteenuses olla määratud päringute piirang.  \n"
+"Kontrolli YouTube API võtit uuesti ja järgi juhiseid `{prefix}audioset youtubeapi`."
+
+#: redbot/cogs/audio/apis/youtube.py:62
+msgid "Your YouTube Data API token is invalid.\n"
+"Check the YouTube API key again and follow the instructions at `{prefix}audioset youtubeapi`."
+msgstr "Teie YouTube Data API token on kehtetu.  \n"
+"Kontrollige YouTube API võtit uuesti ja järgige juhiseid `{prefix}audioset youtubeapi`."
+
+#: redbot/cogs/audio/apis/youtube.py:74
+msgid "YouTube API error code: 403\n"
+"Your YouTube API key may have reached the account's query limit for today. Please check <https://developers.google.com/youtube/v3/getting-started#quota> for more information."
+msgstr "YouTube API tõrgekood: 403 \n"
+"Teie YouTube API võti võib olla jõudnud konto päringute limiidi täitumiseni täna. Palun kontrollige <https://developers.google.com/youtube/v3/getting-started#quota> lisainformatsiooni jaoks."
+

redbot/cogs/audio/apis/locales/sl-SI.po

@@ -8,7 +8,7 @@ msgstr ""
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Generated-By: redgettext 3.4.2\n"
-"Plural-Forms: nplurals=4; plural=(n%100==1 ? 1 : n%100==2 ? 2 : n%100==3 || n%100==4 ? 3 : 0);\n"
+"Plural-Forms: nplurals=4; plural=n%100==1 ? 0 : n%100==2 ? 1 : n%100==3 || n%100==4 ? 2 : 3;\n"
 "X-Crowdin-Project: red-discordbot\n"
 "X-Crowdin-Project-ID: 289505\n"
 "X-Crowdin-Language: sl\n"

redbot/cogs/audio/core/__init__.py

@@ -3,7 +3,6 @@ import datetime
 import json
 
 from collections import Counter, defaultdict
-from pathlib import Path
 from typing import Mapping, Dict
 
 import aiohttp
@@ -13,7 +12,6 @@ from redbot.core import Config
 from redbot.core.bot import Red
 from redbot.core.commands import Cog
 from redbot.core.data_manager import cog_data_path
-from redbot.core.i18n import Translator, cog_i18n
 from redbot.core.utils.antispam import AntiSpam
 
 from ..utils import (
@@ -25,10 +23,7 @@ from ..utils import (
 from . import abc, cog_utils, commands, events, tasks, utilities
 from .cog_utils import CompositeMetaClass
 
-_ = Translator("Audio", Path(__file__))
 
-
-@cog_i18n(_)
 class Audio(
     commands.Commands,
     events.Events,
@@ -37,8 +32,6 @@ class Audio(
     Cog,
     metaclass=CompositeMetaClass,
 ):
-    """Play audio through voice channels."""
-
     llset_captcha_intervals = [
         (datetime.timedelta(days=1), 1),
     ]

redbot/cogs/audio/core/commands/__init__.py

@@ -8,8 +8,13 @@ from .miscellaneous import MiscellaneousCommands
 from .player import PlayerCommands
 from .playlists import PlaylistCommands
 from .queue import QueueCommands
+from redbot.core.i18n import Translator, cog_i18n
 
 
+_ = Translator("Audio", __file__)
+
+
+@cog_i18n(_)
 class Commands(
     AudioSetCommands,
     PlayerControllerCommands,
@@ -22,4 +27,4 @@ class Commands(
     QueueCommands,
     metaclass=CompositeMetaClass,
 ):
-    """Class joining all command subclasses"""
+    """Play audio through voice channels."""

redbot/cogs/audio/core/commands/audioset.py

@@ -16,6 +16,7 @@ from redbot.core.i18n import Translator
 from redbot.core.utils.chat_formatting import box, humanize_number
 from redbot.core.utils.menus import menu, start_adding_reactions
 from redbot.core.utils.predicates import MessagePredicate, ReactionPredicate
+from redbot.core.utils.views import SetApiView
 
 from ...audio_dataclasses import LocalPath
 from ...converters import ScopeParser
@@ -1280,26 +1281,38 @@ class AudioSetCommands(MixinMeta, metaclass=CompositeMetaClass):
             "6. Click on Create Credential at the top.\n"
             '7. At the top click the link for "API key".\n'
             "8. No application restrictions are needed. Click Create at the bottom.\n"
-            "9. You now have a key to add to `{prefix}set api youtube api_key <your_api_key_here>`"
-        ).format(prefix=ctx.prefix)
-        await ctx.maybe_send_embed(message)
+            "9. Click the button below this message and set your API key"
+            " with the data shown in Google Developers Console."
+        )
+        await ctx.send(
+            message,
+            view=SetApiView(default_service="youtube", default_keys={"api_key": ""}),
+        )
 
     @command_audioset.command(name="spotifyapi")
     @commands.is_owner()
     async def command_audioset_spotifyapi(self, ctx: commands.Context):
         """Instructions to set the Spotify API tokens."""
         message = _(
-            "1. Go to Spotify developers and log in with your Spotify account.\n"
-            "(https://developer.spotify.com/dashboard/applications)\n"
-            '2. Click "Create An App".\n'
-            "3. Fill out the form provided with your app name, etc.\n"
-            '4. When asked if you\'re developing commercial integration select "No".\n'
-            "5. Accept the terms and conditions.\n"
-            "6. Copy your client ID and your client secret into:\n"
-            "`{prefix}set api spotify client_id <your_client_id_here> "
-            "client_secret <your_client_secret_here>`"
-        ).format(prefix=ctx.prefix)
-        await ctx.maybe_send_embed(message)
+            "1. Go to Spotify for Developers and log in with your Spotify account."
+            " If this is your first time, you'll be asked to accept the terms and conditions.\n"
+            "(https://developer.spotify.com/dashboard)\n"
+            '2. Click "Create app".\n'
+            "3. Fill out the form provided with your app name and description."
+            " These can be anything you want. Website field can be left empty.\n"
+            "4. Add `https://localhost` to your Redirect URIs. This will not be used"
+            " but is required when filling out the form.\n"
+            '5. Select "Web API" when asked which API/SDKs you are planning to use.\n'
+            "6. Confirm that you agree to the terms and conditions and save the application.\n"
+            "7. Click the button below this message and set your client ID and your client secret"
+            " with the data shown in Spotify's dashboard."
+        )
+        await ctx.send(
+            message,
+            view=SetApiView(
+                default_service="spotify", default_keys={"client_id": "", "client_secret": ""}
+            ),
+        )
 
     @command_audioset.command(name="countrycode")
     @commands.guild_only()

redbot/cogs/audio/core/commands/locales/ar-SA.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2025-01-26 22:03+0000\n"
+"POT-Creation-Date: 2025-09-04 23:27+0000\n"
 "Last-Translator: \n"
 "Language-Team: Arabic\n"
 "MIME-Version: 1.0\n"
@@ -15,6 +15,11 @@ msgstr ""
 "X-Crowdin-File-ID: 676\n"
 "Language: ar_SA\n"
 
+#: redbot/cogs/audio/core/commands/__init__.py:30
+#, docstring
+msgid "Play audio through voice channels."
+msgstr "تشغيل الصوت من خلال القنوات الصوتية."
+
 #: redbot/cogs/audio/core/commands/audioset.py:36
 #, docstring
 msgid "Music configuration options."

redbot/cogs/audio/core/commands/locales/bg-BG.po

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: red-discordbot\n"
-"POT-Creation-Date: 2025-01-26 22:03+0000\n"
+"POT-Creation-Date: 2025-09-04 23:27+0000\n"
 "Last-Translator: \n"
 "Language-Team: Bulgarian\n"
 "MIME-Version: 1.0\n"
@@ -15,6 +15,11 @@ msgstr ""
 "X-Crowdin-File-ID: 676\n"
 "Language: bg_BG\n"
 
+#: redbot/cogs/audio/core/commands/__init__.py:30
+#, docstring
+msgid "Play audio through voice channels."
+msgstr ""
+
 #: redbot/cogs/audio/core/commands/audioset.py:36
 #, docstring
 msgid "Music configuration options."