mirror of
https://github.com/ksyasuda/SubMiner.git
synced 2026-07-31 19:21:33 -07:00
sudacode
e64ff1a0ee
- 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)
54 lines
2.8 KiB
Markdown
54 lines
2.8 KiB
Markdown
# AniSkip Integration
|
|
|
|
SubMiner integrates with [AniSkip](https://aniskip.com) 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:
|
|
|
|
```jsonc
|
|
{
|
|
"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`](https://github.com/guessit-io/guessit):
|
|
|
|
```bash
|
|
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.
|