Skip to content

mea bot, download media :3

License

Notifications You must be signed in to change notification settings

tobycm/mea

Folders and files

NameName
Last commit message
Last commit date

Latest commit

616ff81 · · Aug 5, 2025

History

32 Commits
Jul 19, 2025
Jul 19, 2025
Jul 20, 2025
Jul 7, 2025
Aug 5, 2025
Jul 4, 2025
Jul 6, 2025
Jul 13, 2025
Jul 13, 2025
Jul 14, 2025
Jul 19, 2025
Jul 7, 2025
Jul 4, 2025
Jul 13, 2025
Jul 4, 2025
Jul 4, 2025
Jul 1, 2025

Repository files navigation

Banner

mea bot

A Discord bot for downloading media files from various services using the Cobalt API.

Invite the bot here: https://discord.com/oauth2/authorize?client_id=1389427401066545304

Table of Contents

Requirements

  • Node.js v20 or higher
  • npm or bun package manager
  • A Discord bot token and necessary permissions set up in the Discord Developer Portal
  • A Cobalt API URL
  • A Cobalt API key
  • Docker if you want to run the Cobalt instance locally

Getting started

Installation & Setupetup

Setting up the cobalt instance:

docker compose up -d

Setting up the bot:

# Clone the repository
git clone https://github.com/tobycm/mea.git



# Enter into the directory

cd mea


# Install dependencies

# Using npm
bun install

# Or using npm
npm install



# Run the initialization script
bun run init

# or using npm
npm run init



# Edit the .env file with your configuration


$EDITOR .env


# Start the bot
bun run start

# or using npm
npm run start



# To run the bot in development mode
bun run dev

# or using npm
npm run devv

Required permissions

Make sure your bot has the applications.commands scope enabled under the OAuth2 settings in the Discord Developer Portal.

Also, enable the following Privileged Gateway Intents under the Bot tab:

  • Server Members Intent
  • Message Content Intent

These are required for the bot to receive relevant events and use slash commands properly.

Deploying commands

Before using the bot, you need to deploy the commands to your Discord server. In Discord, you can use the following command to deploy them:

@mea deploy

Features & Commandsands

Download

⬇️ Download media files from a URL.

/download rl> +15 optional (e.g. start_time, end_time, etc.)

Auto-download

⚙️ Set up auto-download for media files.

/autodownload +14 optional (e.g. quality, audio_bitrate, etc.)

Remove auto-download

🗑️ Turn off auto-download for media files.

/removeautodownload

Services

🌐 Get a list of supported services.

/services

Contributing

You are welcome to contribute by submitting issues or pull requests!

License

This project is licensed under the MIT License - see the LICENSE file for details.