NeXroll v1.12.0-beta.1 Release Notes

Release Date: March 11, 2026
Type: Pre-release (Beta)

First beta of v1.12.0 introducing full Emby support and overhauled Jellyfin/Emby plugin integration with auto-detection and remote configuration.

New Features

Emby Server Support

• Full Emby integration as a first-class media server alongside Plex and Jellyfin
• NeXroll Intros Plugin for Emby — Implements Emby's IIntroProvider interface to inject prerolls via Cinema Mode
• Connect/disconnect via the Connect tab with Emby URL and API key
• Plugin auto-caches preroll files locally and registers them with Emby's library system
• Prerolls respect your active schedules, fillers, and sequences in real time

Plugin Auto-Detection & Remote Configuration

• Detect Plugin button on both Jellyfin and Emby connection pages
• NeXroll queries the media server's plugin API to check if the NeXroll Intros plugin is installed
• Configure Plugin pushes your NeXroll URL, auto-generated API key, and path mappings directly to the plugin — no need to manually edit plugin settings on each server
• Auto-generated API keys are scoped read-only and rotated on each configure

Emby Plugin — Technical Details

• Downloads all active prerolls to a local cache (%LocalAppData%\NeXroll\intro_cache\)
• GetAllIntroFiles() returns cached paths so Emby registers them as library items during the "Refresh Custom Intros" scheduled task
• GetIntros() fetches the current active list from NeXroll at playback time and selects from the cache
• Cache syncs every 10 minutes to pick up schedule changes
• Default MaxIntros is 1 when unset (prevents all prerolls playing at once)
• SHA256-based file naming for cache deduplication

Backend Endpoints

• GET /emby/plugin/detect — Detects the NeXroll Intros plugin on a connected Emby server
• POST /emby/plugin/configure — Pushes configuration to the Emby plugin remotely
• GET /jellyfin/plugin/detect — Detects the NeXroll Intros plugin on a connected Jellyfin server
• POST /jellyfin/plugin/configure — Pushes configuration to the Jellyfin plugin remotely

Frontend Updates

Emby Connection Page

• Full Emby connection UI matching the existing Plex and Jellyfin pages
• Plugin detection panel with 4-state UI: not checked → detecting → detected → not found
• Plugin configuration panel with NeXroll URL, path mapping, and one-click configure
• Auto-detect runs on page load when Emby is connected

Jellyfin Connection Page

• Added the same plugin detection and configuration UI as Emby
• Replaces the previous manual-only plugin setup workflow

Documentation

New Wiki Pages

• Emby Setup — Complete guide: plugin install, Cinema Mode configuration, Refresh Custom Intros task, troubleshooting
• Jellyfin Setup — Complete guide: plugin install, configuration, troubleshooting

Updated Wiki Pages

• Home — Updated to v1.12.0, added Emby as supported platform
• Getting Started — Added plugin install step, per-server verification, Emby connection steps
• Installation — Updated requirements to include Emby 4.8+
• FAQ — Added Emby support questions, replaced outdated Local Intros plugin references
• Troubleshooting — Added Jellyfin/Emby troubleshooting sections
• Sidebar — Added Media Server Setup section with Jellyfin and Emby links
• Path Mappings — Added plugin-level path mapping notes
• Configuration — Added emby log category

Important Notes

Emby Cinema Mode Requirements

For prerolls to play in Emby, these settings must be enabled:

1. Cinema Mode → On (requires Emby Premiere)
2. Enable intros for Movies and/or Episodes
3. "Include trailers from my movies in my library" — this is required for locally-cached plugin intros to be recognized

Refresh Custom Intros

After first plugin setup or adding new prerolls, run Scheduled Tasks → Refresh Custom Intros in Emby Dashboard to register cached files. This task also runs automatically on schedule.

Upgrade Notes

• No database migration required — drop-in replacement
• Windows: Run the installer or replace NeXroll.exe
• Docker: Pull the latest image
• Emby plugin: Copy NeXroll.Emby.dll to Emby's plugins/ folder (not a subfolder) and restart Emby
• Jellyfin plugin: Copy NeXroll.Jellyfin.dll to Jellyfin's plugins/NeXroll Intros/ folder and restart Jellyfin