From 04e54be60e11d91e7a1469e2b9dec72159c3fda9 Mon Sep 17 00:00:00 2001 From: Vishnunarayan K I Date: Tue, 26 Jun 2018 19:11:48 +0530 Subject: [PATCH] Update readme --- README.md | 57 +++++++++--------------------------------------- package_usage.md | 33 ---------------------------- 2 files changed, 10 insertions(+), 80 deletions(-) delete mode 100644 package_usage.md diff --git a/README.md b/README.md index 6d31093..6d0c9da 100644 --- a/README.md +++ b/README.md @@ -40,7 +40,7 @@ You can install the stable release from PyPI. $ pip install anime-downloader ``` -To install with cloudflare support, +To install with cloudflare support, (Read note below) ```bash $ pip install anime-downloader[cloudflare] ``` @@ -55,67 +55,30 @@ $ pip install -U git+https://github.com/vn-ki/anime-downloader.git#egg=anime-dow If you have trouble installing, see extended installation instructions [here](https://github.com/vn-ki/anime-downloader/wiki/Installation). -**IMP**: +**NOTE**: - For cloudflare scraping [cfscrape](https://github.com/Anorov/cloudflare-scrape) is used. It depends on [`node-js`](https://nodejs.org/en/). So if you want to use cloudflare, make sure you have [node-js](https://nodejs.org/en/) installed. - You might have to use pip3 depending on your system - If you are using zsh, don't forget to escape `[` and `]` using `\`. ## Usage -Anime downloader has two sub commands, `dl` and `watch`. You can find the documentation in [wiki](https://github.com/vn-ki/anime-downloader/wiki) +See [wiki](https://github.com/vn-ki/anime-downloader/wiki). + +Anime downloader has two sub commands, `dl` and `watch`. - [dl](https://github.com/vn-ki/anime-downloader/wiki/dl-command): `dl` can download anime. -- [watch](https://github.com/vn-ki/anime-downloader/wiki/watch-command): `watch` can manage your anime watching. Needs [mpv](https://mpv.io). With `watch` you'll never have to go to any anime sites ever again. - -#### Search and download - -- To search and download all episodes. -```bash -anime dl 'code geass' -``` -*NOTE: The above command shows the search results (which would fit you're terminal size :innocent:) and you can select the desired result.* - -#### Download directly -- To download Fullmetal Alchemist: Brotherhood all episodes -``` -anime dl 'https://9anime.is/watch/fullmetal-alchemist-brotherhood.0r7/j69y93' -``` - -- To download Fullmetal Alchemist: Brotherhood episode 1 -``` -anime dl 'https://9anime.is/watch/fullmetal-alchemist-brotherhood.0r7/j69y93' --episodes 1 -``` - -- To download Fullmetal Alchemist: Brotherhood episode 1 to 20 -``` -anime dl 'https://9anime.is/watch/fullmetal-alchemist-brotherhood.0r7/j69y93' --episodes 1:21 -``` - -- To get stream url of Fullmetal Alchemist: Brotherhood episode 1. -``` -anime dl 'https://9anime.is/watch/fullmetal-alchemist-brotherhood.0r7/j69y93' --url --episodes 1 -``` - -- To play using vlc. (On windows use path to exe) -``` -anime dl 'https://9anime.is/watch/fullmetal-alchemist-brotherhood.0r7/j69y93' --play vlc --episodes 1 -``` +- [watch](https://github.com/vn-ki/anime-downloader/wiki/watch-command): `watch` can manage your anime watch list. Needs [mpv](https://mpv.io). With `watch` you'll never have to go to any anime sites ever again. ### To use `anime_downloader` in your package This tool can be used as a library. This means you can import it into your own application and search for anime and do many other wonderful things. -See [documentation](https://github.com/vn-ki/anime-downloader/blob/master/package_usage.md). +See [documentation](https://github.com/vn-ki/anime-downloader/wiki/Package-documentation). -## Development Instructions +### Development Instructions -``` bash -# Clone this repo -$ git clone https://github.com/vn-ki/anime-downloader.git +See [wiki](https://github.com/vn-ki/anime-downloader/wiki/Development-Instructions) -# Run setup.py -$ cd anime-downloader -$ pip install -e . -``` +--- *Please don't judge me for not paying for anime. I want to support these animation studios, but being a college student, I can't.* diff --git a/package_usage.md b/package_usage.md deleted file mode 100644 index 1530ce9..0000000 --- a/package_usage.md +++ /dev/null @@ -1,33 +0,0 @@ -# Documentation - -`anime_downloader` is designed to be used in your own package too. - -```python -from anime_downloader import NineAnime - -anime = NineAnime('https://www4.9anime.is/watch/dragon-ball-super-dub.r65p', quality='480p') - -print(anime.title) -print(len(anime)) -``` -`quality` can any of `['360p', '480p', '720p']`. If not this line will raise `AnimeDlError`. - -```python -ep = anime[0] -``` -The type of `ep` is `NineAnimeEpisode`. -```python -print(ep.title) -ep.downloader(path='/home/vn-ki/Downloads/anime/dbs') -``` - -### Example to download all episodes of dbs. - -```python -from anime_downloader import NineAnime - -anime = NineAnime('https://www4.9anime.is/watch/dragon-ball-super-dub.r65p', quality='480p') - -for ep in anime: - ep.download() -```