Media Commands

The media plugin provides media playback from YouTube, SoundCloud, and internet radio streams. It interfaces with the audio engine to queue and play tracks.

Commands

Command	Description	Roles	Aliases	Flags
link <url>	Play a YouTube or SoundCloud link	dj	—	--front, -f
ytplaylist <url>	Add a YouTube playlist to the queue	dj	ytplist	—
ytsearch <query>	Search YouTube for a song/video	dj	yts	—
ytplay [index]	Play a search result by index (default: 0)	dj	ytp	—
radiolink <url>	Stream an internet radio station	dj	rlink	—

Notes

• Queue placement: By default, link adds the track to the end of the queue. Use the --front / -f flag to add it to the front and start playing immediately.
• YouTube search workflow: Use ytsearch <query> to search YouTube, then ytplay [index] to play a result. The index is zero-based; if omitted, the first result (index 0) is played.
• Playlists: ytplaylist fetches all videos from a YouTube playlist URL and adds them to the queue. Large playlists may take a moment to process.
• Radio streaming: radiolink starts streaming from an internet radio URL. Radio streams play indefinitely until stopped or skipped.
• Roles: All media commands require the dj role or higher.