{"id":17690095,"url":"https://github.com/justchokingaround/jerry","last_synced_at":"2025-04-09T22:18:18.249Z","repository":{"id":65356333,"uuid":"581498921","full_name":"justchokingaround/jerry","owner":"justchokingaround","description":"watch anime with automatic anilist syncing and other cool stuff","archived":false,"fork":false,"pushed_at":"2024-12-04T19:34:50.000Z","size":13872,"stargazers_count":313,"open_issues_count":21,"forks_count":20,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-09T22:18:13.425Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/justchokingaround.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-12-23T11:15:13.000Z","updated_at":"2025-03-30T12:01:55.000Z","dependencies_parsed_at":"2023-10-04T09:05:45.529Z","dependency_job_id":"696e73d6-9046-4c90-a251-54ff1d9ad684","html_url":"https://github.com/justchokingaround/jerry","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justchokingaround%2Fjerry","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justchokingaround%2Fjerry/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justchokingaround%2Fjerry/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justchokingaround%2Fjerry/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/justchokingaround","download_url":"https://codeload.github.com/justchokingaround/jerry/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248119286,"owners_count":21050755,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-24T11:49:47.996Z","updated_at":"2025-04-09T22:18:18.227Z","avatar_url":"https://github.com/justchokingaround.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Showcase\n\nhttps://github.com/justchokingaround/jerry/assets/44473782/c73b0dd9-9637-439f-a5fb-aa8012b0a496\n\n![image](https://github.com/justchokingaround/jerry/assets/44473782/9f49b6e1-a07a-4610-b893-6a5ab816c40b)\n\n\n# Jerry\nThe 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).\n\nBut the script also has a lot of other features, which you can find in the features section.\n\n## Join the discord server (it is bridged to the matrix space)\n\n### https://discord.gg/JTDS2CKjQU\n\n## Join the matrix server (I am more active there)\n\n### https://matrix.to/#/#lobster-and-jerry:matrix.org\n\n---\n## Table of Contents\n- [Features](#features-please-check-the-wiki-for-configuration-information)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Configuration](#configuration)\n- [Dependencies](#dependencies)\n- [Credits](#credits)\n\n## Features (please check the wiki for configuration information)\n- Multiple providers: allanime (default), aniwatch, yugen, hdrezka and crunchyroll (requires token or email and password)\n- Sync watch progress on Anilist on episode completion, and locally (down to the second watched, just like YouTube and Netflix does it)\n![progress](./assets/progress.png)\n\n- Customize subtitle language, video quality, provider and many other things (using arguments or config file)\n![language](./assets/language.png)\n![language_and_progress](./assets/language_and_progress.png)\n\n- Discord Rich Presence: display currently watched anime in Discord (currently requires the installation of the helper python script: `jerrydiscordpresence.py`)\n![presence](./assets/presence.png)\n\n- 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)\n![external_menu](./assets/external_menu.png)\n![rofi_image_preview](./assets/rofi_image_preview.png)\n\n- Output episode links in JSON format\n\n\n## Installation\n### Linux/macOS\n```sh\nsudo curl -sL github.com/justchokingaround/jerry/raw/main/jerry.sh -o /usr/local/bin/jerry \u0026\u0026\nsudo chmod +x /usr/local/bin/jerry\n```\n\n\u003cdetails\u003e\n\u003csummary\u003eWindows installation instructions\u003c/summary\u003e\n\n* This guide covers how to install and use jerry with the Windows Terminal (which comes pre-installed with Windows 11), you could also use a different terminal emulator, that supports fzf, like for example Wezterm\n* Note that the Git Bash terminal does *not* have proper \nfzf support\n\nBasically, what we are going to do is install the bash shell and use it to install the shell script. We will also install the mpv video player and fzf, which are required for the script to work.\n\n1. Install scoop\n\nOpen a PowerShell terminal https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.2#msi (version 5.1 or later) and run:\n\n```ps\nSet-ExecutionPolicy RemoteSigned -Scope CurrentUser\nirm get.scoop.sh | iex\n```\n\n2. Install git,mpv and fzf\n\n```ps\nscoop bucket add extras\nscoop install git extras/mpv fzf\n```\n3. Install windows terminal (you don't need to have a microsoft account for that)\n   https://learn.microsoft.com/en-us/windows/terminal/install\n\n4. Install git bash (select the option to add it to the windows terminal during installation)\n   https://git-scm.com/download/win\n\n(The next steps are to be done in the windows terminal, in a bash shell)\n\n5. Download the script file to the current directory\n```sh\ncurl -O \"https://raw.githubusercontent.com/justchokingaround/jerry/main/jerry.sh\"\n```\n\n6. Give it executable permissions\n```sh\nchmod +x jerry.sh\n```\n\n7. Copy the script to path\n```sh\ncp jerry.sh /usr/bin/jerry\n```\n\n8. Use jerry\n```sh\njerry --help\n```\n\n\u003c/details\u003e\n\n\n## Usage\n```\nUsage: jerry [options] [query]\nIf a query is provided, it will be used to search for an anime, and will default to the 'Watch New' option.\n\nOptions:\n    -c, --continue\n      Continue watching from currently watching list (using the user's anilist account)\n    --dub\n      Allows user to watch anime in dub\n    -d, --discord\n      Display currently watching anime in Discord Rich Presence (jerrydiscordpresence.py is required for this, check the wiki for instructions on how to install it)\n    -e, --edit\n      Edit config file using an editor defined with jerry_editor in the config (\\$EDITOR by default)\n      If a config file does not exist, creates one with a default configuration\n    -h, --help\n      Show this help message and exit\n    -i, --image-preview\n      Allows image preveiw in fzf and rofi\n    -j, --json\n      Outputs the json containing video links, subtitle links, referrers etc. to stdout\n    -l, --language\n      Specify the subtitle language\n    -n, --number\n      Specify the episode number for an anime\n    --rofi, --dmenu, --external-menu\n      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)\n    -q, --quality\n      Specify the video quality\n    -s, --syncplay\n      Watch anime together with friends, using Syncplay (only tested using mpv)\n    -u, --update\n      Update the script\n    -v, --version\n      Show the script version\n    -w, --website\n      Choose which website to get video links from (default: allanime) (currently supported: allanime, aniwatch, yugen, hdrezka, and crunchyroll)\n\n  Note: \n    All arguments can be specified in the config file as well.\n    If an argument is specified in both the config file and the command line, the command line argument will be used.\n\n  Some example usages:\n   jerry -q 720 banana fish\n   jerry --rofi -l russian cyberpunk edgerunners -i -n 2\n   jerry -l spanish cyberpunk edgerunners --number 2 --json\n```\n## Configuration\n\nYou 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) :\n```sh\njerry -e\n```\n\nFor more information on the configuration file, please check the wiki.\n\n## Dependencies\n- grep\n- sed\n- curl\n- fzf\n- mpv (Video Player)\n- rofi (optional)\n- ueberzugpp (image preview in fzf) (optional)\n- jq (for displaying anime/manga info) (optional)\n\n## Credits\n- Anilist API: [https://anilist.co/api/](https://anilist.gitbook.io/anilist-apiv2-docs)https://anilist.gitbook.io/anilist-apiv2-docs\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustchokingaround%2Fjerry","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjustchokingaround%2Fjerry","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustchokingaround%2Fjerry/lists"}