discordmusiclib 1.0.0

A custom YouTube audio downloader for Discord bots

DiscordMusicLib

A custom YouTube audio downloader library specifically designed for Discord bots. This library provides a simple way to extract audio streams from YouTube videos without relying on external dependencies like yt-dlp.

Features

• ✅ Extract audio streams from YouTube videos
• ✅ Discord bot integration ready
• ✅ Async/await support
• ✅ Multiple extraction methods (webpage and embed)
• ✅ Built-in signature deciphering
• ✅ Search functionality
• ✅ Simple API wrapper

Installation

pip install discordmusiclib

Quick Start

Basic Usage

import asyncio
from discordmusiclib import YouTubeAudioDownloader

async def main():
    async with YouTubeAudioDownloader() as downloader:
        # Get video info
        info = await downloader.extract_video_info("https://www.youtube.com/watch?v=dQw4w9WgXcQ")
        print(f"Title: {info['title']}")
        
        # Get stream URL
        stream_url, _ = await downloader.get_audio_stream_url("https://www.youtube.com/watch?v=dQw4w9WgXcQ")
        print(f"Stream URL: {stream_url}")

asyncio.run(main())

Discord Bot Integration

import discord
from discord.ext import commands
from discordmusiclib import DiscordMusicBot

class MusicBot(commands.Cog):
    def __init__(self, bot):
        self.bot = bot
        self.music_bot = DiscordMusicBot()
    
    @commands.command(name='play')
    async def play_music(self, ctx, *, url):
        """Play music from YouTube URL"""
        if not ctx.voice_client:
            if ctx.author.voice:
                await ctx.author.voice.channel.connect()
            else:
                await ctx.send("You need to be in a voice channel!")
                return
        
        await ctx.send("🎵 Searching...")
        
        # Get audio stream
        result = await self.music_bot.play_youtube_audio(url)
        
        if not result['success']:
            await ctx.send(f"❌ Error: {result['error']}")
            return
        
        # Create audio source
        audio_source = discord.FFmpegPCMAudio(
            result['stream_url'],
            before_options='-reconnect 1 -reconnect_streamed 1 -reconnect_delay_max 5'
        )
        
        # Play audio
        ctx.voice_client.play(audio_source)
        
        embed = discord.Embed(
            title="🎵 Now Playing",
            description=result['title'],
            color=0x00ff00
        )
        embed.add_field(name="Duration", value=f"{result['duration']} seconds")
        embed.add_field(name="Uploader", value=result['uploader'])
        
        await ctx.send(embed=embed)

# Bot setup
intents = discord.Intents.default()
intents.message_content = True
bot = commands.Bot(command_prefix='!', intents=intents)

@bot.event
async def on_ready():
    print(f'{bot.user} has connected to Discord!')
    await bot.add_cog(MusicBot(bot))

bot.run('YOUR_BOT_TOKEN')

Simple Synchronous API

from discordmusiclib import SimpleYouTubeAudio

# Get video info
info = SimpleYouTubeAudio.get_audio_info("https://www.youtube.com/watch?v=dQw4w9WgXcQ")
print(f"Title: {info['title']}")

# Get stream URL
stream_url = SimpleYouTubeAudio.get_stream_url("https://www.youtube.com/watch?v=dQw4w9WgXcQ")
print(f"Stream URL: {stream_url}")

YouTube Search

from discordmusiclib import YouTubeSearcher

async def search_example():
    async with YouTubeSearcher() as searcher:
        results = await searcher.search_youtube("Rick Astley Never Gonna Give You Up")
        for result in results:
            print(f"Title: {result['title']}")
            print(f"URL: {result['url']}")
            print(f"Duration: {result['duration']} seconds")

API Reference

YouTubeAudioDownloader

Main class for extracting YouTube audio streams.

Methods

• extract_video_info(url: str) -> Dict: Extract video information
• get_audio_stream_url(url: str, prefer_format: str = 'best') -> Tuple[str, Dict]: Get audio stream URL

DiscordMusicBot

Helper class for Discord bot integration.

Methods

• play_youtube_audio(url: str) -> Dict: Get YouTube audio stream for Discord playback

SimpleYouTubeAudio

Synchronous wrapper for simple usage.

Methods

• get_audio_info(url: str) -> dict: Get video information synchronously
• get_stream_url(url: str) -> str: Get stream URL synchronously

YouTubeSearcher

Search YouTube videos.

Methods

• search_youtube(query: str, max_results: int = 5) -> List[Dict]: Search for videos

Requirements

• Python 3.8+
• aiohttp
• discord.py (for Discord bot features)

License

MIT License

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Disclaimer

This library is for educational purposes only. Please respect YouTube's Terms of Service and consider using official APIs when possible.