Skip to main content
This guide will walk you through installing Rosy Music Bot and all required dependencies on your system.

​
System Requirements

Before installing Rosy Music Bot, ensure your system meets these requirements:
  • Node.js: Version 18.17.0 or higher
  • npm: Usually comes bundled with Node.js
  • Git: For cloning the repository
  • FFmpeg: Optional but recommended for audio processing
  • Operating System: Windows, macOS, or Linux
The bot uses ffmpeg-static as a dependency, which includes FFmpeg automatically. Manual installation is only needed if you encounter audio processing issues.

​
Installing Node.js

1

Choose Your Platform

Select the installation method for your operating system.
2

Windows Installation

  1. Visit the official Node.js website
  2. Download the LTS (Long Term Support) version installer
  3. Run the installer and follow the setup wizard
  4. Keep all default settings unless you have specific requirements
  5. Verify installation by opening Command Prompt and running:
node --version
npm --version
3

macOS Installation

Using Official Installer:
  1. Visit nodejs.org
  2. Download the macOS installer
  3. Run the .pkg file and follow instructions
Using Homebrew (Recommended):
brew install node
Verify installation:
node --version
npm --version
4

Linux Installation

Ubuntu/Debian:
# Update package index
sudo apt update

# Install Node.js and npm
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs
Fedora:
sudo dnf install nodejs
Arch Linux:
sudo pacman -S nodejs npm
Verify installation:
node --version
npm --version

​
Installing FFmpeg (Optional)

FFmpeg is included via ffmpeg-static package, but manual installation can resolve certain audio issues.
  1. Install Chocolatey if you don’t have it
  2. Open PowerShell as Administrator
  3. Run the following command:
choco install ffmpeg
  1. Restart your terminal to apply PATH changes
  2. Verify installation:
ffmpeg -version

brew install ffmpeg
Verify installation:
ffmpeg -version
Ubuntu/Debian:
sudo apt update
sudo apt install ffmpeg
Fedora:
sudo dnf install ffmpeg
Arch Linux:
sudo pacman -S ffmpeg
Verify installation:
ffmpeg -version

​
Cloning the Repository

1

Open Terminal

Open your terminal, command prompt, or PowerShell.
2

Navigate to Directory

Navigate to where you want to install the bot:
cd /path/to/your/projects
3

Clone Repository

Clone the Rosy Music Bot repository:
git clone https://github.com/GatuzoCXL/Rosy-Music-Bot.git
cd Rosy-Music-Bot

​
Installing Dependencies

Once you’ve cloned the repository, install all required Node.js packages: 
npm install
This will install all dependencies listed in package.json, including:
  • discord.js (v14.25.1) - Discord API wrapper
  • distube (v5.2.3) - Music system handler
  • @distube/spotify (v2.0.2) - Spotify integration
  • @distube/yt-dlp (v2.0.1) - YouTube downloader
  • @discordjs/voice (v0.19.0) - Voice connection handler
  • ffmpeg-static (v5.3.0) - FFmpeg binary
  • dotenv (v17.2.3) - Environment variable loader
  • And other supporting packages
After installation completes, you’ll need to apply a critical fix to the yt-dlp plugin. See the troubleshooting section below.

​
Troubleshooting Common Issues

After running npm install, you must fix a configuration issue in the yt-dlp plugin:Location: node_modules/@distube/yt-dlp/dist/index.jsFind these lines (approximately lines 147 and 177) and comment them out:
// Before (causes playback errors):
noCallHome: true,

// After (fixed):
//noCallHome: true,
This parameter causes NO_RESULT and playback errors. After making this change, restart the bot.
You’ll need to repeat this fix every time you run npm install or update dependencies.
If you see FFmpeg-related errors:
  1. Verify FFmpeg installation:
ffmpeg -version
  1. If command not found, install FFmpeg manually (see FFmpeg section above)
  2. On Windows, restart your terminal or computer after installation
  3. Ensure FFmpeg is in your system PATH
If you see errors about Node.js version:
  1. Check your current version:
node --version
  1. Ensure it’s 18.17.0 or higher
  2. If it’s lower, update Node.js using the installation methods above
If you encounter permission errors during npm install:Don’t use sudo with npm. Instead, configure npm to use a different directory:
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
Then run npm install again without sudo.
If git command is not found:
  • Windows: Download from git-scm.com
  • macOS: brew install git or install Xcode Command Line Tools
  • Linux: sudo apt install git (Ubuntu/Debian) or sudo dnf install git (Fedora)

​
Next Steps

Now that you’ve installed the bot and its dependencies, proceed to:
  1. Discord Bot Setup - Create your Discord application and bot
  2. API Keys - Get YouTube and Spotify API credentials
  3. Configuration - Configure your bot settings
Keep your installation directory in a safe location. You’ll need to access it for configuration and running the bot.

Build docs developers (and LLMs) love

Get started for freeTalk to us