NOCTURNE now draws its main screens with its own CSS theme engine, can show a Jellyfin server in that server's own look, and lets you build themes inside the app.
Highlights
- A native theme engine (no browser) draws Home, the header, the library, search, the item page and the player's controls, with real flex, grid and positioned layout. With no theme the look is unchanged.
- Your server's own look: a server with a custom theme is shown with its web client's page structure and stylesheets, including the stylesheets its plugins add and the fonts and pictures they load. Scripts never run. Any source can borrow another server's look.
- Theme Studio: point at any element of the live screens and change it with controls; it writes real CSS you can keep editing by hand.
- Two built-in themes, NOCTURNE and Glass. Paste or import any Jellyfin web theme and preview it before keeping it.
- Update now for pacman, apt and dnf installs, through PackageKit and the desktop's own password prompt.
- Windows preview: video plays inside the app window, text renders with bundled fonts, and starting playback no longer freezes the app.
- Smoother and lighter: an idle window no longer redraws, large libraries use far less memory, and a stuck video engine can no longer freeze the app.
Known limitations
- Theme effects without a native equivalent yet: backdrop blur becomes a translucent fill; masks, conic gradients and
filter: blur(),saturate()andcontrast()are not drawn; what a theme does with JavaScript does not happen. Settings > Themes lists everything that did not apply. - Fonts declared inside a server plugin's stylesheets are not loaded yet.
- Windows and macOS remain unsigned previews; macOS plays video in mpv's own window.
NOCTURNE_ENGINE_UI=0brings back the hand-written screens for this release if a theme-engine screen misbehaves.
Added
- Glass: refined to match its reference design. The home hero is 85% of the window, the header gets link icons and a back button on item pages (no breadcrumb strip), the library page has a count chip and a vertical A to Z strip, episode cards carry glass buttons over the artwork, and Search is a centred field over rows of poster cards. Themes can set the side gutter (
--page-pad), a back button in the header (--header-back) and a hero height invh; the header scene over item pages carries apage-headerclass so a theme can leave it clear. - Settings > Themes: a Copy button on the report panel copies the open tab (This theme or Server branding) as plain text, for sharing in a bug report.
- Jellyfin layout mode reads the stylesheets a server's start page adds (plugins such as SleekFin), as a browser would and never running scripts:
/web/index.htmlis read, its<link rel="stylesheet">(notalternate,disabledormedia="print"; othermediakept as@media) and<style>blocks are applied in document order after the web client's own sheets and before the branding CSS and your theme. Only the server's own files are fetched, plus other https addresses under the remote-styles rules (public hosts, size and count caps); at most 60 sheets and 4 MB.@importinside them is followed, results are cached per start-page text, and Themes > Refresh imports reads them again. Settings > Themes > Server branding lists per server how many stylesheets, how many rules the engine read, what was skipped and how many scripts were not run. - Themes page: the long explanation is behind "How themes work", the lists have the left column to themselves, and the report (This theme / Server branding, grouped with one item per line) sits full width under the editor, which grows with the window; short or narrow windows scroll the page.
- Theme engine:
radial-gradient(),repeating-linear-gradient()andrepeating-radial-gradient()are drawn (Iced only draws linear ones): each is rasterised once per box size into a cached picture layer in the right stacking order, never per frame (conic gradients are still skipped).@keyframeswithanimation(and its longhands) animate opacity, transform and colour; frames are requested only while something runs, endless animations at 30 per second, none with reduced motion, and never on an essential control.filter: brightness()dims an element (a theme's backdrop dimming), andinitial/unsetput the default back (ElegantFin'smargin-top: unsethad left the item ribbon about 100 px too high). - Jellyfin layout mode: Home and library pages have the page-sized
.backgroundContainerthemes tint (Jellyfish's teal), Continue Watching and Next Up carry the attributes themes use to lay them out (Zombie's big card with small ones), and the item page keeps a hidden previous page as the web client does. - Theme engine: gradient colour hints (
linear-gradient(180deg, transparent, 17vh, #111 50vh)) andvw/vhstop positions,[class*="..."]selectors,content: attr(title), and text beside::before/::afterbullets (section titles of Zombie and Nebula no longer clip). The item page's body no longer carrieswithSectionTabs, so a theme's dim layer over the backdrop (ElegantFin) is the translucent gradient instead of a solid one, and the clear logo always fills its own box. - Jellyfin layout mode draws the pictures a stylesheet names with
url(): background images withbackground-size,-positionand-repeat(gradients written above a picture paint over it),content: url()on the header logo, themed tile pictures and inline SVG; the server's own address may be http or on the LAN, any other host needs https, a public address and remote styles on. Unsupported gradients (conic) are skipped instead of dropping the whole declaration. - Jellyfin layout Home: the Collections and Playlists libraries are My Media tiles in the server's order, and tiles without a picture get the web client's colour class, icon and a theme's own tile picture.
- Jellyfin layout mode: when a source uses a server's UI and the server has its web client, Home, the header, the library and the item page are built with jellyfin-web's own page structure and styled with the server's own stylesheets (fetched from the server, cached, never bundled), then its branding CSS and your theme, so Jellyfin web themes look as they do in the browser. The engine learned
remfrom the root font, floats, absolute boxes against positioned ancestors,inheritand more. - Jellyfin layout mode draws the web client's icons: the server's own Material Icons font is fetched from the server at run time (GET, size-capped, cached next to its stylesheets, never bundled), registered with the text shaper, and the item page's buttons, rating star and selector arrows use jellyfin-web's own
span.material-icons.<name>elements, so a theme restyles them as on the web. Ligature text (play_arrowin a Material Icons span) shapes to the glyph; without the font the page shows plain glyphs instead of boxes. - Jellyfin layout mode item page: the Video, Audio and Subtitles lines of the current file (jellyfin-web's
form.trackSelections, read-only), "Ends at", Resume with its "Play from the start" button, Shuffle and Watched on shows, and the backdrop dimmed by the page-sized.backgroundContainer.withBackdroplayer the theme sets the opacity of (as the web client does from script) instead of a fixed opacity. - Theme Studio (Themes > Open Studio): pick any element of the live Home, header, library and search screens and change it with colour, size, spacing, shape, shadow, accent bar, typography, layout and hover controls ("this element only" or "all like this"), with undo and redo, a CSS tab that stays in sync both ways, starters, save, apply globally or per server, and export as
.css. - Update now for pacman, apt and dnf installs: when PackageKit is available the update banner can refresh and update only the
nocturnepackage through the desktop's normal authentication prompt, then offer Restart; the command stays visible if it is refused or fails. - Themes can rebuild the familiar server web home layout: new parts for the unplayed-count badge, progress bar, episode line, caption alignment, row arrows, header server name, link icons and Watch together button, and library tiles, plus a built-in "Classic" example theme.
- Themes follow
@importand load web fonts: stylesheets that import other stylesheets (Jellyfin web themes, font sheets) now apply, and@font-facefonts in TTF, OTF, WOFF and WOFF2 are downloaded and used. https only, no cookies or sign-in, size, time and count limits, kept in the cache folder and refreshed only by hand or when the text changes. Settings > Themes has a switch that turns all downloading off. - One server's UI over another: each source, "All" and local folders can use NOCTURNE's layout, their own server's UI or another server's (its home sections and look, filled with what you are browsing). Local only; nothing is written to either server. A signed-out or unreachable UI server falls back to the NOCTURNE layout with a note.
- Settings > Sources has a "UI:" button on every source and on a new "All sources" row to choose whose UI is used (NOCTURNE, this server, another server); a fallback is explained on the row. Settings > Themes lists the built-in themes first, has "Refresh imports", shows what was fetched and which fonts loaded, and previews a pasted or imported theme on the whole app until Keep or Revert (a floating bar on every screen).
- Safe look: Ctrl+Shift+0 or starting with
NOCTURNE_SAFE_THEME=1restores the built-in look at once, whatever theme is saved. - Data for the Glass look (UI follows): title logo art for server items (own or the show's) and local
logo.png/clearlogo.pngsidecars (next to the movie or in the show folder, read only); Settings > Home banner (rotate by itself, interval 5 to 30 s); the banner's slide selection and timer (several sources in order, no duplicates, pauses while hovered, focused, expanded, hidden or playing, none with reduced motion); expandable descriptions; loading states for skeleton placeholders. - Glass, a second built-in theme next to NOCTURNE (also a Theme Studio starter): black canvas, a glass header pill with the server name at the left, a full-bleed hero with the title as logo art, light and glass pill buttons, accent rails before section titles and squircle cards with their titles below. Backdrop blur falls back to the translucent fill.
- The Home hero is a carousel (theme engine): slides from continue watching, next up and the newest movies and shows rotate on a timer (Settings: auto-rotate and interval) that pauses while the window is inactive, a button is held, a description is open, the focus is in use, a dialog or the player is open; Left and Right at the hero's buttons step slides, themes can show arrows, dots and a progress hairline, and the leaving slide fades out. The hero description clamps to three lines and opens on a click.
- Themes can style a skeleton for the loading hero and rows (
.hero-skeleton,[data-region="loading"]) and a scrim behind the header once the page has scrolled (page[data-scrolled="true"]). - Theme Studio works on the detail page (movie, series and episode) and on the player's controls bar too: the same pick, inspect and live edit, and the panel docks beside the player so the video keeps the rest of the window. While picking, hosted widgets (the header's Smart menu, search, avatar and history, the player's transport buttons, seek and volume tracks) select their element instead of acting; leaving pick mode restores them.
Changed
- The theme engine is on by default: Home, the header, Library, Search, the item page and the player's controls are element trees styled by the stylesheet (the look is unchanged with no theme). It is the
theme-enginecargo feature, now a default feature ofnocturne-app;cargo build --no-default-featuresbuilds the hand-written screens only, andNOCTURNE_ENGINE_UI=0shows them at run time for this release. - Loaded theme fonts apply at once to headings, labels and buttons (text without an explicit font keeps the launch font).
sources.tomlis version 2: the per-server Server UI switch is nowui_from = "self"(migrated automatically).
Fixed
- Player: the next-episode card says "Next episode in 9 s" (it had no unit), the end time follows the title and status ("clip Ends at 7:37 PM"), and the buffered range of the seek bar is a thinner, lighter line so it no longer reads as playback progress next to the elapsed time.
- One clock formatter: the player's "Ends at", the item page's "Ends at" and the episode cards' "ends" all follow the system locale's 12 or 24 hour style (read from
nl_langinfo; other platforms keep 12 hour), where the player showed 24 hour and the pages 12 hour. - Player menus: the audio menu marks the playing track (a lone track was never marked), and the Settings button, which also holds Quality, shows a gear instead of a sun that looked like brightness.
- Home's hero eyebrow reads "01 / 05 · Movie" (the slide among the carousel's, or just the kind) instead of the "0x00 · movie" index.
- Season tabs read "Season 1 · 4 episodes" (the real episode count, asked for with
ChildCount) instead of a bare number after the name; without a count they say "· N unwatched". - Settings rows keep a readable width (1280 px) so a label and its control are no longer a screen apart; the account menu's greyed items say "Needs server changes on" under the label, and its header shows the source's name instead of its address.
- The header lights no link on Settings, Sources or Themes (it kept Home or Movies lit).
- Jellyfin layout mode: a stylesheet's
background-sizeinemis honoured (auto 1.2em), which draws the critic rating's tomato at icon size instead of a stretched red block; "Sort: Name ↑" stays on one line; the library tile's icon is the web client's 5 em. - Clicking a My Media tile in a server's own look no longer crashes: the paint widget kept hover, press and drag node numbers across a page swap and indexed the smaller new page with them; they are now dropped when the page is replaced.
- Safe look (Ctrl+Shift+0) is the built-in NOCTURNE look on every page, including pages in a server's own look (the server's layout is dropped while it is on), instead of changing only the header and leaving a broken library behind.
- The Admin link in the header opens Admin from Settings, Themes and Sources (they were drawn over it), and those pages no longer show a leftover browsing breadcrumb.
- The header's brand names the server whose look is shown (else the one picked in the source filter), not the last server signed in.
- The breadcrumb strip is opaque, so buttons and text scrolling under it on a detail page no longer show through.
- The breadcrumb shows the logical path: a detail page opened from search over another detail page no longer names that page as its parent (a show above its episode still does).
- The item page shows each fact once: the overview only in the hero, the details table without rating and genres (and in the left column, not far right), no hero copy of year, runtime and genres in the default look, and no stray section counts. The NOCTURNE look's detail layout changed on purpose; Glass needs
.detail-year, .detail-runtime, .detail-genres { display: flex }to keep its meta line (Spotlight has it). - Server look, My Media: each tile names its server when several are shown, and the row has the strip scrollbar and arrows.
- A settings file that cannot be read (a duplicate key from a hand edit) is no longer silently reset: a copy is kept as
settings.toml.bad-<time>, repeated keys are repaired (the last value wins), and a notice names the copy. - A server whose branding CSS is non-empty now uses its own look (Jellyfin layout mode) by default and servers without branding keep NOCTURNE's; the choice in Settings > Sources > UI is stored even when it is NOCTURNE, so only "never chosen" gets the default, and the row says so ("default: this server's look, it has a custom theme"). "All sources" that was never chosen follows the look chosen for the first server, which the All row explains.
- "UI: " now shows in the server's own view and in "All sources": the other server's base stylesheet and branding apply to the items of the source it was chosen for.
- Settings > Themes > Server branding reports what the theme engine read and skipped for each server (the same grouping as a pasted engine sheet) instead of the old translator's "not understood" counts and its
@mediawarning. - Google Fonts: duplicate
@font-facesources are downloaded once, the Latin and Latin Extended subsets load first, other-script subsets are skipped with one note per family, the limit is 24 distinct files (it was 12 files counted per weight), and a family no longer fails because of the limit. - Jellyfin layout mode: the mouse wheel, keys and the scrollbar now work on Home (the page was as high as the window, so nothing could scroll).
- Theme engine:
emlengths (width,height,margin,gap,border-radius, ...) are measured against the element's own final font size whatever order the stylesheet declares them in. jellyfin-web sets.indicator { height: 2em; width: 2em }before.countIndicator { font-size: 88% }, and.detailButton-icon { font-size: 1.6em !important; width: 1em }, so the badge circle and the icon boxes had the wrong size (and anemradius was always 16 px based); an icon next to a label could overlap it. - Theme engine: text directly inside a flex or grid container is placed by
justify-contentandalign-itemslike the browser's anonymous item, so the unplayed-count number sits in the middle of its round badge instead of in its top-left corner. - Jellyfin layout: a widget hosted in a larger box (the 32 px user picture in the header's 40 px round avatar) is centred in it, so the blue ring is even around the picture instead of showing as a crescent.
- The film-grain overlay is gone: its 512 px speckle tile was stretched to the window, so on large screens it showed as a faint block pattern over pages, buttons and video.
- Playback no longer freezes the app when the video engine gets stuck: with no usable audio server, closing a video right after opening it could leave mpv's core thread blocked inside PipeWire's shutdown, and every synchronous libmpv call from the window then waited for it, so the page sat on "Opening", the window stopped responding and SIGTERM was ignored. Calls to the embedded player now run on a worker with a short wait, teardown gives up on a stuck thread after about a second and the process then ends without it, an item that has not opened after 30 seconds fails with "Couldn't start playback: ...", and a stuck engine is reported after 15 seconds.
- Memory: browsing a large library with artwork no longer grows the process by hundreds of MiB. glibc kept the freed picture-decode buffers of every worker thread (one arena each, and a rising mmap threshold): the allocator is now set to one arena and fixed 1 MiB thresholds at start, which also takes about 70 MiB off the idle baseline in a software-GL session; and the engine's library grid lets go of the pictures of cards far from the rows in view (they are fetched again from the disk cache on return). Numbers in
docs/dev/PERF.md. - An idle window no longer redraws: the app drew about 6 times a second on Home and 10 times a second in the Library with nothing happening, because a 200 ms polling tick ran all the time and every Iced message redraws the window. The tick now runs only while something needs it (a recent action, playback, a toast, a download, an offline server, onboarding), terminate signals and a second launch reach the app without it, and the Home hero wakes the app only when its slide changes (once a second only if the theme draws the progress hairline). Idle Home with the hero off, Library, Search, the item page and Settings draw 0 frames in 10 s.
- Engine: boxes that only touch (fractional layout) were treated as overlapping and one of them was drawn beneath the page, so a card could vanish; the harness loads Catppuccin with its flavour palette.
- Engine screens (
theme-engine): the mouse wheel scrolls the library grid and the detail page again (a header strip above them swallowed it), and the page scrollbar can be dragged. - Engine Home: the row paging arrows of the Classic look scroll their strip; hovering a header link no longer leaves it lit after the pointer leaves; the Smart link no longer lights on every library page; in a window narrower than 640 px the brand makes room for the links.
- Engine search overlay: the Up and Down keys move the highlighted result.
- Theme Studio: the Home hero stops rotating while the Studio is open, and the safe look chord also resets the open Studio preview.
- The built-in Marquee and Classic starters no longer make the theme engine warn about
display: carouselandcontent: server; they are accepted as the layout layer's words. - Home rows now ask the server for each item's overview and genres, so the hero shows the description; long wrapped text in the theme engine is no longer dropped when the renderer breaks one line more than the measure did.
- The hero's Play label keeps a contrasting colour under a theme that colours buttons.
- Pasting or importing a theme that is (or contains) an
@importnow fetches it for the preview too, shows "Fetching imports and fonts..." while it downloads, and feeds the fetched, inlined stylesheet (and its fonts) to the theme engine for previews, the Theme Studio, saved themes and server UIs instead of the raw text. - Windows: text no longer shows as random symbols. The UI relied on fonts the PC does not have (Noto Sans, JetBrains Mono Nerd Font); Noto Sans (Regular, Medium, Bold) and JetBrains Mono (Regular, Bold) are now embedded in the app on every platform (SIL OFL-1.1, see THIRD_PARTY_NOTICES.md).
- Windows: the app no longer freezes ("Not Responding") when playback starts, and the stats overlay shows values again. Starting mpv, connecting to its pipe and every property read waited on the UI thread (up to 300 ms each, several per tick, longer than mpv needs to open its window on a slow PC or virtual machine); all of it now runs on worker threads and properties come from a cache kept current by mpv's property observers. The same change applies to the external mpv window on Linux and macOS.
- Windows: video plays inside the app window (a child window that mpv draws into) instead of a separate window. The controls bar and menus sit outside the picture (the window cannot be drawn over): the picture shrinks above the bar while it shows, stays visible around menus and panels (the window is cut out where they are drawn) and hides only under full-window overlays and prompts. If mpv cannot start in the window, the separate mpv window opens with a one-line notice;
NOCTURNE_VIDEO=externalforces it. Needs testing on a real PC. - Signing in to a server whose old token was still in the keyring no longer opens with "Your session ended. Please sign in again."; the note only shows when the session restored at launch was rejected or the session ended while the app was open.
Development
- The engine's time budget is 300 ms per pass (it was 50 ms and switched heavy themes off in debug builds);
NOCTURNE_ENGINE_TIMING=1logs every pass, andcargo build --profile conformancebuilds optimised code with the debug-only snapshot hooks the conformance harness needs. - Debug builds can write what the active theme did (tokens applied, not applied by kind, imports fetched, fonts loaded) as JSON with
NOCTURNE_THEME_REPORT=<file>and thetheme-report@<ms>key hook;scripts/theme-conformance.shfills its applied / not applied column from it. tools/headless-pointergainswheel <dx> <dy>anddrag <x1> <y1> <x2> <y2>for headless QA.scripts/headless-parity.shcaptured the thumb view at a random moment (thevkey raced the page load); the debug hookview-thumbwaits for the library page and sets the view explicitly, andPARITY_ONLY=<text>runs a subset.- The app's test run no longer crashes now and then with SIGSEGV: tests that build an
iced_testsimulator ran concurrently and now take a shared lock. scripts/headless-input-check.shno longer loses chords: it waits for the virtual keyboard to appear, refocuses, checks the focus and only then sends the keys; each check starts from a known state and is repeated once if a chord went missing.scripts/theme-conformance.shruns each theme with the import its own project documents (ElegantFin no longer resolves to a Jellyfin 12 fork) and makes "All" use the server's UI, so the NOCTURNE side shows the server's sections.