DLAP/README.md

64 lines
1.7 KiB
Markdown
Raw Normal View History

# DLAP Bot (Discord.JS Local Audio Player)
2022-03-25 14:00:19 -04:00
A Discord bot that plays local audio tracks. Written in Discord.JS.
2020-07-20 22:32:51 -04:00
2022-07-15 15:53:52 -04:00
[Video Tutorial](https://youtu.be/Gvva8LHjOOo)
If you want to add a feature or there's anything wrong, feel free to make a fork and put a pull request.
2020-07-20 17:55:27 -04:00
2022-07-11 23:14:58 -04:00
# Recommended Software
- Latest version of NodeJS (v18.5.0+)
- Linux (or WSL for Windows users)
# Configuration
Make a new file called `config.json`.
```
{
"token": "token_here",
2022-07-10 13:58:09 -04:00
"txtFile": true/false,
2022-07-11 23:14:58 -04:00
"shuffle": true/false,
2020-07-20 20:35:46 -04:00
"statusChannel": "channel_id",
"voiceChannel": "voice_channel_id",
"clientID": "client_id"
}
```
Create the `music` folder.
Add your own audio files to the `music` folder.
Deploy the commands by doing `node deploy-command.js`.
2022-03-26 17:53:07 -04:00
Launch the bot using `node bot.js` in terminal.
2020-07-20 20:12:52 -04:00
# Help Command
```
Public Only
-----------
ping - Pong!
status - Checks what audio file is playing currently.
2022-03-28 17:42:57 -04:00
about - Information about the bot.
Bot Owner Only
--------------
join - Joins voice chat.
play - Resumes music.
play (int) - Input a number for the selection for the audio file.
2020-07-22 20:19:45 -04:00
pause - Pauses music.
next - Goes to next music.
previous - Goes to previous music.
2022-07-08 12:09:06 -04:00
reshuffle - Reshuffles the playlist
leave - Leaves voice chat.
shutdown - Powers off the bot.
2020-07-20 17:17:08 -04:00
```
# Forking
When forking the project, you can make your own version of DLAP or help contribute to the project (See the "Contributing" section).
2022-07-17 18:15:16 -04:00
You need to edit `/commands/about.js` to uncomment the `.addFields({ name: 'Forked by', value: '[your name] (discord#0000)' })` section.
Be sure to replace that with your name.
# Contributing
2022-07-10 13:58:09 -04:00
When contributing, be sure to add yourself to the contributors list in `/commands/about.js`.