Definitely not an unofficial commandline downloader for https://gronkh.tv
Find a file
2025-08-05 21:05:08 +02:00
cli Refactoring, added remaining custom errors 2025-03-14 23:24:58 +01:00
core Refactoring, added remaining custom errors 2025-03-14 23:24:58 +01:00
.gitignore Added project files 2025-03-08 21:13:22 +01:00
LICENSE Added project files 2025-03-08 21:13:22 +01:00
README.md Restructure and rewrite some parts of the README 2025-08-05 21:05:08 +02:00
release-cli.sh Remove windows support 2025-03-09 20:26:44 +01:00
VERSION Bump version to 2.1.2 2025-03-15 17:13:38 +01:00

Definitely not an unofficial commandline downloader for https://gronkh.tv

Compatibility

This tool is only compatible with recent Linux-based operating systems.
To run it on Windows, make use of WSL.

Features

  • Download Stream-Episodes
  • Specify a start- and stop-timestamp to download only a portion of the video
  • Download a specific chapter
  • Continuable Downloads
  • Show infos about that Episode

Known Issues / Limitations

  • Downloads are capped to 10 Mbyte/s by default and buffering is simulated to pre-empt IP blocking due to API rate-limiting
  • Because of the length of video chunks, start- and stop-timestamps are inaccurate (± 8 seconds)
  • Some videoplayers may have problems with the downloaded video file. To fix this, you can use ffmpeg to rewrite the video into a MKV-File:
    ffmpeg -i video.ts -acodec copy -vcodec copy video.mkv

Download / Installation

New versions will appear under Releases.
Just download the application and run it via your favourite terminal emulator.

Note: You may have to mark the file as executable before being able to run it.

Usage

Run lurch-dl --help to see available options.

Note: This tool runs entirely on the command line.

Examples

Download a video in its best available format:

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

Title:     GTV0777, 2023-11-09 - DIESER STREAM IST ILLEGAL UND ...
Format:    1080p60
Output:    GTV0777, 2023-11-09 - DIESER STREAM IST [...].ts

Downloaded 0.32% at 10.00 MB/s ...

Continue a download:

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

Download a specific chapter:

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

Title:     GTV0777, 2023-11-09 - DIESER STREAM IST ILLEGAL UND ...
Format:    1080p60
Chapter:   2. Alan Wake II
Output:    GTV0777 - 2. Alan Wake II.ts

Downloaded 0.33% at 4.28 MB/s ...

Specify a start- and stop-timestamp:

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

List all available formats for a video:

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

Title:     GTV0777, 2023-11-09 - DIESER STREAM IST ILLEGAL UND ...
Episode:   777
Length:    9h48m55s
Views:     45424
Timestamp: 2023-11-09T18:23:01Z
Tags:      -
Formats:   1080p60, 720p, 360p
Chapters:
           1         0s Just Chatting
           2    2h53m7s Alan Wake II
           3    9h35m0s Just Chatting

Download the video in a specific format:

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

[...]
Format:    720p
[...]

Specify a filename:

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