Welcome to the kisskh-downloader README! This package is a simple command-line tool for downloading shows from https://kisskh.co/. Here's everything you need to know to get started:
To install kisskh-downloader, simply run the following command:
pip install -U kisskh-downloader
After installing the package, you can use the kisskh dl
command to download shows from the command line.
kisskh dl --help
Usage: kisskh dl [OPTIONS] DRAMA_URL_OR_NAME
Options:
-f, --first INTEGER Starting episode number.
-l, --last INTEGER Ending episode number.
-q, --quality [360p|480p|540p|720p|1080p]
Quality of the video to be downloaded.
-s, --sub-langs TEXT Languages of the subtitles to download.
-o, --output-dir TEXT Output directory where downloaded files will
be store.
--help Show this message and exit.
Here are some examples:
kisskh dl "https://kisskh.co/Drama/Island-Season-2?id=7000" -o .
kisskh dl "Stranger Things" -o .
1. Stranger Things - Season 4
2. Stranger Things - Season 1
3. Stranger Things - Season 2
4. Stranger Things - Season 3
Please select one from above: 1
❗ Note that if the selected quality is not available, it will try to get something lower than that quality. If that also is not available, it will try to get the best quality available.
Downloads episode 4 to 8 of Alchemy of Souls
in 720p:
kisskh dl "https://kisskh.co/Drama/Alchemy-of-Souls?id=5043" -f 4 -l 8 -q 720p -o .
Downloads episode 3 of A Business Proposal
in 720p:
kisskh dl "https://kisskh.co/Drama/A-Business-Proposal?id=4608" -f 3 -l 3 -q 720p -o .
You can also dowload single episode by providing the episode URL
kisskh dl "https://kisskh.co/Drama/A-Business-Proposal/Episode-3?id=4608&ep=86439&page=0&pageSize=100" -o .
For more options, use the --help
flag.
If you want to decrypt the downloaded subtitles, you need to pass the --decrypt-subtitle
or -ds
flag along with a decryption key and initialization vector. Check #14.
Here is an example of how to pass these parameters from the command line:
kisskh download "" --decrypt-subtitle --key "your_key_here" --initialization-vector "your_iv_here"
You can also set these parameters as environment variables. If you set the KISSKH_KEY
and KISSKH_INITIALIZATION_VECTOR
environment variables, they will be used by default.
Here is an example of how to set these environment variables:
export KISSKH_KEY="your_key_here"
export KISSKH_INITIALIZATION_VECTOR="your_iv_here"
set KISSKH_KEY="your_key_here"
set KISSKH_INITIALIZATION_VECTOR="your_iv_here"
After setting these environment variables, you can use the --decrypt-subtitle
flag without passing the key and initialization vector explicitly:
kisskh download "Drama Name" --decrypt-subtitle
Please make sure to replace "your_key_here"
and "your_iv_here"
with your actual decryption key and initialization vector.
To enable debugging, use the -vv
flag while running kisskh dl
.
kisskh -vv dl "https://kisskh.co/Drama/A-Business-Proposal?id=4608" -f 3 -l 3 -q 720p