baby-shark

Music bot plugin for Sharkord that allows streaming music from YouTube directly to voice channels.

Screenshots

Building

Prerequisites

• Bun runtime
• @sharkord/plugin-sdk and @sharkord/ui packages linked (see plugin docs)

Development build (builds and deploys to local Sharkord instance)

bun run build:dev

This builds the plugin and copies the output directly to ~/sharkord/plugins/. The ffmpeg and yt-dlp binaries from the local bin/ folder are included automatically.

Release build (produces a zip for distribution)

bun run build:zip

This builds the plugin and packages it as baby-shark.zip in the project root, without the platform binaries. Binaries must be added separately by the end user (see Installation below).

Build output structure

dist/
└── baby-shark/
    ├── server/
    │   └── index.js
    ├── client/
    │   └── index.js
    └── manifest.json

Installation

1. Download the latest release zip from the Releases page and extract it.
2. Move the baby-shark folder into your Sharkord plugins directory (see Data Directory for the location).
3. Download the ffmpeg and yt-dlp binaries and place them inside baby-shark/bin/.
   • ffmpeg: ffmpeg.org/download.html
   • yt-dlp: github.com/yt-dlp/yt-dlp/releases
4. Make both binaries executable:

   chmod +x baby-shark/bin/ffmpeg baby-shark/bin/yt-dlp
   

5. Open Sharkord, go to Settings → Plugins, and enable Baby Shark.

Configuration

Setting	Default	Description
bitrate	128k	Audio bitrate for the music stream (e.g. 128k, 192k, 320k)

Commands

Command	Arguments	Description
/play	<query>	Play a song. Accepts a YouTube URL, a search term, or any direct audio URL.
/play_direct	<url>	Play a direct HTTP(S) audio URL (non-YouTube only).
/stop		Stop playback and clear the queue.
/skip		Skip the current song and play the next in the queue.
/queue		Show the current song and upcoming queue.
/clear		Clear the queue without stopping the current song.
/nowplaying		Show what is currently playing.
/volume	<0-100>	Set the playback volume (default is 50, applies to the next song).
/forceclean		Force-kill all active music streams (admin).
/musicbotdebug		Toggle verbose debug logging (admin).