KefinTweaks

<div align="center" style="display: flex; align-items: center; flex-wrap: wrap; justify-content: center;"> <picture style="width: 80%;"> <source srcset="logo_text_dark2.png" media="(prefers-color-scheme: dark)"> <img src="logo_text_light2.png" alt="Your project logo"> </picture> </div> <hr style="background: #b4c5fb !important;">

KefinTweaks is a comprehensive collection of enhancements and customizations for Jellyfin, focused on, but not limited to, filling gaps in functionality based on the community's most desired Feature Requests. This includes things like a Watchlist, a customizable Home Screen, an improved search experience, and an Appearance Manager.

While working on these scripts to meet my personal needs, I noticed that there was a lot of overlap between the functionality I desire and many of the requested features by the community so I thought it would be a good idea to share this for anyone who may be interested.

Since I began working on this in August 2025, the scope of the project has grown and changed drastically. This began as a small set of tweaks to enhance my own personal server, but has evolved into a robust set of features that aim to compliment and enhance the native Jellyfin experience in a way that feels like it is native functionality.

In the future, we can hope that the majority of this plugin will become obsolete as we will see many of these changes implemented and included in the native Jellyfin experience, as the community has so long desired!

I think it's also worth mentioning that before the 1.0 release, you can expect to potentially encounter some issues or bugs. I try to address these as quickly as I can, and I appreciate your time for raising the issues in the first place!

Note: The Slideshow at the top of the Home Screen in the video below is from the MediaBar plugin by IAmParadox27 and MakD.

Table of Contents

• Installation
  • Prerequisites
  • Setup Instructions
• Configuration
• Features Overview
  • Data Caching
  • Community Requests Progress
    • Feature Requests Completed
    • Feature Requests Planned
  • Core Features
    • Watchlist
      • Watchlist Page
      • Series Progress Page
      • Movie History Page
      • User Statistics Page
      • Export/Import
    • Enhanced Home Screen
    • Enhanced Search
  • UI Enhancements
    • Watchlist Support
    • Skin Manager
  • UX Improvements
    • Subtitle Search
    • Remove from Continue Watching
    • Collection Sorting
  • Navigation Improvements
    • Header Tab Enhancements
    • Breadcrumb Navigation
    • Custom Menu Integration
    • Playlist Screen Improvement
    • Flatten Single Season Shows
    • Collections on Movie/Series Details page
  • System Improvements
    • Performance & Stability
    • Branding & Customization
• Script Details
  • Dependency Scripts
  • Feature Scripts
  • Auto-Inject Dependencies
  • Info For Developers
• Client Support
• Changes to default Jellyfin functionality
• Design Philosophy
• AI Disclaimer
• License
• Acknowledgments
• Support
• FAQ
• Roadmap
  • Planned Features
  • Version History

Installation

Prerequisites

• Jellyfin 10.10.7 or earlier (10.11.X is untested and "unsupported" but may be mostly functional)
• JS Injector plugin installed and configured
• File Transformation Plugin plugin is recommended to avoid file permission issues when injecting scripts with JS Injector
• Only required for Watchlist: Custom Tabs plugin

Setup Instructions

0. Install the Prerequisites listed above
1. Add a new script to your JS Injector Plugin
2. Copy the code below, paste it into the new script, save your changes and refresh the page

const script = document.createElement("script");
script.src = `https://cdn.jsdelivr.net/gh/ranaldsgift/KefinTweaks@latest/kefinTweaks-plugin.js`;
script.async = true;
document.head.appendChild(script);

If you are hosting the script yourself, replace the https://cdn.jsdelivr.net/gh/ranaldsgift/KefinTweaks@latest/ with your hosted location + /KefinTweaks/. You should be able to include the scripts in your jelly-web folder and access it from /web/KefinTweaks if you like.

3. Navigate to the Plugins page and click on KefinTweaks
4. Choose your preferred plugin version, or specify a custom source if you are self hosting the scripts
5. Press Install! KefinTweaks will automatically load without refreshing the page

<div align="center"> <img src="pages/images/plugin-install.gif" alt="injector" style="max-width: 100%; height: auto;"/> </div> <br/> <hr style="background: #b4c5fb !important;">

Configuration

KefinTweaks includes a comprehensive configuration interface accessible to administrators. The configuration UI allows you to customize all aspects of KefinTweaks without editing code files.

Accessing Configuration

The configuration interface can be accessed in multiple ways:

1. From Dashboard: In the Dashboard side menu, find the "KefinTweaks" button under the Plugins section.
2. From Left Navigation Menu: A "Configure" link will appear in the left navigation menu beneath a KefinTweaks heading.
3. From User Preferences: Navigate to your User Preferences page and find the "Administration" section. Click the "Configure KefinTweaks" button.

Configuration Features

All configuration options for KefinTweaks can be managed directly from the UI.

• Feature Toggle: Toggle individual KefinTweaks features on or off
• Home Screen Configuration: Configure custom sections, discovery features, and seasonal content
• Search Configuration: Enable/disable Jellyseerr integration
• Skin Configuration: Manage available skins, set default skins, and enable/disable specific skins
• Theme Configuration: Add custom themes available to all users
• Exclusive Elsewhere Configuration: Configure branding behavior
• Custom Menu Links: Add custom links to the navigation menu
• Script Root URLs: Configure custom script hosting locations (advanced)

Export and Import

• Export: Export your entire configuration to clipboard as JSON for backup or sharing
• Import: Import a previously exported configuration to restore settings or apply configurations from other servers

<div align="center"> <img src="pages/images/config-1.png" alt="Configuration Interface" style="max-width: 100%; height: auto;"/> </div> <br/> <div align="center"> <img src="pages/images/config-2.png" alt="Configuration Interface" style="max-width: 100%; height: auto;"/> </div> <br/>

Automatic Setup

On first load, KefinTweaks automatically:

• Creates the KefinTweaks-Config script in the JavaScript Injector plugin with default settings
• Ensures the Watchlist tab exists in the CustomTabs plugin with the correct HTML structure

These tasks only run for administrator users and happen automatically in the background.

<hr style="background: #b4c5fb !important;">

Uninstallation

1. Navigate to the Plugins page and click on KefinTweaks
2. Press Uninstall and click to confirm

<div align="center"> <img src="pages/images/plugin-uninstall.gif" alt="injector" style="max-width: 100%; height: auto;"/> </div> <br/> <hr style="background: #b4c5fb !important;">

Features Overview

KefinTweaks provides a modular system of enhancements that can be individually enabled or disabled based on your needs. Each script is designed to work independently while sharing common utilities and dependencies.

As mentioned above, most of the functionality included in KefinTweaks are features that have been requested by the community. Some of these requests have been pending for 5 years or more. I feel that a lot of the top requests have functionality that is essential to the Jellyfin experience but I have also included less requested features, as well as some things that I just personally needed or wanted.

Data Caching

One thing that I feel is worth pointing out is the way in which some of the data needed by KefinTweaks is handled. For most of the features, data is grabbed on demand as normal, same as any existing Jellyfin functionality. However there are specific features, or subsets of features which do use local device caching in order to either improve performance, or simply because it is not fe