Haruhi-DL

This project has ended. Our forces have moved into contributing to yt-dlp.

This is a fork of youtube-dl, focused on bringing a fast, steady stream of updates. We'll do our best to merge patches to any site, not only youtube.

A Microsoft GitHub mirror exists as well: https://github.com/haruhi-dl/haruhi-dl

System-specific ways:

Windows .exe files (mirror) - just unpack and run the exe file in cmd/powershell! (ffmpeg/rtmpdump not included, playwright extractors won't work)
Arch Linux (AUR) - yay -S haruhi-dl (managed by mlunax)
macOS (homebrew) - brew install haruhi-dl (managed by Homebrew)

haruhi-dl is also available on PyPI:

Install release from PyPI on Python 3.x:

$ python3 -m pip install --upgrade haruhi-dl

Install from master (unstable) on Python 3.x:

$ python3 -m pip install --upgrade git+https://git.sakamoto.pl/laudompat/haruhi-dl.git

Python 2 support is dropped, use Python 3.

$ haruhi-dl "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

That's it! You just got rickrolled!

Full manual with all options:

$ haruhi-dl --help

This is not a complete list.

Extracting and downloading video with subtitles from m3u8 (HLS) - this also includes subtitles from Twitter and some other services
Support for BitTorrent protocol (only used when explicitly enabled by user with --allow-p2p or --prefer-p2p; aria2c required)
Specific way to handle selfhosted services (untied to specific providers/domains, like PeerTube, Funkwhale, Mastodon)
Specific way to handle content proxy sites (like Nitter for Twitter)
Merging formats by codecs instead of file extensions, if possible (you'd rather like your AV1+opus downloads from YouTube to be .webm, than .mkv, don't you?)
New/improved/fixed extractors:
- PeerTube (extracting playlists, channels and user accounts, optionally downloading with BitTorrent)
- Funkwhale
- TikTok (extractors for user profiles, hashtags and music - all except single video and music with --no-playlist require Playwright)
- cda.pl
- Ipla
- Weibo (DASH formats)
- LinkedIn (videos from user posts)
- Acast
- Mastodon (including Pleroma, Gab Social, Soapbox)
- Ring Publishing (aka PulsEmbed, PulseVideo, OnetMVP; Ringier Axel Springer)
- TVP (support for TVPlayer2, client-rendered sites and TVP ABC, refactored some extractors to use mobile JSON API)
- TVN24 (support for main page, Fakty and magazine frontend)
- PolskieRadio
- Agora (wyborcza.pl video, wyborcza.pl/wysokieobcasy.pl/audycje.tokfm.pl podcasts, tuba.fm)
- sejm.gov.pl/senat.gov.pl
Some improvements with handling JSON-LD

Please send the bug details to bug@haruhi.download or on Microsoft GitHub.

The project has ended. As an alternative, use yt-dlp - we're going to contribute there from now on :3

If my contributions helped you, please consider sending me a small tip.