README.de.md

lurch-dl - ein Downloader für gronkh.tv

Features

• Download von Stream-Episoden
• Mit Start- und Stop-Timestamps kann nur ein Teil des Videos heruntergeladen werden
• Es können einzelne Kapitel heruntergeladen werden
• Downloads können fortgesetzt werden
• Bedienung über das Terminal

Bekannte Probleme

• Downloads können mit maximal 10 Mbyte/s heruntergeladen werden, zudem wird Buffering simuliert. Das ist notwendig um IP-Bans durch API-Ratelimits zu verhindern.
• Bei Start- und Stop-Timestamps kann es zu Abweichungen von ± 8 Sekunden kommen
• Manche Video-Player könnten mit der heruntergeladenen Videodatei Probleme haben. Dies kann mit FFMPEG behoben werden, indem das Video in eine MKV-Datei umgeschrieben wird: ffmpeg -i video.ts -acodec copy -vcodec copy video.mkv
• In der Powershell-Konsole werden Emojis und andere Unicode-Zeichen nicht richtig dargestellt

Unterstützte Platformen

• Linux (i386, amd64*, arm, arm64)
• Windows (32bit, 64bit*, arm64)

* getestet

Download / Installation

Executables sind unter Releases zu finden. Hier kann einfach eine Executable heruntergeladen, und über das Terminal ausgeführt werden.

Verwendung

Dies ist eine Commandline-Anwendung. Das heißt, dass sie nur in einem Terminal (bei Windows ist das Powershell) verwendet werden kann.

Das sind die zur Verfügung stehenden Commandline-Argumente:

lurch-dl --url string       Die URL zum Video
         [-h --help]        Diesen Hilfetext anzeigen
         [--list-chapters]  Alle Kapitel auflisten
         [--list-formats]   Alle verfügbaren Formate auflisten
         [--chapter int]    Die gewünschte Kapitelnummer
                            Der berechnete Start- und Stop-Timestamp
                            kann mit --start und --stop überschrieben werden
                            default: -1 (disabled)
         [--format string]  Das gewünschte Videoformat
                            default: auto
         [--output string]  Der Dateiname. Wird automatisch ermittelt
                            wenn dieser Parameter weggelassen wird.
         [--start string]   Start-Timestamp, z.B. 12m34s
         [--stop string]    Stop-Timestamp, z.B. 1h23m45s
         [--continue]       Download fortsetzen, wenn möglich
         [--overwrite]      Datei überschreiben, wenn diese bereits existiert

Windows

1. Öffne den Ordner in dem die Anwendung (lurch-dl.exe) liegt
2. Shift+Rechtsklick in den Ordner -> dann auf PowerShell-Fenster hier öffnen.
3. Führe die Anwendung wie oben und unten beschrieben aus

Beispiele

Download eines Videos im besten verfügbaren Format (Windows):

.\lurch-dl.exe --url https://gronkh.tv/streams/777

Title: GTV0777, 2023-11-09 - DIESER STREAM IST ILLEGAL UND SOLLTE VERBOTEN WERDEN!! ⭐ ️ 247 auf @GronkhTV ⭐ ️ !comic !archiv !a
Format: 1080p60
Downloaded 0.43% at 10.00 MB/s
...

Fortsetzen eines Downloads (Windows):

.\lurch-dl.exe --url https://gronkh.tv/streams/777 --continue

Title: GTV0777, 2023-11-09 - DIESER STREAM IST ILLEGAL UND SOLLTE VERBOTEN WERDEN!! ⭐ ️ 247 auf @GronkhTV ⭐ ️ !comic !archiv !a
Format: 1080p60
Downloaded 0.68% at 10.00 MB/s
...

Auflisten aller Kapitel (Windows):

.\lurch-dl.exe --url https://gronkh.tv/streams/777 --list-chapters

GTV0777, 2023-11-09 - DIESER STREAM IST ILLEGAL UND SOLLTE VERBOTEN WERDEN!! ⭐ ️ 247 auf @GronkhTV ⭐ ️ !comic !archiv !a

Chapters:
  1         0s	Just Chatting
  2    2h53m7s	Alan Wake II
  3    9h35m0s	Just Chatting

Download eines bestimmten Kapitels (Windows):

.\lurch-dl.exe --url https://gronkh.tv/streams/777 --chapter 2

GTV0777, 2023-11-09 - DIESER STREAM IST ILLEGAL UND SOLLTE VERBOTEN WERDEN!! ⭐ ️ 247 auf @GronkhTV ⭐ ️ !comic !archiv !a
Format: 1080p60
Chapter: 2. Alan Wake II

Downloaded 3.22% at 10.00 MB/s
...

Angeben eines Start- und Stop-Timestamps (Linux):

./lurch-dl --url https://gronkh.tv/streams/777 --start 5h6m41s --stop 5h6m58s
...

Auflisten aller verfügbaren Formate (Linux):

./lurch-dl --url https://gronkh.tv/streams/777 --list-formats

Available formats:
 - 1080p60
 - 720p
 - 360p

Download im angegebenen Format (Linux):

./lurch-dl --url https://gronkh.tv/streams/777 --format 720p

Title: GTV0777, 2023-11-09 - DIESER STREAM IST ILLEGAL UND SOLLTE VERBOTEN WERDEN!! ⭐ ️ 247 auf @GronkhTV ⭐ ️ !comic !archiv !a
Format: 720p
Downloaded 0.32% at 10.00 MB/s
...

Angeben eines Dateinamens (Windows):

.\lurch-dl.exe --url https://gronkh.tv/streams/777 --output Stream777.ts
...