Skip to content

feat: Voice guide rewrite - #556

Open
DA-344 wants to merge 10 commits into
nextfrom
voice-guide-rewrite
Open

feat: Voice guide rewrite#556
DA-344 wants to merge 10 commits into
nextfrom
voice-guide-rewrite

Conversation

@DA-344

@DA-344 DA-344 commented Aug 30, 2026

Copy link
Copy Markdown

Summary

Updates the Voice guides by splitting them in two:

  • Simple Guide: introduces AudioSources and explains each of them as a first-way to send audio to Discord voice channels
  • Advanced Guide: explains how to create custom AudioSources by subclassing, and using Lavalink as an alternative to AudioSources

Information

  • This PR fixes an issue.
  • This PR adds something new (e.g. new method or parameters).
  • This PR is a breaking change (e.g. methods or parameters removed/renamed).
  • This PR is not a code change (e.g. documentation, README, typehinting,
    examples, ...).

Checklist

  • I have searched the open pull requests for duplicates.
  • If code changes were made then they have been tested.
    • I have updated the documentation to reflect the changes.
  • If type: ignore comments were used, a comment is also left explaining why.
  • I have updated the changelog to include these changes.
  • I have read the Contributing Guidelines.
  • AI Usage has been disclosed.
    • If AI has been used, I understand fully what the code does

@DA-344 DA-344 linked an issue Aug 30, 2026 that may be closed by this pull request
@Paillat-dev

Copy link
Copy Markdown
Member

Please link issue

@Paillat-dev
Paillat-dev self-requested a review August 30, 2026 17:19
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 30, 2026

Copy link
Copy Markdown

Deploying pycord-guide with  Cloudflare Pages  Cloudflare Pages

Latest commit: fd66ffb
Status: ✅  Deploy successful!
Preview URL: https://cdcebd0b.guide-49b.pages.dev
Branch Preview URL: https://voice-guide-rewrite.guide-49b.pages.dev

View logs

@Paillat-dev

Copy link
Copy Markdown
Member

@DA-344 You should probably add the pages & rename their sidebar entries in zensical.toml

@DA-344 DA-344 changed the title Voice guide rewrite feat: Voice guide rewrite Aug 30, 2026
Comment thread docs/voice/index.md
- [`Pycord.Wavelink`](https://github.com/Pycord-Development/Pycord.Wavelink),
- [`SonoLink`](https://github.com/sonolink/sonolink) - used for advanced audio playback
[`Lavalink.py`](https://github.com/Devoxin/Lavalink.py),
[`Wavelink`](https://github.com/PythonistaGuild/Wavelink) or any other Python LavaLink library for music playback.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wavelink does not yet provide an explicit support for pycord, redundant.

Comment thread docs/voice/advanced-playing.md Outdated
Comment thread docs/voice/advanced-playing.md Outdated
Comment thread docs/voice/advanced-playing.md
Comment thread docs/voice/advanced-playing.md Outdated
DA-344 and others added 4 commits August 31, 2026 22:59
Co-authored-by: Michael <vmphase.dev@gmail.com>
Signed-off-by: DA344 <108473820+DA-344@users.noreply.github.com>
Co-authored-by: Michael <vmphase.dev@gmail.com>
Signed-off-by: DA344 <108473820+DA-344@users.noreply.github.com>
Co-authored-by: Michael <vmphase.dev@gmail.com>
Signed-off-by: DA344 <108473820+DA-344@users.noreply.github.com>
Co-authored-by: Michael <vmphase.dev@gmail.com>
Signed-off-by: DA344 <108473820+DA-344@users.noreply.github.com>

sl_client.create_node(
id="main-node", # the unique ID for the node being created
uri="http://0.0.0.0:443", # HTTP(S) protocol is required when passing URI

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Lavalink's default port is 2333.

Suggested change
uri="http://0.0.0.0:443", # HTTP(S) protocol is required when passing URI
uri="http://0.0.0.0:2333", # HTTP(S) protocol is required when passing URI

Comment thread zensical.toml
{ "Interactions" = ["interactions/index.md", { "Application Commands" = [{ "Slash Commands" = "interactions/application-commands/slash-commands.md" }, { "Context Menus" = "interactions/application-commands/context-menus.md" }, { "Localizations" = "interactions/application-commands/localizations.md" }] }, { "UI Components" = [{ "Buttons" = "interactions/ui-components/buttons.md" }, { "Select Menus" = "interactions/ui-components/dropdowns.md" }, { "Modal Dialogs" = "interactions/ui-components/modal-dialogs.md" }] }] },
{ "Extensions" = ["extensions/index.md", { "Commands" = [{ "Prefixed Commands" = "extensions/commands/prefixed-commands.md" }, { "Command Groups" = "extensions/commands/groups.md" }, { "Help Command" = "extensions/commands/help-command.md" }] }, { "Pages" = [{ "Paginator Basics" = "extensions/pages/paginator-basics.md" }, { "Paginator FAQ" = "extensions/pages/paginator-faq.md" }] }, { "Bridge" = "extensions/bridge.md" }, { "Tasks" = "extensions/tasks/tasks.md" }] },
{ "Voice" = ["voice/index.md", { "Wavelink Audio Player" = "voice/playing.md" }, { "Receiving Voice Samples" = "voice/receiving.md" }] },
{ "Voice" = ["voice/index.md", { "Playing Audio in Voice" = "voice/playing.md" }, { "Advanced Audio Playing" = "voice/advanced-playing.md" }, { "Receiving Voice Samples" = "voice/receiving.md" }] },

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nav label doesn't match the page's actual title.

Suggested change
{ "Voice" = ["voice/index.md", { "Playing Audio in Voice" = "voice/playing.md" }, { "Advanced Audio Playing" = "voice/advanced-playing.md" }, { "Receiving Voice Samples" = "voice/receiving.md" }] },
{ "Voice" = ["voice/index.md", { "Playing Audio in Voice Channels" = "voice/playing.md" }, { "Advanced Audio Playing" = "voice/advanced-playing.md" }, { "Receiving Voice Samples" = "voice/receiving.md" }] },

Comment thread docs/voice/playing.md Outdated
Co-authored-by: Michael <vmphase.dev@gmail.com>
Signed-off-by: DA344 <108473820+DA-344@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Rewrite the voice guide (Sonolink + DAVE)

3 participants