/ytdl video
Download one supported public media item as video.
Availability
Section titled “Availability”Public source-edition command; execution remains conditional on installation, server policy and the running service. This reference is built from the repository, not a live Discord registration probe. Explicit registration contexts: server, bot DM, private channel.
Syntax
Section titled “Syntax”/ytdl video <url:String> [quality:String]Angle brackets indicate required input; square brackets indicate optional input. In Discord, choose the command and fill its named options, rather than typing the brackets.
Parameters
Section titled “Parameters”| Name | Type | Required | Allowed values / bounds | Default when omitted | Description |
|---|---|---|---|---|---|
url |
String | Yes | No registration choices declared; handler validation applies. | Required input | Public media URL from a supported site |
quality |
String | No | best, 1080, 720, 480, 360 |
best (up to 1080p) | Target resolution; best picks up to 1080p within your 300 MiB limit |
Permissions
Section titled “Permissions”No native default-member permission is declared for this path, and no additional native member permission was identified in its reviewed direct handler.
Fork role access is evaluated using the underlying ytdl policy key, even when the slash name is grouped. Native Discord permission checks remain separate from Fork role grants. Sensitive commands fail closed before valid setup; native Administrator bypasses Fork’s role matrix, not Discord’s bot permissions or target hierarchy. See Permission model.
Examples
Section titled “Examples”/ytdl video url:https://www.youtube.com/watch?v=aqz-KE-bpKQ quality:720Prefix equivalent and aliases
f!ytdl video https://www.youtube.com/watch?v=aqz-KE-bpKQ 720Default prefix: f!; installations can configure another. Handler aliases: downloadmedia, yt-dlp. Aliases are prefix names, not additional slash commands.
Grouped prefix routes also delegate to the original handlers, but aliases retain that handler’s argument parsing. Conflicting aliases are rejected as ambiguous. Prefix replies are generally visible in the channel; prefer slash privacy controls for sensitive personal data.
Expected result
Section titled “Expected result”Returns a Discord attachment or temporary download link when enabled. A new media job/link replaces the user’s previous one.
Failure cases
Section titled “Failure cases”Non-HTTPS/private targets, unsupported platforms, playlists, size/duration limits or missing media execution support are refused. Check the returned error, current bot status and the relevant server permissions. A timeout or uncertain receipt is not proof that nothing happened; inspect state before repeating a mutation.
Usage limits
Section titled “Usage limits”Up to 300 MiB for the registered video path; runtime duration, job and delivery caps also apply.
Related commands
Section titled “Related commands”Related guides
Section titled “Related guides”Source edition v1 · Registration, direct handler and shared authorization review are hash-bound in the local documentation validation. This is not a production feature-availability certification.