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
  --ffmpeg-path PATH     Path to the ffmpeg executable
  --mp4decrypt-path PATH Path to the mp4decrypt executable
  --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:

   python -m ensurepip --upgrade

3. Clone the project using git:

   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):

   pip install virtualenv
   python3 -m venv venv

   On Windows, run:

   .\venv\Scripts\activate.bat

   On Unix or MacOS, run:

   source venv/bin/activate

6. Install requirements:

   pip install -r requirements.txt

7. Install PyInstaller:

   pip install pyinstaller

8. Set environment variables with FFmpeg and mp4decrypt binaries paths:

   On Windows, run:

   set FFMPEG_PATH=C:\path\to\ffmpeg.exe
   set MP4DECRYPT_PATH=C:\path\to\mp4decrypt.exe

   On Unix or MacOS, run:

   export FFMPEG_PATH=/path/to/ffmpeg
   export MP4DECRYPT_PATH=/path/to/mp4decrypt

9. Build the project:

   pyinstaller kinescope-dl.spec

10. Bundled script should be available in the dist folder