kpncio / conducter

KPNC Technology: Conducter: is a simple Discord music bot that utilizes the popular Discord.js and Youtube-DL projects. Installing your own version of Conducter is easy and only requires that you have an computer and a Discord account.

Conducter

(Node.js, Discord.js, YT-DLP)

KPNC Technology: Conducter: is a simple Discord music bot that utilizes the popular Discord.js and Youtube-DL projects. Installing your own version of Conducter is easy and only requires that you have an computer and a Discord account.

Installation

For installation on a Linux (Ubuntu based) servers...

• Install necessary base dependencies:

  • Run "sudo bash install.sh"

• Duplicate or rename ".env.example" to ".env" and edit the following properties:

  • TOKEN ( Your bot's Token... Tutorial )
  • CLIENT_ID ( Your bot's Client ID... Tutorial )
  • GUILD_ID ( Your server's Guild ID... Tutorial )

• Finally create the service files, see unit/readme for more information...

For installation on a Windows (10/2019+) servers...

• Install Node.js (this will also install NPM)

• Install necessary Node dependencies:

  • Run "npm i --production"

• Duplicate or rename ".env.example" to ".env" and edit the following properties:

  • TOKEN ( Your bot's Token... Tutorial )
  • CLIENT_ID ( Your bot's Client ID... Tutorial )
  • GUILD_ID ( Your server's Guild ID... Tutorial )

• If you would like the program to automatically start:

  • Create shortcut of "start.bat" by right-clicking and selecting "Create Shortcut"
  • You can rename this shortcut to whatever you want
  • Move the shortcut to the "C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp" directory

Operation

Covering both Linux and Windows environments...

• Invite your bot to server(s)... Tutorial
• After adding your bot to any servers, you must register your slash commands by running "node deploy.js"
• Start your bot:
  • On Linux run "sudo service conducter start"
  • On Windows open the "Start.bat" script
• Bot status:
  • On Linux run "sudo service conducter status"
  • On Windows bring your Node/CMD window to the foreground
• Stop your bot:
  • On Linux run "sudo service conducter stop"
  • On Windows close the Node/CMD window
• Discord Commands:
  • /play: Plays the linked (or searched) YouTube audio
  • /skip: Skips the current song
  • /pause: Pauses music playback
  • /resume: Resumes music playback
  • /stop: Disconnects the bot and resets audio state
  • /loop: Toggles looping feature
  • /about: Displays an overview of Conducter
  • /ping: Tests your slash command