Files
SubMiner/docs-site/aniskip-integration.md
T
sudacode 8825cca642 docs: rewrite docs site pages to be shorter and easier to scan
- Pages now start with setup and usage, and reference material is in compact tables
- Configuration reference gives each config block a short explanation and a key/default table
- Internal detail removed from user pages, and docs that had drifted from current behavior fixed
- The status line shows today's date, set on the client, instead of the page's last-updated date
- Add changelog fragment
2026-09-24 16:20:42 -07:00

1.5 KiB

AniSkip integration

SubMiner looks up opening timestamps on AniSkip so you can skip an anime's intro with one key.

Setup

AniSkip is on by default. To turn it off or change the key:

{
  "mpv": {
    "aniskipEnabled": true,
    "aniskipButtonKey": "TAB",
  },
}

Both settings apply immediately, without restarting mpv. For better title and episode detection, install guessit:

python3 -m pip install --user guessit

Usage

When a local file loads, SubMiner reads the title and episode from the file name, finds the show on MyAnimeList, and asks AniSkip for the intro's timestamps. Streams and URLs are skipped.

If AniSkip has an intro, SubMiner adds AniSkip Intro Start and AniSkip Intro End chapters. When the intro starts, mpv shows "You can skip by pressing TAB" (with your key) for 3 seconds. Press the key any time during the intro to jump to its end.

With a custom key other than TAB or y-k, y-k also skips.

Triggering from mpv

Command What it does
script-message subminer-skip-intro Skip to the end of the intro
script-message subminer-aniskip-refresh Look up the current file again, ignoring cached results

Use subminer-aniskip-refresh after a lookup failed or matched the wrong show.