mirror of
https://github.com/RafaelSolVargas/Vulkan.git
synced 2025-10-29 16:57:23 +00:00
89 lines
3.4 KiB
Markdown
89 lines
3.4 KiB
Markdown
<h1 align="center">Vulkan</h1>
|
|
|
|
|
|
A Music Discord Bot, that plays *Youtube*, *Spotify*, *Deezer* links or raw queries. Vulkan is open source, so everyone can fork this project, follow the instructions and use it in their own way, executing it in your own machine or hosting in others machines to work 24/7.
|
|
|
|
Vulkan uses multiprocessing and asynchronous Python modules to maximize Music Player response time, so the player doesn't lag when many commands are being processed and it can play in multiples discord serves at the same time without affecting the Music Player response time.
|
|
|
|
|
|
<p align="center">
|
|
<img src="./Assets/playermenu.jfif" />
|
|
</p>
|
|
|
|
|
|
# **Music 🎧**
|
|
- Play musics from Youtube, Spotify and Deezer links (Albums, Artists, Playlists and Tracks).
|
|
- Play musics in multiple discord server at the same time.
|
|
- The player contains buttons to shortcut some commands.
|
|
- Manage the loop of one or all playing musics.
|
|
- Manage the order and remove musics from the queue.
|
|
- Shuffle the musics queue order.
|
|
|
|
|
|
|
|
<p align="center">
|
|
<img src="./Assets/vulkancommands.jfif" />
|
|
</p>
|
|
|
|
|
|
|
|
# **How to use it**
|
|
|
|
|
|
### **Requirements**
|
|
Installation of Python 3.8+ and the dependencies in the requirements.txt file, creation of your own Bot in Discord and Spotify Keys.
|
|
```
|
|
pip install -r requirements.txt
|
|
```
|
|
### **🔑 API Keys**
|
|
You have to create your own discord Bot and store your Bot Token
|
|
* Your Discord Application - [Discord](https://discord.com/developers)
|
|
* You own Spotify Keys - [Spotify](https://developer.spotify.com/dashboard/applications)
|
|
|
|
- This information must be stored in an .env file, explained further.
|
|
|
|
### **Installation of FFMPEG**<br>
|
|
FFMPEG is a module that will be used to play music, you must have this configured in your machine
|
|
*FFMPEG must be configured in the PATH for Windows users. Check this [YoutubeVideo](https://www.youtube.com/watch?v=r1AtmY-RMyQ&t=114s&ab_channel=TroubleChute).* <br><br>
|
|
You can download the executables in this link `https://www.ffmpeg.org/download.html` and then put the .exe files inside a ffmpeg\bin folder in your C:\ folder. Do not forget to add 'ffmpeg\bin' to your PATH.
|
|
|
|
|
|
### **.Env File Example**
|
|
This is an example of how your .env file (located in root) should look like.
|
|
```
|
|
BOT_TOKEN=Your_Own_Bot_Token
|
|
SPOTIFY_ID=Your_Own_Spotify_ID
|
|
SPOTIFY_SECRET=Your_Own_Spotify_Secret
|
|
BOT_PREFIX=Your_Wanted_Prefix_For_Vulkan
|
|
|
|
```
|
|
|
|
### **⚙️ Configs**
|
|
The config file is located at ```./config/Configs.py```, it doesn't require any change, but if you can change values to the way you want.
|
|
|
|
|
|
### **Initialization**
|
|
- Go to [Discord](https://discord.com/developers) and invite your Bot to your own server
|
|
- Run ```python main.py``` in console to start
|
|
|
|
|
|
<br>
|
|
<hr>
|
|
<br>
|
|
|
|
## **🚀 Heroku**
|
|
To deploy and run your Bot in Heroku 24/7, follow the instructions in the [Heroku Instructions](HEROKU.md) page.
|
|
|
|
## 🧪 Tests
|
|
The tests were written manually with no package due to problems with async function in other packages, to execute them type in root: <br>
|
|
`python run_tests.py`<br>
|
|
|
|
|
|
## 📖 License
|
|
This program is free software: you can redistribute it and/or modify it under the terms of the [MIT License](https://github.com/RafaelSolVargas/Vulkan/blob/master/LICENSE).
|
|
|
|
|
|
|
|
## 🏗️ Contributing
|
|
If you are interested in upgrading this project i will be very happy to receive a PR or Issue from you. See TODO project to see if i'm working in some feature now.
|