Kinescope-dl

Kinescope-dl is a fast video downloader for Kinescope player with encrypted videos support.

Easily download videos with one command

kinescope-dl https://kinescope.io/123456789 output.mp4

Join our community chat in Telegram to discuss issues or if you need help.

⬇️ Installation

Download and unpack the latest release for your OS.

Windows users can place .exe file in any location on their PATH or just call script as ./path/to/executable/kinescope-dl.exe

For UNIX users (Linux, macOS, etc.):

sudo mv ./path/to/executable/kinescope-dl /usr/local/bin/kinescope-dl
sudo chmod a+rx /usr/local/bin/kinescope-dl

🚀 Usage

kinescope-dl [OPTIONS] INPUT_URL OUTPUT_FILE

INPUT_URL — url of the video on Kinescope
OUTPUT_FILE — path to the output mp4 file

Options

  -r, --referer URL      Referer url of the site where the video is embedded
  --best-quality         Automatically select the best possible quality
  --temp PATH            Path to directory for temporary files
  --help                 Show this message and exit

Example

kinescope-dl -r https://example.com --best-quality https://kinescope.io/123456789 ./my_videos/video.mp4

🔨 Build from sources

Requirements

FFmpeg and mp4decrypt are required.

Building

1. Download and install the latest version of Python 3
2. Ensure that you have pip installed: shell python -m ensurepip --upgrade
3. Clone the project using git: shell git clone https://github.com/anijackich/kinescope-dl.git or directly download and unpack the source code.
4. Open console in the project directory
5. Install and use virtualenv (optional): shell pip install virtualenv python3 -m venv venv On Windows, run: shell .\venv\Scripts\activate.bat On Unix or MacOS, run: shell source env/bin/activate
6. Install requirements: shell pip install -r requirements.txt
7. Install PyInstaller: shell pip install pyinstaller
8. Set environment variables with FFmpeg and mp4decrypt binaries paths:

On Windows, run: shell set FFMPEG_PATH=C:\path\to\ffmpeg.exe set MP4DECRYPT_PATH=mp4decrypt.exe On Unix or MacOS, run: shell export FFMPEG_PATH=/path/to/ffmpeg export MP4DECRYPT_PATH=/path/to/mp4decrypt 9. Build the project: shell pyinstaller kinescope-dl.spec 10. Bundled script should be available in the dist folder