Jellyfin 12.0

We are pleased to bring you Jellyfin 12.0, our caller unchangeable release. This merchandise continues successful the aforesaid guidance arsenic 10.11: finishing what the database conversion started, turning that caller instauration into existent capacity work, and yet giving books and comics the support they person deserved for years.

If you conscionable want a speedy summary of what you request to cognize to get your strategy upgraded and running, please publication connected to the "TL; DR" conception conscionable below, aliases support reference for a afloat mentation of each the awesome features and improvements successful Jellyfin 12.0! You tin besides position afloat changelogs connected the server and web GitHub releases.

- Cody

TL; DR​

1. As ever for awesome upgrades, guarantee you STOP Jellyfin and return a FULL MANUAL BACKUP OF YOUR DATA AND CONFIG DIRECTORIES earlier upgrading!

2. You must beryllium moving Jellyfin 10.10.7 aliases immoderate 10.11.x release earlier upgrading to 12.0. Upgrading straight from 10.11.x is afloat supported and nary intermediate measurement is needed. If you are connected thing older than 10.10.7, upgrade to 10.10.7 first, past upgrade to 12.0.

3. Check your usernames earlier upgrading. Usernames are now lawsuit insensitive, truthful 2 accounts can't person names that only disagree by capitalization. If you person users that lucifer this shape the database migration will fail.

4. A afloat room scan is REQUIRED aft upgrading. As portion of fixing really alternate versions are stored, versions that Jellyfin grouped automatically, not ones you merged yourself, are cleared during the upgrade. Until you tally the scan those versions will look for illustration they are missing.

5. The first scan aft upgrading will return importantly longer than normal, and immoderate movies whitethorn look arsenic recently added. This is expected. Jellyfin now checks each point successful your room against the files connected disk to clear retired leftovers from erstwhile versions, and thing that was antecedently revenge incorrectly gets corrected arsenic it goes. Do not extremity the server while migrations are running.

6. Once installed, please guarantee you difficult refresh (e.g. Ctrl+Shift+R aliases similar) and/or clear your web cache for your Jellyfin lawsuit if you announcement immoderate UX anomalies. Bad cached assets are the #1 origin of specified issues.

7. Remove immoderate third-party plugins earlier upgrading. Plugins built for 10.11 will not load connected 12.0 and request updated builds from their authors, truthful springiness them clip to drawback up earlier adding them back. Official plugins person been updated for 12.0 support.

8. Very aged third-party clients will extremity working. Support for the bequest /emby/ and /mediabrowser/ addresses has been removed, and the deprecated measurement of signing successful is now disabled, including connected existing servers. Clients that person not seen an update successful years are the ones astatine consequence here.

9. This merchandise contains information fixes, truthful we urge upgrading alternatively than staying connected an older merchandise erstwhile you are ready.

10. As ever pinch awesome Jellyfin releases, bugs will exist. Please prefix bug reports pinch "[12.0]" truthful we tin triage them quickly, and spot constituent 1 1 much time: take a backup.

And now connected to the cool caller features!

Why 12.0?​

The astir visible alteration successful this merchandise is the 1 successful its name: we are dropping the awesome type "10" from our naming scheme. What would person been 10.12.0 is simply 12.0, and the server reports its type arsenic 12.0.0. 10.11.x was the past merchandise branch to usage the aged scheme.

The logic is the feedback we sewage aft 10.11.0, which we first raised successful January and confirmed successful May. A merchandise for illustration 10.11.0 was, by immoderate reasonable measure, a awesome merchandise - it rewrote the room database - but the type number presented it arsenic a insignificant update, and group upgraded pinch expectations to match. The starring 10. ne'er changed and ne'er told anyone anything, truthful each it did was push the number that really mattered into the mediate position and make "major" releases look minor. Dropping it intends the first number moves erstwhile the merchandise is big.

If you support thing that parses Jellyfin type strings - a client, a monitoring check, a deployment script, a instrumentality tag pin - this is the point to look astatine earlier upgrading.

Tuning the caller database​

Jellyfin 10.11.0 vanished rebuilding really the room database works, which opened the doorway for the capacity activity successful this release. We aren't finished, but you should announcement a large quality erstwhile browsing.

One of the largest changes is really playlists and collections are stored. Before, everything successful a playlist was kept arsenic 1 large database wrong the playlist itself, and the database couldn't look into that list. Anything we needed to cognize meant loading the full playlist and unpacking it first. Getting the point count, moving retired really overmuch you've watched, aliases showing a azygous page each costs the aforesaid arsenic loading the full thing. Editing was the aforesaid story, because adding aliases removing 1 point meant penning the full database backmost out.

Every point successful a playlist is now its ain row. The database tin count rows, return 1 page, and adhd aliases region a azygous point without rubbing the rest, truthful this should beryllium a large betterment connected ample playlists. Collections and boxsets were stored the aforesaid measurement and get the aforesaid fix.

Alongside that:

• Deleting a ample number of items astatine erstwhile nary longer fails partway through.
• Continue Watching, Next Up, rewatching, Latest Media for music, creator lookups, and the watched counts connected folders should beryllium faster.
• Heavy database attraction nary longer runs during a room scan, truthful the 2 extremity competing for the aforesaid resources.

Most of this shows up arsenic pages that utilized to frost nary longer freezing.

One point to statement is that this activity went into really Jellyfin sounds your library, not into the room scanner. You whitethorn find the scanner is simply a small quicker arsenic a broadside effect, but speeding it up was not a extremity this clip around.

What runs connected first boot​

As usual, a caller merchandise of Jellyfin comes pinch aggregate database migrations. These migrations will return a while to complete depending connected the size of your room and really overmuch bad information has been accumulated.

If you would alternatively tally that measurement deliberately than person it hap connected first commencement the server now accepts --mode MigrateSystem, which performs the upgrade and exits without starting the remainder of Jellyfin.

Multiple versions for episodes​

Alternate versions person been a movies-only characteristic since they were introduced. In 12.0 they activity for episodes arsenic well, truthful a bid pinch a broadcast trim and an extended cut, aliases a 1080p and a 4K transcript of the aforesaid episode, tin beryllium grouped the measurement movies ever could. This includes resume information that follows the type you were really watching.

This is besides the characteristic down the required post-upgrade scan: making versions activity correctly for episodes meant fixing really type links are stored, and automatically resolved versions person to beryllium rebuilt from the files connected disk.

Books and comics, decently this time​

Books person often taken a backseat successful favour of video playback successful Jellyfin, and this merchandise is the commencement of an effort to alteration that. Most of what the Bookshelf plugin utilized to do now has been moved to the server itself.

On the server:

• Book metadata is publication straight from OPF and ComicInfo files, aliases from ComicBookInfo comments, pinch nary plugin required.
• Posters are generated for EPUBs and each supported comic archive format, and outer covers activity for audiobook files.
• Name, index, year, and bid are publication from book filenames, and measurement and section numbers are picked up from comic filenames erstwhile they are there.
• Page counts are extracted from comic archives and PDFs.
• Chapters are extracted from audiobooks.
• Bookshelf has been divided into abstracted GoogleBooks and ComicVine providers, and a caller OpenLibrary plugin provides metadata and images.
• ISBN outer IDs and links are supported.

In the web client:

• There is simply a Modern book room layout pinch position types and paging, positive Authors, Collections, and Folders tabs.
• Books show accusation astir their authors, and authors show their books and audiobooks.
• The reference interface has been redesigned and standardized crossed each book types, pinch unified fullscreen behaviour and swipe navigation for PDFs.
• Progress indicators activity again for supported eBooks, sorting by scale number and merchandise day is available, and font size action for EPUBs has been improved.
• Background audiobook playback useful connected iOS devices.

Better recommendations, and a hunt that plugins tin extend​

Where "more for illustration this" and the proposal rows get their ideas from is nary longer fixed. You now take the root per room successful the aforesaid spot you already prime metadata providers, truthful you tin usage 1 root for movies and a different 1 for music.

ListenBrainz ships pinch the server arsenic 1 of those sources. Point your euphony room astatine it and similar-artist suggestions travel from existent listening information alternatively than from tags alone.

Search useful the aforesaid measurement now: a plugin tin adhd its ain results alongside Jellyfin's own. If you person ever wanted Jellyfin to hunt location other astatine the aforesaid time, that is simply a plugin now alternatively than a fork. Both systems are written up for plugin authors successful the merchandise notes.

The Modern layout is now the default​

The layout that shipped arsenic "experimental" is now simply the Modern layout, and connected desktop and mobile it is the default for anyone who has not explicitly chosen otherwise. The erstwhile layout is still disposable and is now called Legacy. Televisions are unchanged: TV devices proceed to usage the TV layout, which still runs connected the bequest app.

Alongside making it the default, the layout sewage the polish that implies:

• All themes - Dark, Light, WMC, Blue Radiance, Apple TV, and Purple Haze - now deduce from a shared guidelines taxable built connected CSS variables. If you support a civilization theme, this is worthy a look.
• The room toolbar has been merged into the app bar, pinch a sticky room header.
• Collections and playlists tabs are disposable connected each libraries, and collections look connected point specifications pages.
• Music Videos, Mixed Media, Collections and Playlists, and Books views were each updated, and Home Videos and Photos libraries gained default tab options and a files view.
• New filters for audio and subtitle languages, a Reset Filters button, and workplace search.

Changes you whitethorn announcement aft upgrading​

A fewer things behave otherwise than they did connected 10.11, beyond the bequest customer removals covered above:

• Subtitle settings are now configured per library alternatively than erstwhile for the full server, truthful the aged server-wide subtitle options nary longer exist.
• Sorting is much consistent, which does mean immoderate libraries will beryllium ordered somewhat otherwise than you are utilized to.
• Artwork is nary longer stretched past its existent size. Low solution posters now look astatine their existent size alternatively of being blown up to fit, which looks smaller but sharper.
• .ogg files are treated arsenic audio, not video. If you had .ogg video files, they will beryllium re-sorted connected the adjacent scan.
• Usernames tin now beryllium changed betwixt precocious and little case. As portion of that, 2 accounts tin nary longer person names that disagree only by capitalization. If your server has usernames that disagree only by capitalization, the database migration will fail.
• Symlinked media is followed erstwhile thing is played alternatively than erstwhile the room is scanned.

Security​

This merchandise includes a number of information fixes connected some the server and the web client. Several of them adjacent disconnected ways a crafted petition could scope files extracurricular the directories Jellyfin is expected to serve. Others forestall the setup wizard being re-run connected a misconfigured server without signing in, cull plugin packages pinch unsafe names, use parental controls successful much places, and hole cross-site scripting issues successful the web client.

New Features & Enhancements​

User Experience - Web Client​

• A "still watching" prompt.
• , and . scrub frame-by-frame during playback.
• Chapter names look successful the preview bubble arsenic you resistance on the activity bar, and the playback info overlay is much compact while showing much detail.
• Folders tin beryllium marked arsenic played.
• An improved Upcoming view, and Play All and Shuffle buttons connected bid libraries.
• The screensaver is suppressed while viewing photos aliases reading, and a screensaver clip mounting is disposable successful the Modern layout.
• Crew members pinch aggregate roles are merged into a azygous card, and TV show creators look connected point details.
• A configurable hold for the photograph slideshow.
• The web customer caches much information successful your browser, truthful screens you person already visited travel backmost faster, and artwork nary longer looks blurry connected precocious solution displays.
• Game controller navigation fixes, keyboard shortcuts that activity connected non-Latin keyboard layouts, and support for rewind and accelerated guardant buttons connected remotes.

Administrator Experience - Web Client​

• The log spectator tin travel a log unrecorded alternatively of needing a refresh.
• Sorting and filtering connected the Activity page.
• The root of similar-item and proposal information is configurable per library.
• Jellyfin now marks its cache directories pinch CACHEDIR.tag, truthful backup devices cognize to skip them alternatively of backing up these files.
• Clients tin inquire for responses successful a circumstantial language, truthful a server pinch users who for illustration different languages behaves better.
• The database record tin beryllium kept location different than the default location.
• Disabled plugins are nary longer re-enabled connected restart.
• Backups nary longer neglect outright erstwhile they deed a corrupt record, and you now get a informing earlier restoring a backup, aliases earlier starting 1 while a room scan is running.
• A restyled startup interface that shows type and activity information.
• Collections and playlists tin beryllium filtered by library, truthful each room tin show only its own.
• More ways to select erstwhile searching for people, the action to for illustration a title's original connection for audio, and the caller "Collections" listing connected point pages.
• Live TV: XMLTV inheritance images and section thumbnails are imported, unreachable "server-local" streaming URLs are nary longer returned to clients, and XMLTV guideline imports now skip programs whose information has not changed, making repetition guideline refreshes considerably cheaper.
• Metadata: TVDB IDs activity for movies, AudioDb creator search, ReplayGain medium summation is publication from euphony files, MusicBrainz lookups are much resilient, WEB-DL tags successful filenames are recognized, and supplier IDs tin beryllium group connected play and section files names.
• Curly braces and parentheses are now supported, on pinch the existing quadrate brackets, for parsing Provider Identifier values. New aliases are besides supported: tvdb for tvdbid, imdb for imdbid, and tmdb for tmdbid.
• The optimize database task now analyzes and vacuums the DB erstwhile triggered and astatine shutdown.
• The Refresh People task now decently cleans up removed group and checks for updates for group pinch missing images.
• Live TV: EPG now honors SchedulesDirect API correction codes, preventing lockouts. HDHomeRun tuners will now nonstop play connected clients that support it. M3U tuners will nary longer nonstop play and will alternatively default to remuxing.
• The playlist room image tin now beryllium group for each users done the Metadata Manager. Duplicate tracks are now allowed successful playlists.

Transcoding and Media Handling​

• We person moved to the caller upstream FFmpeg 8.1.
• Optimized CUDA transposing, OCL scaling, and OCL tonemapping performance, the past of these specifically connected Mali GPUs.
• HLG tonemapping now uses the EOTF from BT.2446 Method B.
• A spec-compliant dvh1 HLS version for Dolby Vision Profile 5 for amended instrumentality compatibility.
• Fixed a imaginable A/V desync successful HLS erstwhile transcoding video while remuxing audio.
• Subtitle penning now goes done SubtitleEdit, which avoids the aged SSA to ASS conversion and the nonaccomplishment of styling that came pinch it.
• VobSub subtitle support, outer subtitles tin beryllium embedded into MKS erstwhile transcoding, the subtitle extraction timeout is configurable, and image-based subtitles tin beryllium rendered by the customer during remuxing.
• A instrumentality floor plan action for Android TV boxes that cannot grip rotated video, truthful telephone footage changeable sideways plays the correct measurement up.
• Trickplay picks up files that already beryllium connected scan alternatively of regenerating them, nary longer produces duplicates for interlaced video, useful pinch bad timestamps successful the root file, and cleans up aft itself erstwhile procreation fails.
• Better instrumentality support successful the web client: Dolby Vision successful MKV files connected webOS 25 and newer, AV1 nonstop streaming connected TV clients, anamorphic video nonstop play connected Tizen, and connected iOS some inheritance playback pinch the surface disconnected and a hole for audio normalization affecting transportation and speed.

Client Development Changes​

The pursuing changes use to each customer exertion developers. Please reappraisal thoroughly and update your applications arsenic required.

HTTP API​

• Deprecated authorization mechanisms are now abnormal by default. See the specifications successful this propulsion request if you person not migrated yet.
• GetItems is now asynchronous and applies recursive erstwhile filters are requested, constricted to requests that see includeItemTypes. The aforesaid query tin return a different consequence group than it did connected 10.11.
• ItemByName responses are restricted and group are deduplicated.
• Newly obsolete but still functional: GetTrailers (use GetItems pinch includeItemTypes=Trailer), GetArtists and GetAlbumArtists (use GetPersons), GetArtistByName (use GetPerson), GetMusicGenre (use GetGenre), the euphony genre instant operation endpoints (use GetInstantMixFromItem), GetRecordingsSeries, and the startup routes (use the configuration endpoints). UserDto.HasPassword is besides obsolete and nary longer provides useful information. The HLS controllers are hidden from the specification.
• Swashbuckle has been updated to v10, which changes the generated OpenAPI document. SDKs request to beryllium regenerated.
• Removed routes: POST /Users/\{userId\}/EasyPassword, GET /Items/\{itemId\}/CriticReviews, GET /Environment/NetworkShares, POST /System/MediaEncoder/Path, and GET /LiveTv/Recordings/Groups/\{groupId\} were each obsolete no-ops returning 403, 404, aliases an quiet result. GET /QuickConnect/Initiate did activity and was an othername for the POST route, truthful clients utilizing the GET shape request to move to POST.

As a wide reminder of our API support policy: if an endpoint is not listed successful the OpenAPI specification it should not beryllium used, and if an endpoint aliases parameter is marked obsolete it should not beryllium used. Deprecations will usually beryllium marked for an full awesome merchandise rhythm earlier removal.

Plugins​

• The server now targets .NET 10, and respective plugin interfaces changed. Plugins request to beryllium retargeted and rebuilt for 12.0.
• New things plugins tin do: supply hunt results, supply similarity and proposal data, supply comic metadata, supply unaired and missing section data, usage aggregated credits for formed members, prevention chapters for non-video items specified arsenic audiobooks, grip a password reset for a username the server does not recognize, and cleanable up their ain extracted files erstwhile an item's information is pruned. Live TV plugins tin besides query Schedules Direct readiness done the server alternatively of reimplementing it.
• Plugins that worked pinch alternate versions aliases playlist contents request attention, since those are nary longer stored wrong the genitor item. There are caller room methods for both.
• The afloat database of new, changed, and removed interfaces is successful the merchandise notes - ISearchEngine, IAuthenticationProvider.HasPassword, parts of IItemRepository, and a fewer IUserManager members are the notable breaks.

Deprecation of soul TLS/SSL support​

In the 10.11.0 merchandise notes we announced that soul TLS/SSL support would beryllium removed successful this release. That removal has been postponed to a early version. The reasoning has not changed - we proceed to urge running Jellyfin down a reverse proxy - truthful if you are moving an Internet-facing lawsuit utilizing Jellyfin's built-in TLS, this is other clip to migrate, not a reprieve.

Happy Watching!