aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: a6d150ce801f747bd24cfa55fdf1e2ff7447224a (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
# DLMP3 Bot (Discord.JS Local MP3)

A Discord bot that plays local MP3 audio tracks. Written in Discord.JS.

[Video Tutorial](https://www.youtube.com/watch?v=7X3FAhYW31I)

If you want to add a feature or there's anything wrong, feel free to make a fork and put a pull request.

# Configuration
Make a new file called `config.json`.
```
{
    "token": "token_here",
    "botOwner": "your_user_id_here",
    "txtFile": true/false
    "statusChannel": "channel_id",
    "voiceChannel": "voice_channel_id"
    "guildID": "guild_id",
    "clientID": "client_id",
}
```

Add your own audio files using the mp3 file extension to the `music` folder.

Deploy the commands by doing `node deploy-command.js`

Launch the bot using `node bot.js` in terminal.

# Help Command
```
Public Only
-----------
help - Displays commands.
ping - Pong!
git - Links to the source repo.
about - Information about the bot.

Bot Owner Only
--------------
join - Joins voice chat.
resume - Resumes music.
pause - Pauses music.
skip - Skips the audio track.
leave - Leaves voice chat.
stop - Stops bot.
```

# Forking
When forking the project, you can make your own version of DLMP3 or help contribute to the project (See the "Contributing" section).

But you need to edit `/commands/about.js` to uncomment the `.addField('Forked by', '[your name] (discord#0000)')` section.

Be sure to replace that with your name.

# Contributing
When contributing, be sure to add yourself to the contributors list in `/commands/about.js`.