🤖 EnigmaV3 - A music recommender bot for Discord

Report Bug · Request Feature

🎼 FEATURES

• Recommend songs based on user input and play them on discord voice channel
• Can be used in chat rooms by teams, friends, organizations to encourage a 'sound' environment
• Capability to toggle music pause/resume
• Capability to play any song- requires no youtube search
• Capability to iterate between songs
• Authorize specific channels for the bot to access
• Acts as an amplifier - can be used to play same music on multiple speakers to give a surround sound effect and increase volume output

📣 V4 : New Features

• Added a new functionality to jump to a custom song in the queue
• Added a new functionality to move the songs within the queue
• Added a new functionality to loop the a currnet playing song or queue
• Feedback command to generate recommendations based on likes and dislikes
• A new command to replay the currently playing song while its playing

If you want to get added to the music server on discord to test the bot, drop an email to rsriram3.edu

⚒️ Installation Procedure

1. Prerequisites

• Install FFMPEG from FFMPEG builds, extract it and add it to your path How to add FFMPEG to Path

2. Running Code

First, clone the repository and cd into the folder:

$ git clone https://github.com/ForkBombers/Enigma.git

Alternatively, clone repo using SSH keys,

$ git clone git@github.com:ForkBombers/Enigma.git

$ cd Enigma

Create a .env file for Discord token:

Use the following format DISCORD_TOKEN=#SECRET_TOKEN#

Install requirements

$ pip install -r requirements.txt

Start the bot

$ python bot.py

You can now use the discord bot to give music recommendations! Use ]help to see all functionalities of bot.

Note: Make sure the bot has the role bot and the user has the role DJ

🚀 Demo

enigma.mp4

🚀 Demo 2 - Group 17

Demo.mp4

📍 Roadmap

What We've Done:

• Enigma now works on Linux and Windows
• Created a Discord Bot via the Discord Developer Portal.
• Added functionalities to the Discord bot. Check Features above.
• Call Enigma to voice channel to play music based on the user's requests.
• Enigma plays songs without having to search on YouTube.
• Added a lil more functionality to Enigma:
  • ]play command to play from queue
  • ]reconnect to reconnect Enigma to Voice channel
  • Enigma checks for Authorized roles and channels

Scope for the future:

• Make the song recommendations more sophisticated by using content-based recommender systems.
• User profile integration with bot
• Broader platform access(ubuntu, Android, iOS etc.)
• More functionalitiies for the bot
• A Dataset suggestion : 'Music Dataset (1950-2019)'

📖 Documentation

Documentation for the code available at - Enigma Docs

👥 Contributors

Group 90

Kaustubh Sonawane

Nikita Chaudhari

Tejas Desai

Contributing

Please see CONTRIBUTING for contributing to this project.

Data

The dataset for Enigma is present here You can find the dataset here Top Spotify Songs (2010-2019) which contains around 600 songs.

Support

For any support reach out to nchaudh5@ncsu.edu, ksonawa@ncsu.edu, tdesai@ncsu.edu