kinescope.io video downloader

Readme.md

kinescope.io video downloader

1. Install python3, download tools: ffmpeg and N_m3u8DL-RE
2. Put kdl.py, ffmpeg and N_m3u8DL-RE into same folder
3. Run python kdl.py it will ask you to input kinescope embed link (e.g. https://kinescope.io/embed/1234534) and referrer link (e.g. https://videos.mysite.org). kinescope forbids to access without a referrer.
4. Wait for a download copletion.

kdl.py can automatically select the best quality of a video or you can choose it in a menu provided by N_m3u8DL-RE.
ffmpeg receives parts of the selected video and an audio and muxes them into output mp4 file.

Use your Browser developer tools to find a request to https://kinescope.io/embed/ an use in the script.

If you faced dash error

Best option to make sure that you are providing right referrer and embedded link is:

1. Open in chrome
2. Press F12
3. Open your webpage, what you want to download
4. Press ctrl+ F, and type "u0026"
5. You will find list of urls, which contains videos. In Header tab you can grab right referrer and embedded link.
6. If dash = re.findall(r'dash: {"src":"(.?)"', resp)[0].strip() still fails, then switch to response tab and find link, which contains "u0026" (what you found on step 4) , it wll loks like : https://kinescope.io/29402382-ec45-4ea0-b45f-be4fc4f34ff5/master.m3u8?expires=1731320757\u0026token= , without "\u0026token=" it exactly string , what code dash = re.findall(r'{"src":"(.?)"', resp)[0].strip() is trying to find, so just hardcode it

Thanks to @kunter

kdl.py

import requests
import re
import subprocess

m3u8DL_RE_path = 'N_m3u8DL-RE.exe'

link = input('\nkinescope embed link: ')
referrer_link = input('\nreferrer link: ')
select_best = input('\nselect best quality automatically (y/n) [hit ENTER to decline]: ')

headers = {
    'authority': 'kinescope.io',
    'referer': referrer_link,
    'user-agent': 'Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/102.0.0.0 Safari/537.36',
}

resp = requests.get(link, headers=headers).text
try:
    title = re.findall(r'<title>(.*?)</title>', resp)[0].strip()
    print(title)
except IndexError:
    title = input('video title: ')
    
dash = re.findall(r'dash: {\"src\":\"(.*?)\"', resp)[0].strip()
dash = re.sub(r'\\u0026', r'&', dash)
print(f'\nmpd link:\n{dash}\n')

run_args = [m3u8DL_RE_path, '--concurrent-download', '-H', 'referer: '+link+'', '--log-level', 'INFO', '--del-after-done', '-M', 'format=mp4:muxer=ffmpeg', '--save-name', title, dash]
if select_best.lower().strip() == 'y':
   run_args.append('--auto-select')
    
subprocess.run(run_args)

Unfortunately I stuck here.

select best quality automatically (y/n) [hit ENTER to decline]: n

Traceback (most recent call last):
  File "/kdl.py", line 24, in <module>
    dash = re.findall(r'dash: {\"src\":\"(.*?)\"', resp)[0].strip()
           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^
IndexError: list index out of range

IndexError: list index out of range

Me too(

I tried to modify a little bit this sript by deleting in 24 line "dash" bc in resp there is no string with it.

dash = re.findall(r'{\"src\":\"(.*?)\"', resp)[0].strip()

It worked and even downloaded .mp4 and .m4a files with errors like

An error occurred while sending the request.

And then during N_m3u8DL-RE tries to binary merge I've got

WARN : [h264 @ 0000020cb5a836c0] top block unavailable for requested intra mode -1
WARN : [h264 @ 0000020cb5a836c0] error while decoding MB 0 0, bytestream 425
WARN : [h264 @ 0000020cb5a836c0] error while decoding MB 2 0, bytestream -9
WARN : [h264 @ 0000020cb5a836c0] top block unavailable for requested intra mode -1
WARN : [h264 @ 0000020cb5a836c0] error while decoding MB 6 0, bytestream 21
WARN : [h264 @ 0000020cb5a836c0] Increasing reorder buffer to 2
WARN : [h264 @ 0000020cb5a836c0] error while decoding MB 76 0, bytestream -5

So mux failed. I guess it downloads files, but they're corrupted somehow

Traceback (most recent call last):
File "C:\Users\ops\Downloads\kdl\kdl.py", line 24, in
dash = re.findall(r'dash: {"src":"(.*?)"', resp)[0].strip()
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^
IndexError: list index out of range

I faced dash error as well and solved it by grabbing url manually.
Best option to make sure that you are providing right referrer and embedded link is:

1. Open in chrome
2. Press F12
3. Open your webpage, what you want to download
4. Press ctrl+ F, and type "u0026"
5. You will find list of urls, which contains videos. In Header tab you can grab right referrer and embedded link.
6. If dash = re.findall(r'dash: {"src":"(.?)"', resp)[0].strip() will still get you error, then switch to response tab and find link , which contains "u0026" (what you found on step 4) , it wll loks like :"https://kinescope.io/29402382-ec45-4ea0-b45f-be4fc4f34ff5/master.m3u8?expires=1731320757\u0026token=" , without "\u0026token=" it exactly string , what code dash = re.findall(r'{"src":"(.?)"', resp)[0].strip()
   trying to find, so just hardcode it

@kunter Thanks for your contribution! Added your workaround as a Reame part.