mikesilvo/skiptro repository overview

⁠Skiptro

Automatic TV show intro detection for Kodi.

If you find Skiptro useful, buy me a coffee⁠ ☕

Skiptro uses audio fingerprinting and machine learning to detect TV show intros across episodes in a season, then exports skip markers that Kodi can use to automatically skip them during playback.

⁠Features

• Detects intros by comparing audio across episodes in a season
• Exports skip markers for the companion Kodi add-on⁠
• EDL export for Kodi's built-in auto-skip
• Theme audio export (MP3) for tvtunes⁠ integration
• Optional ffmpeg chapter file export
• Docker support for headless/NAS deployments (Unraid, Synology, etc.)
• Self-contained — FFmpeg and ML model bundled, no dependencies required
• Platforms: Windows x64, Linux x64/ARM64, macOS x64/ARM64

⁠Quick Start

docker run -d \
  --name skiptro \
  -v skiptro-data:/root/.config/Skiptro \
  -v /path/to/tv:/media/tv \
  -e MEDIA_PATHS=/media/tv \
  -e SCAN_SCHEDULE="0 3 * * *" \
  mikesilvo/skiptro:latest

Media libraries listed in MEDIA_PATHS (comma-separated) are auto-registered on startup. The container runs a cron job on the configured schedule. Manual scans:

docker exec skiptro /app/skiptro scan --all --export

⁠Links

• Releases & Documentation⁠
• Kodi Add-on⁠
• Ko-fi⁠