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.

Our main repository is on our GitLab: https://git.sakamoto.pl/laudompat/haruhi-dl

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

Installing

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.

Usage

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

That's it! You just got rickrolled!

Full manual with all options:

$ haruhi-dl --help

Differences from youtube-dl

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

Bug reports

Please send the bug details to [email protected] or on Microsoft GitHub.

Contributing

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

Donations

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