Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Melendo/BotMeriendo/llms.txt

Use this file to discover all available pages before exploring further.

BotMeriendo’s music commands let you stream audio from YouTube directly into voice channels. Commands accept both keyword searches and direct URLs, including individual videos and full playlists.
The default command prefix is !. You can change it by setting the TRGGKEY environment variable before starting the bot. All examples on this page use the default ! prefix.

​
Command Reference

​
!play <query or URL>

Searches YouTube for the top result matching your query, or queues a direct video or playlist URL. 
!play lofi hip hop
!play https://www.youtube.com/watch?v=dQw4w9WgXcQ
!play https://www.youtube.com/playlist?list=PLxxx
Behavior:
  • If you are not already in a voice channel, the bot automatically joins the voice channel you are currently in.
  • When a search query is provided (no http prefix), the bot runs a ytsearch: lookup via yt-dlp and queues the top result.
  • When a video URL is provided, the bot extracts metadata using a fast flat-extract pass and adds the track to the queue.
  • When a playlist URL is provided, entries are added to the queue in order, up to the 30-song maximum (MAX_QUEUE_SIZE = 30). The bot sends a single confirmation message showing the playlist title and the number of tracks added.
  • The bot sends a ➕ Añadido a la cola: **<title>** confirmation message for each individually queued track.
  • Audio stream URLs are resolved Just-In-Time (immediately before playback), keeping queue operations fast and lightweight.

​
!skip

Skips the currently playing song and immediately advances to the next entry in the queue. 
!skip
The bot replies with ⏭️ Canción saltada. If the queue is empty after skipping, it announces that playback has ended.
The ⏭️ Skip button on the “Now Playing” embed performs the same action without typing a command. See Interactive Controls below.

​
!stop

Stops playback immediately and clears the entire queue. 
!stop
The bot replies with: 
⏹️ Música detenida y cola vacía.
The bot remains in the voice channel after stopping. Use !leave to also disconnect it.

​
!pause

Pauses the currently playing song. The bot stays in the voice channel and the queue is preserved. 
!pause
The bot replies with ⏸️ Música pausada.
The ⏸️ Pausa button on the “Now Playing” embed performs the same action. After pausing, the button label changes to ▶️ Reanudar.

​
!resume

Resumes a previously paused song from where it was paused. 
!resume
The bot replies with ▶️ Música reanudada.
The ▶️ Reanudar button on the “Now Playing” embed (shown after pausing) performs the same action. After resuming, the button reverts to ⏸️ Pausa.

​
!queue

Displays all songs currently waiting in the playback queue. The currently playing song is not included in this list. 
!queue
Example output: 
📜 Cola de reproducción:
1. Lofi Hip Hop Radio - Beats to Relax/Study To
2. Chill Vibes Mix 2024
3. Jazz Coffee Shop Ambience
The queue is per-server (guild) and holds a maximum of 30 entries (MAX_QUEUE_SIZE = 30). If the queue is empty, the bot replies with La cola está vacía.

​
!join

Makes the bot join your current voice channel without starting playback. 
!join
Error handling:
  • If you are not in a voice channel, the bot replies: ¡Debes estar en un canal de voz!
  • If the bot lacks the Connect permission for that channel, it replies: No tengo permisos para conectarme a ese canal.

​
!leave

Disconnects the bot from the voice channel and clears the current guild’s queue. 
!leave
If the bot is not in any voice channel when this command is used, it replies: No estoy en ningún canal de voz.

​
Interactive Controls

When !play successfully starts a song, BotMeriendo sends a “Reproduciendo ahora” (Now Playing) embed into the text channel. The embed includes:
FieldContent
TitleReproduciendo ahora
DescriptionClickable hyperlink to the YouTube video — [Song Title](video_url)
ColorGreen (#00ff00)
The embed is accompanied by two interactive buttons:
ButtonStyleAction
⏸️ PausaBlurplePauses playback. Label changes to ▶️ Reanudar (green) when paused.
⏭️ SkipRedSkips to the next song in the queue.
Clicking a button sends an ephemeral (private) acknowledgment only visible to the user who clicked it. The embed itself is updated in place to reflect the new pause/resume state.

​
Queue Limits

The queue has a hard cap of 30 songs (MAX_QUEUE_SIZE = 30). If you attempt to add items beyond this limit, the bot sends a warning:
⚠️ La cola está llena, algunas canciones podrían no haberse añadido.
For playlists longer than 30 tracks, only the first 30 entries will be added.

Build docs developers (and LLMs) love

Get started for freeTalk to us