Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jaketurner616/discordmusicdownloaderbot
Ultimate search, acquisition and organization system for .mp3 music files directly in discord.
https://github.com/jaketurner616/discordmusicdownloaderbot
asynchronous-programming audio-processing configparser discord-bot discord-py mp3-conversion pydub python pytube youtube-api youtube-downloader youtube-search
Last synced: about 3 hours ago
JSON representation
Ultimate search, acquisition and organization system for .mp3 music files directly in discord.
- Host: GitHub
- URL: https://github.com/jaketurner616/discordmusicdownloaderbot
- Owner: JakeTurner616
- License: gpl-3.0
- Created: 2023-12-30T03:59:55.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-01-08T03:10:13.000Z (10 months ago)
- Last Synced: 2024-11-15T01:44:07.513Z (about 3 hours ago)
- Topics: asynchronous-programming, audio-processing, configparser, discord-bot, discord-py, mp3-conversion, pydub, python, pytube, youtube-api, youtube-downloader, youtube-search
- Language: Python
- Homepage:
- Size: 879 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📁🎵 DiscordMusicDownloaderBot 🎵📁
DiscordMusicDownloaderBot is a very simple Discord bot that allows users to easily download and tag music directly to a shared location from within a discord server. It utilizes the discord.py library for interacting with the Discord API, as well as other libraries such as youtube_search, pytube, and pydub for handling YouTube searches and audio processing. Additionally, the bot leverages [MusicBrainz Picard](https://picard.musicbrainz.org/) to enhance the downloaded audio files by automatically clustering and tagging them with accurate metadata.
Using !search to download and tag .mp3 files:
## Binary Downloader 🖥️
[musicbrainz-binary-downloader.py](https://github.com/JakeTurner616/DiscordMusicBot/blob/main/musicbrainz-binary-downloader.py) can be optionally used to automate the process of downloading the latest MusicBrainz Picard binary from the official download page and verifies its integrity using an MD5 hash.
## Features 🌟
1. **YouTube Search** 🔍: Users can search for YouTube videos using the `!search` command. The bot will display the top 5 search results, and users can select a video by reacting to the message with a corresponding number emoji.
2. **Audio Conversion** 🎧: After selecting a video, the bot downloads the audio using pytube, converts it to MP3 format using pydub, and utilizes MusicBrainz Picard to cluster related files and add audio file metadata.
## Setup Musicbrainz-Picard for Automatic file managment 🛠️
To setup automatic file managment in Picard, begin by launching the MusicBrainz application binary. Upon the initial launch, a `Config.ini` file is generated in the `/Musicbrainz-Picard` directory within the working project directory. To customize file movement preferences, navigate to the MusicBrainz `/Musicbrainz-Picard/Config.ini` and modify the following values according to your preferences to allow for a destination folder to be set to a network share, or music library folder:
./MusicBrainz-Picard/Config.ini:
```Config.ini
[setting]
move_files=true
move_files_to=C:\\Users\\jaked\\Music
move_additional_files=true
move_additional_files_pattern=*.jpg *.png
```
## Discord bot setup 🤖
1) Create a bot via the Discord [developer portal](https://discord.com/developers/applications) making sure to enable [message content intents](https://github.com/JakeTurner616/DiscordMusicDownloaderBot/blob/53890da027f6f958579dd4b7198f11483d196c00/docs/members_intent-285748459.png?raw=true) in the bot settings page.
2) Go to the OAuth URL generation page and give the bot the "bot" scope and all necessary permissions to send messages, reactions, embeds, read messages, embed links, and manage messages. Simply invite the bot to a server.
## DiscordMusicDownloaderBot installation 🛠️
1) Clone and cd into the repo:
`git clone https://github.com/JakeTurner616/DiscordMusicDownloaderBot && cd DiscordMusicDownloaderBot`
2) Setup a venv:
`python -m venv venv`
3) Activate the DiscordMusicDownloaderBot venv:
On Windows:
`.\venv\Scripts\activate`
On macOS/Linux:
`source venv/bin/activate`
4) Install the requirements:
`pip install -r requirements.txt`
5) Customize local configuration values within `config.ini`:
```DiscordMusicDownloaderBot/config.ini
; Discord bot token
Token = Replace_with_discord_bot_token
; Bot command prefix
Prefix = !
; Use the official download page (https://picard.musicbrainz.org/downloads/)
; Or use the musicbrainz-downloader.py script to download the application binary:
Picard_path = ./MusicBrainz-Picard-latest.exe
```
## TOS and legality Disclaimer ⚖️
DiscordMusicDownloaderBot is distributed on an "as-is" basis, and the user assumes full responsibility for its usage. While the bot facilitates the download and tagging of audio content from YouTube videos, users are unequivocally advised to adhere to all relevant legal regulations pertaining to content acquisition and distribution of non-copyleft media. Users are strongly encouraged to thoroughly review and comply with the terms and conditions of all required libraries, ensuring that their usage aligns with legal and subjective moral standards. DiscordMusicDownloaderBot is strictly intended for personal non-commercial use, and users are explicitly prohibited from engaging in any activities that involve the commercial exploitation or monetization of any of the bot's functionalities, particularly concerning the re-distribution of copyrighted, or proprietary music.
## License 📜
This bot is distributed under the [GNU General Public License v3.0](https://github.com/JakeTurner616/DiscordMusicBot/blob/main/LICENSE).