YouTubeMusic

Async YouTube Music search and stream extraction library for Python.

Designed for developers who need fast YouTube search, metadata extraction, playlist parsing, and direct stream URLs — without mandatory API keys.

Features

Fully async architecture
YouTube search (scraping-based)
Optional YouTube Data API search
Audio stream extraction (powered by yt-dlp)
Video + audio stream support
Playlist & Mix support
Built-in CLI
No forced external services
Production-ready design
No console output on import

Installation

pip install YouTubeMusic

Quick Start

Basic Search

import asyncio
from YouTubeMusic.Search import Search

async def main():
    results = await Search("Kesariya", limit=1)

    if results and results.get("main_results"):
        item = results["main_results"][0]
        print(item)

asyncio.run(main())

Get Audio Stream URL

import asyncio
from YouTubeMusic.Stream import get_stream
cookies_path = ""

async def main():
    url = "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
    stream_url = await get_stream(url, cookies_path)
    print(stream_url)

asyncio.run(main())

Search Using YouTube Data API (Optional)

If you want to use official YouTube API:

Set environment variable:

export YOUTUBE_API_KEYS="key1,key2,key3"

Then:

import asyncio
from YouTubeMusic.YtSearch import Search as YtSearch

async def main():
    results = await YtSearch("Kesariya", limit=1)
    print(results)

asyncio.run(main())

If no API key is configured, it safely returns an empty list.

Get Playlist Songs

import asyncio
from YouTubeMusic.Playlist import get_playlist_songs

async def main():
    songs = await get_playlist_songs(
        "https://www.youtube.com/playlist?list=PLxxxxxxxx"
    )
    print(len(songs))

asyncio.run(main())

Extract Video + Audio URLs

import asyncio
from YouTubeMusic.Video_Stream import get_video_audio_urls
cookies_path = ""
async def main():
    video_url, audio_url = await get_video_audio_urls(
        "https://www.youtube.com/watch?v=dQw4w9WgXcQ", cookies_path
    )
    print(video_url)
    print(audio_url)

asyncio.run(main())

CLI Usage

After installation:

Basic Search

ytmusic "Kesariya"

Extract Audio Stream (requires cookies file)

ytmusic "Kesariya" --stream --cookies cookies.txt

Show Package Info

ytmusic --info

Special Thanks

Special thanks to the yt-dlp project for providing reliable and powerful media extraction capabilities used internally for stream URL handling.

yt-dlp is an open-source project maintained by its contributors. Learn more at: https://github.com/yt-dlp/yt-dlp

p

Why Use YouTubeMusic?

No mandatory YouTube API usage
Fully async and scalable
Lightweight and modular
Suitable for Telegram bots, web apps, and automation
Clean public API
No forced logging
Production-safe design

Requirements

Python 3.8+
httpx (with http2)
orjson
yt-dlp

Project Structure

YouTubeMusic/
    Search.py
    YtSearch.py
    Stream.py
    Video_Stream.py
    Playlist.py
    Models.py
    Utils.py
    cli.py

License

MIT License

Repository

https://github.com/YouTubeMusicAPI/YouTubeMusic

Author

Abhishek Thakur

Metadata

Release files for YouTubeMusic 2026.4.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for YouTubeMusic 2026.4.7
File	Size	Uploaded
youtubemusic-2026.4.7.tar.gz	12.7 kB	Apr 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for YouTubeMusic 2026.4.7
File	Interpreter	ABI	Platform	Reset
youtubemusic-2026.4.7-py3-none-any.whl 15.1 kB Apr 4, 2026	Python 3	none	any	Details

Total release size: 27.7 kB

Release files / youtubemusic-2026.4.7.tar.gz

Download URL	youtubemusic-2026.4.7.tar.gz
Size	12.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`c6890d25e5f5b5d663cf489f22ead5ef828e2cac8a1d04938fb0d36e6de02819`
BLAKE2b-256 checksum How to use checksums	`c813d382f0face212254aad7beee7724750508cdbd9b362d863b1789c01cc04e`
Upload date	Apr 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`

Release files / youtubemusic-2026.4.7-py3-none-any.whl

Download URL	youtubemusic-2026.4.7-py3-none-any.whl
Size	15.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0d2134a6cf15c900e625ec76e2088905808bd70e3417f6795acf2de3570331c4`
BLAKE2b-256 checksum How to use checksums	`6700e3a1d2cda06d61f5ef56e2a7513f8ed094e0ad5b3655396bbe64a839077c`
Upload date	Apr 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`