Showcase

jerry_demo.mp4

Jerry

Jerry is a command line tool for streaming anime from various providers. It can search for and play anime, continue watching from the currently watching list, and has various options for customization. The core idea of the script is that it allows users to watch anime in sync with their anilist account, automatically updating and tracking all progress (down to seconds of an episode watched).

Join the discord server!

https://discord.gg/JTDS2CKjQU

---

Table of Contents

• Features
• Installation
• Usage
• Configuration
• Dependencies
• Credits

Features

• Search for and stream anime from various providers (currently supported: 9anime/aniwave, zoro/aniwatch, yugen and hdrezka) (default: 9anime/aniwave) (some providers, such as aniwatch and have support for external subtitles which allows more freedom)
• Sync watch progress on Anilist on episode completion, and locally (down to the second watched, just like YouTube and Netflix does it)
• Customize subtitle language, video quality, provider and many other things (using arguments or config file)
• Edit the configuration file using the command line
• Update the script from GitHub
• Discord Rich Presence: display currently watched anime in Discord (requires the installation of the helper python script: jerrydiscordpresence.py)
• External menu support: ability to use rofi, so that opening a terminal window isn't even required to run the script !! (this can be used to setting the script to run on a keybind)
• Output episode links in JSON format

Installation

Linux

sudo curl -sL github.com/justchokingaround/jerry/raw/main/jerry.sh -o /usr/local/bin/jerry &&
sudo chmod +x /usr/local/bin/jerry

Optional: Discord Rich Presence (requires python3 and the python packages: pypresence and httpx)

sudo curl -sL github.com/justchokingaround/jerry/raw/main/jerrydiscordpresence.py -o /usr/local/bin/jerrydiscordpresence.py &&
sudo chmod +x /usr/local/bin/jerrydiscordpresence.py

---

Mac

pip install httpx pypresence
curl -sL github.com/justchokingaround/jerry/raw/main/jerry.sh -o "$(brew --prefix)"/bin/jerry &&
chmod +x "$(brew --prefix)"/bin/jerry

Optional: Discord Rich Presence (requires python3 and the python packages: pypresence and httpx)

curl -sL github.com/justchokingaround/jerry/raw/main/jerrydiscordpresence.py -o "$(brew --prefix)"/bin/jerrydiscordpresence.py
chmod +x "$(brew --prefix)"/bin/jerrydiscordpresence.py

Usage

Usage: jerry [options] [query]
If a query is provided, it will be used to search for an anime, and will default to the 'Watch New' option.

Options:
    -c, --continue
      Continue watching from currently watching list (using the user's anilist account)
    --dub
      Allows user to watch anime in dub
    -e, --edit
      Edit config file using an editor defined with jerry_editor in the config (\$EDITOR by default)
      If a config file does not exist, creates one with a default configuration
    -h, --help
      Show this help message and exit
    -i, --image-preview
      Allows image preveiw in fzf and rofi (Note: for image preview using fzf, ueberzugpp must be installed)
    -j, --json
      Outputs the json containing video links, subtitle links, referrers etc. to stdout
    -l, --language
      Specify the subtitle language
    -n, --number
      Specify the episode number for an anime
    --rofi, --dmenu, --external-menu
      Use an external menu (instead of the default fzf) to select an anime (default one is rofi, but this can be specified in the config file)
    -q, --quality
      Specify the video quality
    -s, --syncplay
      Watch anime together with friends, using Syncplay (only tested using mpv)
    -u, --update
      Update the script
    -v, --version
      Show the script version
    -w, --website
      Choose which website to get video links from (default: 9anime) (currently supported: 9anime, kaido and yugen)

  Note: 
    All arguments can be specified in the config file as well.
    If an argument is specified in both the config file and the command line, the command line argument will be used.

  Some example usages:
   jerry -q 720 banana fish
   jerry --rofi -l russian cyberpunk edgerunners -i -n 2
   jerry -l spanish cyberpunk edgerunners --number 2 --json

Configuration

You can use the following command to edit your jerry configuration (in case a configuration file does not exist, a default one will be created, containing all the default values) :

jerry -e

Dependencies

• grep
• sed
• curl
• fzf
• mpv (Video Player)
• rofi (optional)
• ueberuzgpp (image preview in fzf) (optional)
• jq (for displaying anime/manga info) (optional)

Credits

• Anilist API: https://anilist.co/api/