https://github.com/intro-skipper/intro-skipper
Automatically detect and skip intro/credit sequences in Jellyfin
https://github.com/intro-skipper/intro-skipper
jellyfin jellyfin-mediasegment-provider jellyfin-plugin
Last synced: about 2 months ago
JSON representation
Automatically detect and skip intro/credit sequences in Jellyfin
- Host: GitHub
- URL: https://github.com/intro-skipper/intro-skipper
- Owner: intro-skipper
- License: gpl-3.0
- Created: 2023-10-02T13:04:36.000Z (over 2 years ago)
- Default Branch: 10.11
- Last Pushed: 2026-04-27T05:23:21.000Z (about 2 months ago)
- Last Synced: 2026-04-27T06:33:37.559Z (about 2 months ago)
- Topics: jellyfin, jellyfin-mediasegment-provider, jellyfin-plugin
- Language: C#
- Homepage: https://discord.intro-skipper.org
- Size: 3.72 MB
- Stars: 2,276
- Watchers: 11
- Forks: 138
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-jellyfin - intro-skipper - Fingerprint audio to automatically detect intro and outro segments in Jellyfin. (🧩 Plugins / ▶️ Playback)
- starred - intro-skipper/intro-skipper - Automatically detect and skip intro/credit sequences in Jellyfin (C# #)
README
# Intro Skipper
Analyzes the audio of television episodes to detect and skip over intros.
[](https://github.com/intro-skipper/intro-skipper/actions/workflows/codeql.yml)
## Manifest URL (All Jellyfin Versions)
> [!NOTE]
> If the plugin does not appear after adding the repository:
> * Check that you are using the latest Jellyfin version
> * Reload the plugin page without cache (`CTRL + F5` for Windows/Linux or `SHIFT + CMD + R` for macOS)
```
https://intro-skipper.org/manifest.json
```
**Important: This URL returns a manifest based on the Jellyfin version used to access it.
It will NOT return a manifest when viewed in a browser, as no Jellyfin version is provided.**
### As of Jellyfin 10.10, Intro Skipper does **NOT** modify the UI.
## Optional: File Transformation plugin
Some web UI features (for example, adjusting the skip-button timeout) require the File Transformation plugin. If it’s not installed, Intro Skipper will still work, but those enhancements won’t be applied.
Click here to see how to install the File Transformation plugin
- Plugin repo: https://github.com/IAmParadox27/jellyfin-plugin-file-transformation
- Easiest way to install:
- Add as a plugin source repository to your Jellyfin server.
```
https://www.iamparadox.dev/jellyfin/plugins/manifest.json
```
- Find "File Transformation" in the Catalog and install it.
## System requirements
* Jellyfin 10.11.6 (or newer)
* Jellyfin's [fork](https://github.com/jellyfin/jellyfin-ffmpeg) of `ffmpeg` must be installed, version `7.1.1-7` or newer
* `jellyfin/jellyfin` 10.11.z container: preinstalled
* `linuxserver/jellyfin` 10.11.z container: preinstalled
* Debian Linux based native installs: provided by the `jellyfin-ffmpeg7` package
* MacOS native installs: build ffmpeg with chromaprint support ([instructions](https://github.com/intro-skipper/intro-skipper/wiki/Custom-FFMPEG-(MacOS)))
* Gentoo Linux native installs: enable `xarblu-overlay` and install `media-video/jellyfin-ffmpeg`
## Policies
- [Code of conduct](https://github.com/intro-skipper/.github/blob/main/CODE_OF_CONDUCT.md)
- [Privacy policy](https://github.com/intro-skipper/.github/blob/main/PRIVACY.md)
## Disclaimer
This plugin is licensed under the [GNU General Public License v3.0](https://github.com/intro-skipper/intro-skipper/blob/10.11/LICENSE).
It is provided as-is, without warranty of any kind, express or implied. Use it at your own
risk. The authors accept no liability for data loss, missed detections,
false positives, or any other damages arising from its use.
Audio fingerprints (Chromaprint), silence detection, and black frame
detection data generated by this plugin are derived entirely from your
own local media files. No claim of ownership is made over any generated
fingerprint or detection data by the plugin authors. Any data you
generate is your responsibility. Sharing or redistributing such data
beyond purely local, personal use may violate the licenses, terms of
service, or other agreements governing the underlying media or software.
You are solely responsible for researching and complying with all
applicable terms before doing so. The authors make no representations
about your right to use, distribute, or commercialize this data, and
expressly disclaim any liability arising from such use.
This project is not affiliated with, endorsed by, or officially
connected to the Jellyfin project or any media rights holder. Chromaprint
is included as part of [jellyfin-ffmpeg](https://github.com/jellyfin/jellyfin-ffmpeg) and is subject to its own
respective licenses. "Jellyfin" and any related trademarks belong to
their respective owners.
## [Detection parameters](https://github.com/intro-skipper/intro-skipper/wiki#detection-parameters)
## [Detection types](https://github.com/intro-skipper/intro-skipper/wiki#detection-types)
## [Installation](https://github.com/intro-skipper/intro-skipper/wiki/Installation)
- #### [Install the plugin](https://github.com/intro-skipper/intro-skipper/wiki/Installation#step-1-install-the-plugin)
- #### [Verify the plugin](https://github.com/intro-skipper/intro-skipper/wiki/Installation#step-2-verify-the-plugin)
- #### [Custom FFMPEG (MacOS)](https://github.com/intro-skipper/intro-skipper/wiki/Custom-FFMPEG-(MacOS))
## [Jellyfin Skip Options](https://github.com/intro-skipper/intro-skipper/wiki/Jellyfin-Skip-Options)
## [Troubleshooting](https://github.com/intro-skipper/intro-skipper/wiki/Troubleshooting)
- #### [Plugin not shown in Catalog](https://github.com/intro-skipper/intro-skipper/wiki/Troubleshooting#plugin-not-shown-in-catalog)
- #### [Scheduled tasks fail instantly](https://github.com/intro-skipper/intro-skipper/wiki/Troubleshooting#scheduled-tasks-fail-instantly)
- #### [Skip button is not visible](https://github.com/intro-skipper/intro-skipper/wiki/Troubleshooting#skip-button-is-not-visible)
## Sponsors
Companies that kindly allow us to use their stuff:
| [DigitalOcean](https://www.digitalocean.com/?refcode=8471e96eb6dd) | [SignPath](https://signpath.org/) |
|-|-
| [](https://www.digitalocean.com/) | [ ](https://signpath.org/) |
| Hosting of various services | Free code signing provided by [SignPath.io](https://about.signpath.io/), certificate by [SignPath Foundation](https://signpath.org/).