Files
SubMiner/docs-site/aniskip-integration.md
T
sudacode e64ff1a0ee feat(anime): add anime browser powered by Aniyomi extensions
- Add `subminer anime` / `--anime` and a tray entry to open a browser that searches installed Aniyomi extension sources, shows cover art and episodes, and plays into mpv with overlay/mining attached
- Add an Extensions tab to add repos and install/update/remove sources, and per-source settings for sources needing config
- Support searching all sources at once with streaming, per-source results and status
- Prefer Japanese audio/subtitle tracks from the source and keep the primary subtitle slot reserved for Japanese
- Fix window/tray/Dock handling so the browser and mpv can be switched between without quitting the app or losing the Dock icon
- Add anime.repos, anime.extensionsDir, anime.preferredQuality config keys (no bundled repos or discovery)
2026-07-31 17:21:12 -07:00

2.8 KiB

AniSkip Integration

SubMiner integrates with AniSkip to automatically detect anime intro intervals and let you skip them with a single key press.

Intro detection runs in the SubMiner app over the mpv IPC socket. It is available whenever the overlay is connected to mpv - not just at launch - and covers every local file loaded during an mpv session, including playlist advances.

Setup

AniSkip is enabled by default. Disable it or change the skip key in your config:

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

Both settings hot-reload: changing them in your config takes effect immediately without restarting playback or mpv.

For best title and episode detection, install guessit:

python3 -m pip install --user guessit

Without guessit, SubMiner falls back to an internal filename parser which handles most common naming conventions but may miss unusual formats.

How It Works

On each local file load:

  1. SubMiner infers the anime title, season, and episode number from the filename and path (using guessit if available, otherwise the built-in parser). Remote URLs are skipped entirely.
  2. The title is matched against MyAnimeList to resolve a MAL id.
  3. SubMiner queries the AniSkip API for an OP skip interval for that MAL id and episode.
  4. If an interval is found, SubMiner adds AniSkip Intro Start and AniSkip Intro End chapter markers to the current file and binds the skip key (mpv.aniskipButtonKey, default TAB).
  5. At the start of the intro, an OSD prompt appears for 3 seconds: You can skip by pressing TAB (reflects your configured key). Pressing the key at any point during the intro seeks to the intro end.

When a custom key (other than TAB or y-k) is configured, the legacy y-k chord is also bound as a fallback skip trigger.

Results are cached per file for the app session; only definitive "no intro found" results are cached, so transient lookup failures are retried on the next file load. Reload detection is also handled: if mpv reloads the same file, SubMiner re-applies the chapter markers without a new API lookup.

Triggering from mpv

You can trigger AniSkip actions from mpv script-messages:

Command Effect
script-message subminer-skip-intro Skip to the intro end immediately (same as pressing the key)
script-message subminer-aniskip-refresh Force a fresh lookup for the current file, discarding any cached result

These are handled by the SubMiner app over the IPC socket.