anipy-demo.mp4

Little tool written in python to watch and download anime from the terminal (the better way to watch anime), also applicable as an API.

Scrapes: https://gogoanime.gg

If you dont like to use a cli there is a GUI and other versions here.

Contents

• Installation
• Usage
• Libary Usage
• What it can do
• Other Versions
• Credits

Installation

Recommended installation:

python3 -m pip install anipy-cli --upgrade

Directly from the repo (may be newer):

python3 -m pip install git+https://github.com/sdaqo/anipy-cli

Other methodes can be found in docs/install.md

For Videoplayback mpv is needed get it here: https://mpv.io/installation/

Optionally you can install ffmpeg to download m3u8 playlists instead of the internal downloader. Use it with the -f flag. This is something you only want to enable when the internal downlaoder fails, since its pretty slow.

Config

Copy config.py to config_personal.py and make your changes there.

Your changes will persist upgrades.

Also, don't delete the original config.py, it will detect if config_personal.py is present.

Usage

usage: anipy_cli.py [-h] [-q QUALITY] [-H] [-D] [-d] [-B] [-S] [-f] [-c] [-o] [-a] [-s] [-v]

Play Animes from gogoanime in local video-player or Download them.

options:
  -h, --help            show this help message and exit
  -q QUALITY, --quality QUALITY
                        Change the quality of the video, accepts: best, worst or 360, 480, 720 etc. Default: best
  -H, --history         Show your history of watched anime
  -D, --download        Download mode. Download multiple episodes like so: first_number-second_number (e.g. 1-3)
  -d, --delete-history  Delete your History.
  -B, --binge           Binge mode. Binge multiple episodes like so: first_number-second_number (e.g. 1-3)
  -S, --seasonal        Seasonal Anime mode. Bulk download or binge watch newest episodes.
  -f, --ffmpeg          Use ffmpeg to download m3u8 playlists, may be more stable but is way slower than internal downloader
  -c, --config          Print path to the config file.
  -o, --no-kitsu        Turn off search in season. Disables prompting if kitsu is to be searched for anime in specific season.
  -a, --auto-update     Automatically update and download all Anime in seasonals list from start EP to newest.
  -s, --syncplay        Use Syncplay to watch Anime with your Friends.
  -v, --vlc             Use VLC instead of mpv as video-player

What it can do

• Faster than watching in the browser.
• Play Animes in Your Local video player
• Select a quality in which the video will be played/downloaded.
• Download Animes
• History of watched Episodes
• Binge Mode to watch a range of episodes back-to-back.
• Seasonal Mode to bulk download or binge watch the latest episodes of animes you pick
• Configurable with config
• (Optional) Search Kitsu for animes in specific seasons. Avalible for the dwonload cli and the seasonal mode. Turn it off with -o flag.
• (Optional) Discord Presence for the anime you currently watch. This is off by default, activate it in the config (-c)
• (Optional) Ffmpeg to download m3u8 playlists, may be more stable but is slower than internal downloader.

Libary Usage

Documentation can be found here

Important:

To import the libary dont import anipy-cli, but anipy_cli (no '-' is allowed)

Other versions

• GUI Frontend by me (WIP): https://github.com/sdaqo/anipy-gui
• Dmenu script by @Dabbing-Guy: https://github.com/Dabbing-Guy/anipy-dmenu
• Ulauncher extension by @Dankni95 (not maintained): https://github.com/Dankni95/ulauncher-anime

Credits

Heavily inspired by https://github.com/pystardust/ani-cli/

All contributors for contributing