Package: khed
Khed---Khed is an easy to use, **Free anime downloader**, supporting episodes playlists and resumable downloads. At present it only supports *nix* like Operating System. Although its free, it is recommended that you don't abuse this program.Currently supported site is [chia-anime](http://ww2.chia-anime.tv/)## Features1. Searching of anime by name.2. Downloading anime.3. Episodes playlist.4. Resuming downloads.5. Download progress.6. User-defined output folder.## DependenciesCurrently on *nix* like Operating Systems are supported.Requires Python 3.4+ and pip3 for installing and running.It relies on Firefox headless mode, so make sure you have Firefox version > 56.0 installed, also **geckodriver** is needed, you can follow [Install geckodriver for firefox](https://askubuntu.com/questions/870530/how-to-install-geckodriver-in-ubuntu) to see how to download and configure it.*NOTE: This program is tested on Ubuntu 18.04 with Python 3.6*## Installation1.`$ pip3 install khed` : Recommended way to install, as it installs all the requirements.OR2. `$ git clone https://github.com/bnu123/Khed`: First clone this repository.`$ pip3 install . `: Then install it.## UsageThis script requires arguments to run, passing script arguments is easy and this script does not have too many arguments.It would be helpful for you if you remember that the backbone of this program is its searching functionality, almost every argument uses search internally.### Searching`-s` or `--search` argument is used for searching an anime.e.g.```$ khed --search=Boku==================================WELCOME, Your search results are :==================================1. Boku dake ga Inai Machi2. Boku no Hero Academia3. Boku no Hero Academia 2nd Season4. Boku no Hero Academia 3rd Season5. Boku no Kanojo ga Majimesugiru Sho-bitch na Ken6. Boku no Kanojo ga Majimesugiru Sho-bitch na Ken OVA7. Boku wa Tomodachi ga Sukunai8. Boku wa Tomodachi ga Sukunai Next9. Bokura ga Ita10. Bokura wa Minna Kawaisou11. Bokurano12. Bokusatsu Tenshi DokuroDownload or access anime info, [y/n]?```From here you can also move-ahead and download any anime or get anime info.*NOTE: Sometimes the search will tell that no anime was found, you can try and then enter the Japanese name of the anime or try to shorten the name , e.g. use Bok instead of Boku no.*### Downloading`-d` or `--download` along with *other arguments* make for a powerful downloader.#### Basic usageFor downloading:  `$ khed -d=anime name`. Now as download uses search internally to lookup for the anime name, the first episode of the first anime (if found) will be downloaded.e.g. following the above example```$ khed --download=Boku```This will download the first episode of `Boku dake ga Inai Machi` which is the anime at 1st index.#### Advanced usageGives a fine grained control over download. This script provides extra arguments along with the `--download` argument to get anime and episodes specifically.e.g.```$ khed --download=Boku --search-index=8 --range=3-5           : This will fetch the 8th (search-index) anime from the searchresult, and download episodes: 3, 4 and 5.: --search-index MUST be correct, if not, a huge error list willbe shown, so it is recommended that you run --search on theanime name before downloading to see the --search-index.$ khed -d Boku -si 8 -r 3-4                                    : Short form for the above.$ khed -d Boku --folder=folder name                            : This specifies the folder to be downloaded to. folderdoes not need to exist, but either must be an *absolute path*or just a name.e.g. /home/user/FOLDER_NAME OR Anime, and correspondingfolder will be created if they does not exist.$ khed -d Boku -r 3-4                                          : --search-index default is 1, so first anime selected.$ khed -d Boku -si 4                                           : --range default is 1, only 1st episode is downloaded.$ khed -d Boku                                                 : This is the basic usage, --range,--search-index default to 1.default folder is "DownloadedAnime" which will be create in your current directory, which is the directory you invoked the command with.```*NOTE `--range` specifies Episode numbers, i.e. `--range=10-20` will include Episode-10,11,12...20*### InformationThis script also allows you to get the anime information. Getting information is similar to downloading an anime.```$ khed --info=BokuWelcome to the info section of animeAvailable info:1. english2. synonyms3. japanese4. type5. episodes6. status7. aired8. premiered9. genres10. duration11. rating12. plotEnter the info name: [[q] quit; [b] back; [d] download]```As shown above, the available info can be used*Note: Unlike `--search` here the info name has to be typed to get the info e.g. `plot` will give the info rather than `12`.Also, there is no use of `--range` as information is only about anime not about episodes, which is what range is for.*Using info:```$ khed --info=Boku --search-index=4                   : Use the 4th anime result from search.$ khed -i Boku -si 4                                  : Short formHelpful if you wan't to know the durations of episodes, or number of episodes.```FOR THE FOLLOWING, NO EXTRA ARGUMENT MUST BE GIVEN, IT MAY RESULT IN ERROR.### Listing GenresYou can see the available genres and download under specific genres.### Most-popularYou can see and download the most-popular animes, although its subjective to website.e.g```$ khed --list-genres        OR      $ khed -l==================================WELCOME, Your search results are :==================================1. Adventure2. Comedy3. Drama4. Erotica5. Fantasy6. Horror7. Mystery8. Psychological9. Romance10. Science fiction11. Thriller12. Tournament13. Adventure... and many more```## IssuesIf you get an error or have any feature request, go ahead and drop an issue. If you would like to work on the issues see the following.## DevelopmentDon't commit to master branch, instead create a branch and then open a new pull requests specifying in short what did you change. Also it is recommended to have single commit per file rather than single commit to multiple files, it helps in reviewing.Also install the program as editable.```$ git clone https://github.com/bnu123/Khed$ pip3 install -e .```So that *no* re-installing has to be done if you made a change to the program.## Motivation And FutureI made this program to learn about python programming and development in general, currently I am working on making it compatible with other Operating Systems.This program is purely for education purpose, you are responsible for its use.