Update readme

master
Vishnunarayan K I 2018-06-26 19:11:48 +05:30
parent a0a4bcb235
commit 04e54be60e
2 changed files with 10 additions and 80 deletions

View File

@ -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.*

View File

@ -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()
```