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 is a modular Discord bot that brings YouTube music streaming and server utilities to your Discord community. It streams audio directly from YouTube — supporting both keyword searches and direct URLs, including full playlists — and ships with interactive playback controls, automatic queue management, and a simple deployment path using Docker.

Deploy with Docker

Get the bot running in minutes with Docker Compose — the recommended deployment method.

Local Development

Run BotMeriendo locally with Python for development and testing.

Command Reference

Explore every bot command — from music playback to general utilities.

Configuration

Configure your bot token, command prefix, and other environment variables.

What BotMeriendo does

BotMeriendo is designed to centralize music and utility features in a single self-hosted bot. It connects to your voice channels on demand and streams audio sourced from YouTube, managing playback through a per-server queue.

Music Streaming

Play music by keyword search or YouTube URL, including full playlists (up to 30 songs).

Interactive Controls

Pause, resume, and skip tracks directly from Discord’s UI using button components.

Auto-disconnect

The bot leaves voice automatically after 1 minute alone — no manual cleanup needed.

Quick setup

1

Create a Discord bot application

Go to the Discord Developer Portal, create a new application, add a bot, and copy the token. See Bot Setup for details.
2

Configure environment variables

Copy .env.example to .env and fill in your TOKEN and optional TRGGKEY prefix. See Environment Variables.
3

Deploy with Docker Compose

Run docker compose up -d --build to build and start the bot in the background.
4

Invite to your server and play

Invite the bot to your server, join a voice channel, and use !play <song name> to start streaming.

Build docs developers (and LLMs) love