How 4o66/jellyfin-plugin-additional-material works
Additional Material is a Jellyfin plugin that exposes matching ZIP archives as downloadable course, section, and lesson material. The main workflow runs from the web client through the plugin API, which locates an archive and serves its contents or a short-lived signed download. Separately, optional archive building plans and writes archives from library files; an external helper script offers a similar workflow. The graph includes README-documented web and configuration capabilities, but source excerpts are partial, so some internal links are omitted where call ownership is not shown.
Main entry points: AdditionalMaterialController.cs Material API · MaterialIndex.cs Folder index · ArchiveWriter.cs Archive writer · Building.cs Archive builder
Components 19
Web client
- Web client script
src/Jellyfin.Plugin.AdditionalMaterial/Web/additional-material.js
Plugin API
- Material API
src/Jellyfin.Plugin.AdditionalMaterial/Api/AdditionalMaterialController.cs - Archive contents
src/Jellyfin.Plugin.AdditionalMaterial/Services/ArchiveContents.cs - Signed links
src/Jellyfin.Plugin.AdditionalMaterial/Services/LinkSigner.cs
Material discovery
- Material locator
src/Jellyfin.Plugin.AdditionalMaterial/Services/MaterialLocator.cs - Folder index
src/Jellyfin.Plugin.AdditionalMaterial/Services/MaterialIndex.cs - Index refresh task
src/Jellyfin.Plugin.AdditionalMaterial/Services/IndexRefreshTask.cs - Startup indexing
src/Jellyfin.Plugin.AdditionalMaterial/Services/FreshIndexStartupFilter.cs - Course watcher
src/Jellyfin.Plugin.AdditionalMaterial/Services/NewCourseWatcher.cs
Archive building
- Archive builder
src/Jellyfin.Plugin.AdditionalMaterial/Services/Building.cs - Archive planner
src/Jellyfin.Plugin.AdditionalMaterial/Planning/Planner.cs - Active content scan
src/Jellyfin.Plugin.AdditionalMaterial/Planning/ActiveContent.cs - Archive writer
src/Jellyfin.Plugin.AdditionalMaterial/Planning/ArchiveWriter.cs - Packaging rules
src/Jellyfin.Plugin.AdditionalMaterial/Planning/Rules.cs - Archive helper
tools/make_additional_material.py
Configuration and integration
- Plugin settings
src/Jellyfin.Plugin.AdditionalMaterial/Configuration/PluginConfiguration.cs - Plugin registration
src/Jellyfin.Plugin.AdditionalMaterial/Plugin.cs - Web injection task
src/Jellyfin.Plugin.AdditionalMaterial/Services/WebInjectionTask.cs
Other components
- Jellyfin user
Connections 22
- Jellyfin user → Web client script: uses
README.md - Web client script → Material API: requests material
README.md - Material API → Material locator: locates archive
src/Jellyfin.Plugin.AdditionalMaterial/Api/AdditionalMaterialController.cs - Material API → Archive contents: lists files
src/Jellyfin.Plugin.AdditionalMaterial/Api/AdditionalMaterialController.cs - Material API → Signed links: signs downloads
src/Jellyfin.Plugin.AdditionalMaterial/Api/AdditionalMaterialController.cs - Material API → Folder index: refreshes status
src/Jellyfin.Plugin.AdditionalMaterial/Api/AdditionalMaterialController.cs - Material API → Archive writer: rebuilds archives
src/Jellyfin.Plugin.AdditionalMaterial/Api/AdditionalMaterialController.cs - Archive contents → Folder index: uses index
src/Jellyfin.Plugin.AdditionalMaterial/Services/ArchiveContents.cs - Material locator → Folder index: checks folders
src/Jellyfin.Plugin.AdditionalMaterial/Services/MaterialLocator.cs - Archive builder → Archive planner: plans archives
src/Jellyfin.Plugin.AdditionalMaterial/Services/Building.cs - Archive builder → Archive writer: writes archives
src/Jellyfin.Plugin.AdditionalMaterial/Services/Building.cs - Archive builder → Folder index: updates index
src/Jellyfin.Plugin.AdditionalMaterial/Services/Building.cs - Archive planner → Active content scan: scans files
src/Jellyfin.Plugin.AdditionalMaterial/Planning/Planner.cs - Archive writer → Active content scan: checks content
src/Jellyfin.Plugin.AdditionalMaterial/Planning/ArchiveWriter.cs - Archive writer → Packaging rules: applies rules
src/Jellyfin.Plugin.AdditionalMaterial/Planning/ArchiveWriter.cs - Course watcher → Folder index: refreshes folders
src/Jellyfin.Plugin.AdditionalMaterial/Services/NewCourseWatcher.cs - Startup indexing → Folder index: initializes index
- Index refresh task → Folder index: refreshes index
- Archive helper → Packaging rules: uses rule files
- Plugin settings → Plugin registration: configures plugin
src/Jellyfin.Plugin.AdditionalMaterial/Configuration/PluginConfiguration.cs - Plugin registration → Web injection task: registers web task
src/Jellyfin.Plugin.AdditionalMaterial/Services/WebInjectionTask.cs - Web injection task → Web client script: injects button