Skip to content

anijackich/kinescope-dl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kinescope-dl

Kinescope https://t.me/KinescopeDL License: Unlicense Release Downloads

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

About

Command-line program to download videos from Kinescope.io

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages