A Discord bot to capture and stream voice channel audio to a specified audio device and show VC users.
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. It can also generate an overlay of all VC users, show who's speaking, and hide muted users from the overlay.
Not using NodeCG? Try the standalone version of DACBot!
In a Command Prompt window, navigate to your root NodeCG folder. Then execute the command nodecg install nicnacnic/nodecg-dacbot to install. Once completed, execute nodecg defaultconfig nodecg-dacbot to generate the config file.
Your config file is located in the cfg folder in your NodeCG installation. Open nodecg-dacbot.json, you'll see something like this.
{
"botToken": "<bot_token>",
"roleID": "<role_id>",
"device": "<device_name>",
"hideMutedUsers": true
}botToken: Put your bot token here. For more information see below.roleID: Put a role ID here. Users must have this role to operate the bot. Users with the Administrator or Manage Channels can always operate the bot regardless of their role.device: The audio device that will be used for the stream. Leave blank for the default device. A list of available devices can be compiled by running the included tester script, navigate to<path_to_nodecg>/bundles/nodecg-dacbot/utilsand runnode find_devices.js.hideMutedUsers: If set to true, the bot will hide users on the overlay if they're muted.
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.
Paste this bot token in the config next to botToken.
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 type nodecg start in your root NodeCG folder 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.
To change a user's volume, ping the bot with the volume command. The syntax is @DACBot volume <user> <volume>, where user is a ping to the selected user and volume is a value between 1 and 100.
Currently, nodecg-dacbot only supports audio capture in one voice channel at a time. You can get around this by having two copies of the bundle, to do this make a copy of the nodecg-dacbot folder, rename it, then change the name in the bundle's package.json. If you did it correctly you can run two simultaneous versions of DACBot, but you still need two different bot tokens.
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, volume, 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!
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 desktop/mobile only.
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.