Important: There's a chance ani-skip may not recognize the anime you're watching. It leverages the aniskip API. If an anime's episode(s) are missing, you can contribute or request its inclusion on their discord server.

Should you run into problems, first ensure you're using the most recent version:

• For Linux:

  sudo ani-skip -U

• For Windows: Open Git Bash as an administrator and enter:

  ani-skip -U

If the issue remains unresolved, please create a new issue.

ani-skip -h

    Usage:
    ani-skip [OPTIONS]

    Options:
      -q, --query
        Search query for anime title
      -i, --id
        Direct source ID (MyAnimeList or AllAnime ID)
      -e, --episode
        Specify the episode number
      -s, --source
        Source for ID/query resolution (myanimelist, allanime). 
        [default: myanimelist]
      -f, --filter
        Regex to filter search results for disambiguation (used with -q)
      --toggle
        Enable keybind in mpv to toggle skipping on/off.
        When enabled, skips always while active (default: skip once).
        [default key: 'T' (shift+t), set ANI_SKIP_TOGGLE_KEY to customize]
      -o, --offset <seconds>
        End skip N seconds early to avoid missing episode content
        [max: 5, default: 0]
      -V, --version
        Show the version of the script
      -h, --help
        Show this help message and exit
      -U, --update
        Update to the latest version

    Either -q or -i is required.

    Some example usages:
      ani-skip -i 52299 -e 5 # MAL ID directly
      ani-skip -i "ReooPAxPMsHM4KPMY" -s allanime -e 12 # AllAnime ID directly
      ani-skip -q "Solo Leveling" -e 3 # Search MAL (default)
      ani-skip -q "one piece" -s allanime -f "^1P$" -e 12 # Search AllAnime with filter
      ani-skip -q "Solo Leveling" -s allanime -f "Season 2" -e 1 # Season disambiguation

ani-skip -q "Solo Leveling" -e 3

--chapters-file=/tmp/tempfile --script-opts=skip-op_start=130.531,skip-op_end=220.531,skip-ed_start=1326.58,skip-ed_end=1416.58

AllAnime stores malId for each show, so querying it directly avoids the title mismatch issues that occur when anime have non-standard display names (e.g. "1P" for One Piece).

ani-skip -q "one piece" -s allanime -f "^1P$" -e 12

Use -f with a regex to disambiguate results (exact match, season selection, etc).

Pass a MAL or AllAnime ID directly to skip the search step entirely. This is the ideal path for ani-cli integration since it already has the AllAnime _id.

# AllAnime ID
ani-skip -i "ReooPAxPMsHM4KPMY" -s allanime -e 12

# MAL ID
ani-skip -i 52299 -e 5

By default, openings and endings are skipped once — you can seek back to watch them again. Use --toggle to enable the T (shift+t) keybind in mpv for toggling skipping on/off (skips always while active). Use --offset to end the skip a few seconds early. Set ANI_SKIP_TOGGLE_KEY to customize the keybind.

# Toggle keybind enabled, ending skip 3 seconds early
ani-skip -i 52299 -e 3 --toggle -o 3

Omit -e to just resolve and print the MAL ID.

ani-skip -q "Solo Leveling"

52299

For Arch Linux, ani-skip is available in the AUR as ani-skip-git.

Install mpv and fzf before running the install script.

• Linux:

  sudo apt install mpv fzf

• Windows / WSL:

  Make sure scoop is installed. WSL users must install mpv on Windows, not inside WSL.

  scoop install mpv fzf

Works on Linux, WSL, and Git Bash. Installs ani-skip to PATH and skip.lua to the correct mpv scripts directory.

curl -sL https://raw.githubusercontent.com/synacktraa/ani-skip/master/install | sh

curl -sL https://raw.githubusercontent.com/synacktraa/ani-skip/master/uninstall | sh