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)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| youtubemusic-2026.4.7.tar.gz | 12.7 kB | Without provenance | Details for youtubemusic-2026.4.7.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| youtubemusic-2026.4.7-py3-none-any.whl | Python 3 | none | any | Details for youtubemusic-2026.4.7-py3-none-any.whl |
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 | |
|
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 | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Security for YouTubeMusic 2026.4.7
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.