Skip to content

Frequently Asked Questions

General Questions

What is Jellyfin Enhanced?

Jellyfin Enhanced is a comprehensive plugin that bundles advanced features and customizations for Jellyfin. It adds keyboard shortcuts, visual enhancements, Seerr integration, custom pause screens, quality tags, and much more — all in one convenient package.

Can I customize the keyboard shortcuts?

Yes! Open the Jellyfin Enhanced panel by clicking the menu item in the sidebar or pressing ?, then go to the Shortcuts tab. Click on any key to set a custom shortcut. Changes save automatically.

Does this work on mobile apps?

Yes, the plugin works on the official Jellyfin Android and iOS apps, as well as desktop and web UIs. All features are available as long as the app uses Jellyfin's embedded web UI.

Does this work on Android TV or other TV platforms?

No, the plugin does not work on Android TV or other native TV apps. It only functions on clients that use Jellyfin's embedded web UI, such as the official web, desktop, and mobile apps.

Is this plugin affiliated with Seerr?

No, this plugin is not affiliated with Seerr. Seerr is an independent project, and this plugin simply integrates with it to enhance the Jellyfin experience. Please report plugin issues to this repository, not to the Seerr team.

How do I change the plugin's language?

The plugin automatically uses the language set in your Jellyfin user profile. If your language isn't available, it defaults to English. See the Contributing Translations section to help add your language!

Where is the userscript version?

The userscript has been discontinued as the plugin functionality has grown significantly. The last version is available here if you only need basic keyboard shortcuts.

Installation & Setup

Plugin Compatibility

Plugin Jellyfin 10.11 Jellyfin 10.10 Notes
Jellyfin Enhanced ✅ ❌ Use 10.11 manifest

Plugin not appearing after installation?

See this page in Installation Troubleshooting

Scripts not loading after installation

See this page in Installation Troubleshooting

Update not working properly?

See this page in Installation Troubleshooting

I see "permission denied" errors in logs!!

See this page in Installation Troubleshooting, regarding permission issuses

Features & Functionality

Auto-skip intros not working?

Auto-skip requires the Intro Skipper plugin to be installed and configured.

Requirements:

  1. Install Intro Skipper plugin

  2. Enable intro detection in Intro Skipper settings

  3. Run intro detection on your library

  4. Enable auto-skip in Jellyfin Enhanced settings

  5. Intro segments must be detected for your media

Check Detection:

  • Play a video with known intro

  • Look for "Skip Intro" button

  • If button appears, detection works

  • If no button, run intro detection again

Seerr integration not connecting?

Check Configuration:

  1. Verify Seerr URL is correct and accessible

  2. Verify API key is correct (from Seerr Settings → General)

  3. Click "Test Connection" in plugin settings

  4. Check icon status on search page:

  5. 🟢 Active = Working

  6. 🔴 No Access = User not imported
  7. ⚫ Offline = Cannot connect

Enable Jellyfin Sign-In:

  1. In Seerr, go to Settings → Users

  2. Enable "Enable Jellyfin Sign-In"

  3. Import your Jellyfin users

Import Users:

Option A (automatic, recommended):

  1. In Jellyfin, go to Dashboard -> Plugins -> Jellyfin Enhanced -> Seerr Settings

  2. Enable "Auto import Jellyfin users to Seerr"

  3. Optional: click "Import Users Now" to run bulk import immediately

Option B (manual in Seerr):

  1. In Seerr, go to Users page

  2. Click "Import Jellyfin Users"

  3. Select users to import

  4. Save changes

User Access:

  • Users WITH access: Users with access

  • Users WITHOUT access: Users without access

Check Logs:

  1. Browser console (F12) for client errors

  2. Jellyfin server logs for proxy errors

  3. Seerr logs for API errors

Tags not showing on posters?

Enable Feature:

  1. Open Enhanced panel (press ?)

  2. Go to Settings tab

  3. Enable desired tags:

  4. Quality Tags

  5. Genre Tags
  6. Language Tags

  7. Rating Tags

  8. Adjust position if needed

Clear Cache:

  1. Hard refresh browser (Ctrl+F5)

  2. Clear all browser cache

  3. Restart browser

Check Metadata:

  • Quality tags require media file metadata

  • Genre tags require genre information

  • Language tags require audio track data

  • Rating tags require TMDB/RT ratings

Check Console:

  1. Press F12 → Console

  2. Look for tag-related errors

  3. Report issues on GitHub

Bookmarks not syncing across devices?

!!! "How it works"

Bookmarks are stored server-side but settings are per-browser.

- Bookmark data stored on Jellyfin server

- Settings stored in browser `localStorage`

- Each browser has independent settings

- Same user can access bookmarks from any device

Syncing Bookmarks:

  • Bookmarks automatically sync via server

  • Settings must be configured per browser

  • Use same Jellyfin user account

  • Bookmarks appear on all devices

Troubleshooting:

  • Verify same user account

  • Check bookmark file exists on server

  • Look in /config/data/users/{userId}/jellyfin-enhanced/bookmarks.json

  • Check browser console for errors

Pause screen not appearing?

Enable Feature:

  1. Open Enhanced panel

  2. Go to Settings tab

  3. Enable "Custom Pause Screen"

  4. Adjust settings as desired

Check Playback:

  • Must be in fullscreen or theater mode

  • Pause video (press Space)

  • Screen should appear after brief delay

Customize Elements:

See Pause Screen CSS for hiding/styling elements.

Reviews, Elsewhere, or Seerr icons not working?

This is usually due to TMDB API access issues.

TMDB API Blocked:

  • TMDB API may be blocked in your region

  • Check Seerr troubleshooting: TMDB Access

  • Use VPN or proxy if needed

  • Contact your ISP about API access

Check Connection:

  1. Open browser console F12

  2. Look for TMDB-related errors

  3. Check network tab for failed requests

  4. Verify Seerr can access TMDB

"Remove from Continue Watching" is destructive?

Yes, this feature resets playback progress to zero.

How It Works:

  • Removes item from Continue Watching list
  • Resets watch progress to 0%
  • Marks item as unwatched
  • Cannot be undone

Use Cases:

  • Remove items you don't want to continue
  • Clean up Continue Watching section
  • Reset progress for rewatching

Alternative:

  • Mark as played to remove from list
  • Keep progress intact
  • Use Jellyfin's built-in "Mark Played" feature

Customization

How do I customize tag appearance?

Use Custom CSS in Jellyfin settings:

  1. Go to Dashboard → General → Custom CSS
  2. Add your custom styles
  3. Click Save
  4. Refresh browser (Ctrl+F5)

Examples:

Hide Quality Tag
.quality-overlay-label[data-quality="H264"] {
    display: none !important;
}
Change Tag Color
.quality-overlay-label[data-quality="4K"] {
    background-color: purple !important;
}
Adjust Tag Size
.quality-overlay-label {
    font-size: 0.9rem !important;
    padding: 4px 8px !important;
}

See CSS Customization Guide for complete CSS documentation.

How do I upload custom branding?

Requirements:

Steps:

  1. Go to Dashboard → Plugins → Jellyfin Enhanced

  2. Navigate to Other Settings tab

  3. Find Custom Branding section

  4. Upload your images:

  5. Icon Transparent (header logo)

  6. Banner Light (dark theme splash)
  7. Banner Dark (light theme splash)

  8. Favicon (browser icon)

  9. Click Save

  10. Force refresh Ctrl+F5

Image Requirements:

  • PNG or SVG format recommended

  • Transparent backgrounds for logos

  • Appropriate dimensions for each type

  • Files stored in plugin config folder

Can I change tag positions?

Yes, via Enhanced panel settings:

  1. Open Enhanced panel (press ?)

  2. Go to Settings tab

  3. Find tag position options

  4. Select position (top-left, top-right, bottom-left, bottom-right)

  5. Changes apply immediately

Advanced Positioning:

Change tag positions
.quality-overlay-container {
    top: 10px !important;
    right: 10px !important;
}

Troubleshooting

How do I gather logs for bug reports?

Browser Console Logs:

  1. Press F12 to open developer tools

  2. Go to Console tab

  3. Filter by 🪼Jellyfin Enhanced

  4. Look for errors (red text)

  5. Copy error messages

  6. Include in bug report

Network Logs:

  1. Press F12 → Network tab

  2. Filter by JellyfinEnhanced

  3. Look for failed requests (red)

  4. Check status codes

  5. Include in bug report

Server Logs:

  1. Go to Dashboard → Logs

  2. Look for JellyfinEnhanced entries

  3. Check log files: JellyfinEnhanced_yyyy-mm-dd.log

  4. Copy relevant errors

  5. Include in bug report

What to Include:

  • Plugin version

  • Jellyfin version

  • Browser and version

  • Operating system

  • Steps to reproduce

  • Console errors

  • Server log errors

  • Screenshots if applicable

Common error messages and solutions

Error Solution
Access to the path '/jellyfin/jellyfin-web/index.html' is denied. Install file-transformation plugin or follow Docker workaround
Access to the path 'C:\Program Files\Jellyfin\Server\jellyfin-web\index.html' is denied. Grant "NETWORK SERVICE" Read/Write permissions to Jellyfin folder
Plugin installed but scripts don't load Run "Jellyfin Enhanced Startup" scheduled task, verify trigger exists
Reviews/Elsewhere/Seerr icons not working TMDB API may be blocked in your region, see Seerr troubleshooting
Seerr search not working Enable "Jellyfin Sign-In" in Seerr. Then either enable plugin auto import and run "Import Users Now", or import users manually in Seerr. Also verify user is not in blocked users list.
Tags not appearing Enable in settings, clear cache, verify metadata exists
Bookmarks not saving Check server logs, verify user data folder permissions

Plugin conflicts?

Known Conflicts:

  • None currently documented

Potential Issues:

  • Multiple JavaScript injection plugins

  • Custom CSS overriding plugin styles

  • Browser extensions blocking scripts

Troubleshooting:

  1. Disable other plugins temporarily

  2. Test with clean browser profile

  3. Check for CSS conflicts

  4. Disable browser extensions

  5. Report conflicts on GitHub

Performance issues?

Optimization Tips:

  1. Disable unused features in settings

  2. Reduce number of visible tags

  3. Clear browser cache regularly

  4. Use modern browser version

  5. Check server resources

Heavy Features:

  • Seerr discovery pages (many API calls)

  • People tags (age calculations)

  • Multiple tag types enabled

  • Large bookmark collections

Improve Performance:

  • Enable only needed features

  • Use tag filters to reduce display

  • Clear old bookmarks

  • Limit Seerr results

How can I contribute translations?

How can I request features?

How can I report bugs?

Support & Community

Where can I get help?

Official Channels:

Before Asking:

  1. Read this FAQ
  2. Check Installation Guide
  3. Review Enhanced Features Guide
  4. Search existing issues
  5. Check browser console for errors

When Asking for Help:

  • Describe the problem clearly
  • Include plugin and Jellyfin versions
  • Provide browser and OS info
  • Share relevant logs
  • Include screenshots if helpful
  • Be patient and respectful

Other projects by n00bcodr

Still Have Questions?

If your question isn't answered here:

  1. Search GitHub Discussions
  2. Ask in Discord Community
  3. Create a GitHub Issue