anipy-cli 2.5.9

Little tool in python to watch anime from the terminal (the better way to watch anime)

https://user-images.githubusercontent.com/63876564/162056019-ed0e7a60-78f6-4a2c-bc73-9be5dc2a4f07.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

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

If you start the program for the first time the config file gets created automatically

Places of the config:

• Linux: ~/.config/anipy-cli/config.yaml
• Windows: %USERPROFILE%/AppData/Local/anipy-cli/config.yaml
• MacOS: ~/.config/anipy-cli/config.yaml

Sample Config

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