- What is DACBot?
- Requirements
- Bot Setup
- Usage
- Troubleshooting
- Bugs
- Contributing
- Special Thanks
- License
Discord Audio Capture Bot (also known as DACBot) is a self-hosted Discord bot that can capture the audio of all users in a voice channel and stream it to an audio device of your choice! Perfect for those times you want to capture Discord audio but don't want to go through the hassle of capturing Discord directly through OBS.
Using NodeCG? Try nodecg-dacbot, which includes more features like user audio control and a live VC user overlay!
Go to the Discord Developer Portal, and create a new application.
You can name your application whatever you want, here it doesn't matter. Once your application is created, click on Bot in the menu on the left-side, and click on Add Bot.
Here you can customize the username and avatar of your bot. The username/avatar can be seen by all users, so choose wisely. A creative username is recommended! Once done, copy the token, it will be used later. Do not share this token with anyone, otherwise they will be able to take full control of your bot.
Download the latest release. Put all the files somewhere on your computer that you can easily navigate to. Make sure to run npm install in your Command Prompt to install the required dependencies. Then, open config.json.
Next to token, paste your bot token that you obtained earlier.
Next to roleID, paste a role ID that a user must have to control the bot. If a user does not have the role specified, they won't be able to control the bot.
Next to device, paste the name of the output device you want your bot to stream audio to. Leave blank for the default device. Included with the bot is a tool to list all available devices, you can run it by typing node find_devices.js in a command prompt window.
{
"token": "<paste_bot_token_here>",
"roleID": "570634225125163029",
"device": "Soundboard (Steam Streaming Microphone)"
}Back in the Discord Developer Portal, go back to the General Information page. Then copy your application ID, this is how you'll invite your bot.
To invite your bot, copy and paste the following URL in your browser. Replace <application_id> with your real application ID.
https://discord.com/oauth2/authorize?scope=bot&permissions=0.&client_id=<application_id>
On the page, select your server, then click Authorize. You might need to sign into Discord if you aren't already.
Finally navigate to your bot's folder in Command Prompt and type node index.js to start your bot.
You should see the bot become online on your server, and you're ready to type out some commands! It's a good idea to give the bot moderator permissions so it can see commands typed in hidden channels and connect to hidden voice channels.
Once the bot has started, enter a voice channel, then ping the bot with the connect command to have it join your VC and start capturing audio. To stop capturing audio, simply ping the bot again with the disconnect command and the bot will leave. Ping the bot with the help command for some help.
Currently, DACBot only supports audio capture in one voice channel at a time. But what if you want to capture audio from multiple voice channels? All you have to do is to setup multiple instances of DACBot, with different bots assigned for each instance. The command system ensures you're always pinging the right bot.
The audio is off-pitch!
DACBot only supports 48 kHz, using any other frequency might distort the audio. Please choose an audio device that supports 48 kHz.
The audio is super delayed!
Under normal circumstances, the audio should only be delayed by ~0.25s. If it's delayed more, try restarting the bot.
The commands don't work!
Are you sure you're typing in the command correctly? Available commands are connect, disconnect, and help. Make sure you include a space between the ping and the command. Also, check your bot console for any potential errors.
The bot crashes when speaking from my browser!
See Bugs below. Due to an issue with Discord.JS, only desktop/mobile is supported at the moment. Hopefully this gets fixed soon, but for the meantime make sure you're using deskop/mobile only.
- DACBot will not work if a user is connecting from the browser. It only works on desktop/mobile. It will crash the bot so don't attempt it. This appears to be a limitation with Discord.JS, the library used to write the bot.
If you have any suggestions or bugfixes, please submit a pull request! Before you do, please make sure you test your code to make sure the bot works correctly with your new changes.
Zoton2 and SovietPropaganda, for help and suggestions while coding the bot.
Patlabor and Titan63, for stopping their Valheim game to test the bot.
MIT License
Copyright (c) 2021 nicnacnic
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.