ChaoticByte/lurch-dl
1
1
Fork 0
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity Actions
Definitely not an unofficial commandline downloader for https://gronkh.tv
6 commits 2 branches 5 tags 65 KiB
Find a file
ChaoticByte 6bbc319d1b
Replace long cli usage section from README with hint to --help command
2025-03-09 09:13:41 +01:00
cli Refactored core, improved core <-> cli interaction 2025-03-09 09:08:07 +01:00
core Refactored core, improved core <-> cli interaction 2025-03-09 09:08:07 +01:00
.gitignore Added project files 2025-03-08 21:13:22 +01:00
build-cli.sh Streamline versioning of cli and core into one 2025-03-08 21:24:37 +01:00
LICENSE Added project files 2025-03-08 21:13:22 +01:00
README.md Replace long cli usage section from README with hint to --help command 2025-03-09 09:13:41 +01:00
VERSION Show output filename in the cli 2025-03-08 22:09:57 +01:00

README.md

what could it be?

Definetly not a commandline downloader for https://gronkh.tv risen from the dead.

Features

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

Known Issues

  • You may get a "Windows Defender SmartScreen prevented an unrecognized app from starting" warning when running a new version for the first time
  • Downloads are capped to 10 Mbyte/s and buffering is simulated to pre-empt IP blocking due to API ratelimiting
  • Start- and stop-timestamps are not very accurate (± 8 seconds)
  • Some videoplayers may have problems with the resulting 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
  • Emojis and other Unicode characters don't get displayed properly in a Powershell Console

Supported Platforms

Tested on Linux and Windows (64bit).

Download / Installation

New versions will appear under Releases. Just download the application and run it via the terminal/cmd/powershell/...

On Linux, you may have to mark the file as executable before being able to run it.

Cli Usage

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

Examples

Download a video in its best available 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
...

Continue a download (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
...

List all chapters (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 a specific chapter (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
...

Specify a start- and stop-timestamp (Linux):

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

List all available formats for a video (Linux):

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

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

Download the video in a specific 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
...

Specify a filename (Windows):

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