Getting Started - Jeffchen54/KMP-Kemono-Downloader GitHub Wiki

Prerequisites:

  • Windows 10/11

Installations:

1. Python 3.10 or 3.11

Download Python from either the Microsoft store or from the official Python website.

https://www.python.org/downloads/

image image

https://apps.microsoft.com/store/detail/python-311/9NRWMJP3717K?hl=en-us&gl=us image

It is recommended to download from the official Python website over downloading from the Microsoft store.

To check if Python was properly installed, you can run 'python' in CMD or equivalent terminal which will bring up a python shell if python was installed properly as seen below:

image image



2. KMPDownloader

There are 2 ways to download the current release of this repo The first method is from the code window. Click the green button labeled "code" and download either the ZIP or clone the repository. Make sure that you are on the branch which correlates to the latest release or main if there is no such branch.

image

The second method is to download the source code from the latest release:

image

For both methods, extract the downloaded files if they are zip and store it in a location you want to run the code from.

3. 7-Zip

7-Zip is optional; however, it is required in order to use the automatic unzipping feature of archive files. Install 7-Zip normally from https://www.7-zip.org/download.html, keep track of the directory 7-Zip files were installed to.

image

Afterwards, add the directory to your path. This can be done by searching 'path' in the Window's search bar.

image

From the popup, click environmental variables. A window should open, from there, double click the line with the variable "PATH". Another window should open, click "New" and paste the line of the 7-Zip directory. Continuously click "OK" to close the menus.

image

To test if the path was configured properly, open CMD and type 7z, usage on 7z should appear.

image



4. Packages

There are 2 ways to install packages.

Recommended (VENV)

Run install_requirements.bat. Note that you will have to be in venv before running the project. You can enter venv by entering "venv/Scripts/Activate" while in the project directory. Enter the command including the quotations.

Unrecommended old approach

Open CMD and type each of the lines below:

pip install -r requirements.txt

Afterwards, you can test if all packages have been installed by running 'python KMPDownloader.py' on the command line within the directory KMPDownloader files exists in. You can open CMD within the directory by entering "cmd" within the search bar.

image



Patching:

NOTE: You may skip this step if you installed using the recommended approach above.

1. Patoolib

Patching of Patoolib is required as it lacks the feature to ignore password protected files. Not implementing this patch means that the downloader will hang on zip files which are password protected. First, run 'pip show patool' in the CMD. Keep track of patool's location:

image

Afterwards, press the Windows key and 'r' at the same time, this will open the run window. Paste the location in the box and click "OK".

image

Open the folder called 'patoolib'. Then open the folder called programs. From another file explorer window, go to the extracted KMPDownloader files and open the folder 'patch for patoolib'. Move all of files from 'patch for patoolib' into the 'programs' folder. A prompt should open saying that duplicate files exists, choose the option to replace the files in the destination.

image

In the image above, you will be dragging files from the top window into the bottom window.

⚠️ **GitHub.com Fallback** ⚠️