SubMiner/backlog/tasks/task-108 - Add-AniSkip-intro-skip-OSD-button.md

id, title, status, assignee, created_date, updated_date, labels, dependencies, priority, ordinal

id	title	status	assignee	created_date	updated_date	labels	dependencies	priority	ordinal
TASK-108	Add AniSkip intro skip markers and OSD skip button in mpv plugin	In Progress	codex	2026-02-22 08:05	2026-02-22 09:26	feature mpv intro-skip		high	98100

Description

Wire plugin/subminer.lua to call AniSkip API, parse intro skip window, add skip markers/chapters to mpv, and show an OSD skip button while playback is inside the intro range.

Action Steps

1. Add configurable AniSkip options + state in plugin.
2. Resolve anime id + episode from mpv metadata/filename.
3. Fetch AniSkip skip-times API and parse OP interval.
4. Create/update chapters for OP marker.
5. Render clickable OSD skip button while inside OP range.
6. Add manual script message to retry fetch.
7. Update plugin docs/config comments.

Acceptance Criteria

• #1 Plugin calls AniSkip API and handles missing data gracefully.
• #2 Intro marker/chapter is visible in mpv when OP range exists.
• #3 OSD skip button appears only while inside OP range.
• #4 Clicking/activating button seeks to OP end.
• #5 Docs/config include new options + script message.

Implementation Notes

Linked to user request on 2026-02-22 for porting intro skip via AniSkip.

• Follow-up implemented per user request:
  • launcher now runs guessit for file targets and passes subminer-aniskip_title, subminer-aniskip_season, subminer-aniskip_episode via mpv --script-opts
  • fallback metadata path passes filename-derived title when guessit is unavailable/empty
  • intro hint now displays for first 3 seconds from intro start (You can skip by pressing y-k)
• Runtime bugfix follow-up:
  • always binds y-k fallback key for intro skip, even when custom aniskip_button_key configured
  • intro skip handler now shows explicit OSD reason if skip is unavailable or outside intro window
• Validation:
  • bun test launcher/aniskip-metadata.test.ts
  • bun test launcher/mpv.test.ts
  • luac -p plugin/subminer.lua
  • bun run tsc --noEmit

Definition of Done

• #1 Focused plugin smoke validation in mpv.
• #2 Lua parse/load check passes in local environment.
• #3 Task notes capture fallback behavior.