Easy-Sounds Bot is a powerful Discord bot that allows users to set join sounds, delete sounds, rename sounds, and download and trim sounds from YouTube all from a text channel for a custom soundboard experience.
- Easy-to-Use Soundboard: Sounds are displayed as buttons in the designated channel, making it very easy to play sounds with a single click.
- Set Join Sound: Users can set a custom sound to play when they join a voice channel.
- Delete Sound: Administrators can delete sound files from the soundboard.
- Rename Sound: Administrators can rename sound files.
- Download and Trim from YouTube: Users can download and trim sounds from YouTube.
- Upload Sounds Directly: Users can upload sound files directly to the designated text channel to add them to the soundboard.
- Adjust Sound Volume: Users can modify the volume of sound files with a specified multiplier and optionally replace the original file.
-
/setjoinsound
- Description: Set a sound to play when you join a voice channel.
- Usage:
/setjoinsound sound_name
-
/deletesound
- Description: Delete a sound file from the soundboard.
- Usage:
/deletesound sound_name
-
/rename
- Description: Rename a sound file.
- Usage:
/rename "old_name" "new_name"
-
/ytdlsound
- Description: Download and trim a sound from YouTube.
-n name -l link -s start HH:MM:SS.sss -e end HH:MM:SS.sss - Usage:
/ytdlsound -n name -l link [-s start_time] [-e end_time]
- Description: Download and trim a sound from YouTube.
-
/volume
- Description: Change the volume of a saved sound.
-n name -m multiplier [-r to replace original] - Usage:
/volume -n name -m multiplier [-r]
- Description: Change the volume of a saved sound.
-
/refresh
- Description: Refresh the soundboard to update the button list.
- Usage:
/refresh
-
Clone the repository:
git clone https://github.com/1JanPeters/easy-sounds.git cd easy-sounds -
Create and activate a virtual environment:
python3 -m venv venv source venv/bin/activate -
Install the dependencies:
pip install -r requirements.txt
-
Install
ffmpeg:- On Linux (Debian-based systems like Ubuntu):
sudo apt update sudo apt install ffmpeg
- On macOS (using Homebrew):
brew install ffmpeg
- On Windows:
- Download
ffmpegfrom ffmpeg.org. - Extract the files and add the
bindirectory to your system's PATH. (Refer to this guide for detailed instructions.)
- Download
- On Linux (Debian-based systems like Ubuntu):
-
Copy the configuration template:
- Copy
config_template.jsonand save it asconfig.json. - Edit
config.jsonand replace placeholders with your Discord bot token, guild ID, soundboard channel ID, and the full path to your sounds folder (e.g.,/home/user/sounds,C:\Users\user\sounds).
- Copy
discord.py==2.3.2moviepy==1.0.3pynaclyt-dlp- ffmpeg (must be installed on your system)
-
Go to the Discord Developer Portal.
-
Click on "New Application" and give it a name.
-
Navigate to the "Bot" section on the left sidebar and click on "Add Bot". Confirm by clicking "Yes, do it!".
-
Under the "TOKEN" section, click "Copy" to copy your bot token. This will be used in your
config.jsonfile. -
Enable the "MESSAGE CONTENT INTENT" in the "Privileged Gateway Intents" section.
-
Retrieve your
APPLICATION_ID:- On the "General Information" page of your application, copy the "Application ID".
-
Generate your bot's invite link:
- Use the following URL format, replacing
APPLICATION_IDwith your application's ID:https://discord.com/oauth2/authorize?client_id=APPLICATION_ID&scope=bot&permissions=2150632448 - Paste the generated URL into your browser, and invite the bot to your server.
- Use the following URL format, replacing
-
Retrieve your
GUILD_ID:- Right-click on your server icon in Discord.
- Click on "Copy ID".
-
Create a text channel in your server for the soundboard and retrieve the
SOUNDBOARD_CHANNEL_ID:- Right-click on the channel name.
- Click on "Copy ID".
-
Update your
config.jsonfile with theTOKEN,GUILD_ID, andSOUNDBOARD_CHANNEL_ID.
-
Run the bot:
python bot.py
-
Use the following commands in Discord:
/setjoinsound sound_name: Set a sound to play when you join a voice channel./deletesound sound_name: Delete a sound file from the soundboard (admin only)./rename "old" "new": Rename a sound file (admin only)./ytdlsound -n name -l link -s start HH:MM:SS.sss -e end HH:MM:SS.sss: Download and trim a sound from YouTube. The-s(start) and-e(end) parameters are optional. If not provided, the entire audio will be used as the sound.
-
Upload sound files directly to the soundboard:
- Drag and drop your audio files (e.g.,
.mp3,.wav) into the designated text channel to add them to the soundboard.
- Drag and drop your audio files (e.g.,
This bot allows users to download and trim audio from YouTube. Users are responsible for ensuring they have the right to download and use the content in accordance with YouTube's Terms of Service. The developers of this bot are not responsible for any misuse of the tool.
This project is licensed under the MIT License - see the LICENSE file for details.
yt-dlpis licensed under the The Unlicense.discord.pyandmoviepyare licensed under the MIT License.pynaclis licensed under the Apache License 2.0.