Skip to main content

leader

Simple YouTube downloader library for Python (video 360p / audio m4a), built on pytubefix. Fork of VOLT5775/VoLTGoLD-YT (MIT license).

Install

pip install leader-dl
# a specific version (git tag):
pip install leader-dl@v2026.10.22.post1

Requires ffmpeg (sudo apt install ffmpeg -y).

Usage

from leader import download_video, download_audio

path = download_video("https://www.youtube.com/watch?v=VIDEO_ID")
audio = download_audio("https://www.youtube.com/watch?v=VIDEO_ID", out_dir="music")

Async (for bots):

from leader import download_video_async, DownloadError

try:
    path = await download_video_async(url)
except DownloadError as e:
    print("failed:", e)

Notes

  • On a server, the first download may ask you to log in with Google (OAuth device code). Run it once in the terminal. To disable OAuth: export LEADER_OAUTH=0.
  • Telegram bots can upload files up to 50MB only.
  • Download only content you have the right to download.

CLI

leader "https://www.youtube.com/watch?v=VIDEO_ID" -a

License

MIT. Original work © Ebraheem Alhetari; fork changes by the leader maintainers.

Metadata

Release files for leader-dl 2026.10.22.post1

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

Source distribution (sdist)

Source distribution for leader-dl 2026.10.22.post1
File Size Uploaded Provenance
leader_dl-2026.10.22.post1.tar.gz 15.0 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for leader-dl 2026.10.22.post1
File Interpreter ABI Platform
leader_dl-2026.10.22.post1-py3-none-any.whl Python 3 none any Details

Total release size: 33.7 kB

Release files / leader_dl-2026.10.22.post1.tar.gz

Download URL leader_dl-2026.10.22.post1.tar.gz
Size 15.0 kB
Tags Source
SHA-256 checksum
How to use checksums
192db0f0e63253722821cc805131f013fe5a2e4dd0a9b5f9bf33cb47dd8efec8
BLAKE2b-256 checksum
How to use checksums
e931e32f88c8ef15c271740b34d88da9e4d55bc5aef514aabe448c8d91f51523
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.13

Release files / leader_dl-2026.10.22.post1-py3-none-any.whl

Download URL leader_dl-2026.10.22.post1-py3-none-any.whl
Size 18.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
44bed870ee7b244fa0534fb4bcc818297f9572b2d411c4f1d0fb0a30c9a3a543
BLAKE2b-256 checksum
How to use checksums
fba581c71ab5e7d52fff747aa8d56167504c3b7335dde007507144597a26b61e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.13

Security for leader-dl 2026.10.22.post1

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page