trafficstars

Cadence - A Free Discord Music Bot

Enhance your Discord experience with high-quality music.
Completely free and open source!

Core Features 🌟

Cadence offers an enriching audio experience on Discord with features such as:

High-quality music playback from many supported sources thanks to discord-player.
Slash commands, autocompleting search queries, select menus, buttons and more interactive features!
Full queue management system to add, remove, skip or move tracks, view queue and history.
Audio filters, shuffle mode, repeat track, queue or autoplay similar tracks!
Localization with support for multiple languages both for Slash Commands and embed replies.
Open-source codebase and community based development, open to feedback and improvements.
No locked functionality, no premium tier, no ads; everything's free, always.

Adding Cadence to Your Discord Server 🤖

Invite Cadence: Click here to invite Cadence to your Discord server.
Start Using: After Cadence has joined your server, use the /help command for a list of available commands.
Enjoy: That's it! There is no additional setup, but you might want to join our support server to stay updated.

Hosting Cadence Yourself 🔓

Self-Hosting Steps:

Install Node.js v20.x LTS and latest version of FFmpeg.
Clone this repository and run npm install (use npm install --legacy-peer-deps if errors occur).
Build the project with npm run build.
Configure .env file in the root directory with your bot token and client id (details in .env.example).
Deploy slash commands using npm run deploy.
Start the bot with npm start, the bot should now appear online and be operational.

Note: Refer to Adding your bot to servers for help on inviting the bot to your server.

Configuration and Logging:

Override default configuration by creating /config/local.js.
Install pino-pretty for formatted, colorized console output, this is included in optional dependencies.
Logs are stored in /logs folder. Configure the logging level in the config file.
For production, usage of pm2 or similar to manage the bot process is recommended.

Get help and support 🛟

Encounter an issue? Open an issue in this repository or join our Discord support server for assistance.

Credits and acknowledgments 🎉

This project is made possible by the contributions from the community and the use of libraries like discord.js and discord-player. Special thanks to @twlite and @pryzmian for providing feedback and help during development of this bot!