Paul HittandClaude Opus 5 51abf2cf26 FlameNet Classic: a 90s set-top skin for Jellyfin 10.11
CSS theme that restyles Jellyfin as a 1999-era DVR: gold selection bar,
chunky bevels, a proper grid channel guide, CRT phosphor.

Selectors were read out of a live 10.11.11 server's own shipped bundles
rather than from memory. Includes an offline preview harness that uses
Jellyfin's real DOM structure, an optional Web Audio + guide-NOW-line
extras layer, and install/rollback scripts.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-07 10:37:39 -04:00

FlameNet Classic — a 90s set-top skin for Jellyfin

A custom CSS theme that makes Jellyfin look like a 1999-era DVR: fat rounded corners, hard bevels, a gold selection bar that follows you around, a proper grid channel guide, and CRT phosphor.

Visual reference is the classic TiVo Series 1/2 interface. No TiVo trademarks, artwork, or assets are used — the flame mark is an inline SVG you can swap.

Built against Jellyfin 10.11.11 (jellyfin.example.com). Selectors were read out of that server's own shipped bundles, not from memory — see Sourcing the selectors.

flamenet.css              the theme — this is the whole product
flamenet-extras.js        OPTIONAL js layer (sounds + guide NOW line)
install-extras.sh         installer for the above (UNTESTED on a live server)
preview.html              offline preview using Jellyfin's real DOM structure
preview-standalone.html   the same, fully inlined — one portable file
build-preview.sh          rebuilds the standalone from the parts

Install the theme

  1. Open flamenet.css, copy all of it.
  2. Jellyfin → Dashboard → General → Custom CSS → paste → Save.
  3. Display → Theme → Dark (the skin assumes a dark base).
  4. Hard-reload the client (Cmd/Ctrl + Shift + R).

To remove: clear the Custom CSS box. Nothing on the server changes, and a Jellyfin upgrade can't break it beyond the usual risk of upstream renaming a class.

What it themes

Area Status Selectors
Top banner + flame mark verified .skinHeader, .headerLeft::before
Left menu (FlameNet Central) verified .mainDrawer, .navMenuOption
Channel guide verified .tvguide, .timeslotHeader*, .guide-channelHeaderCell, .programCell, .guideProgram*
On Demand tiles verified .card, .cardBox, .cardText
Recorded / list views verified .listItem, .listItemBodyText
Detail pages, dialogs, inputs verified .detailPagePrimaryContainer, .dialog, .emby-input
Now Playing bar verified .nowPlayingBar*
Volume / brightness popups verified .iconOsd*, .brightnessOsd*
Login / splash verified .login, .splashLogo
Search + A–Z picker verified .search, .searchfields-icon, .alphaPicker*
Dashboard / admin verified .dashboardSection*, .adminSection, .sessionCard*
Progress, toasts, spinners, sheets verified .itemProgressBar*, .toast, .progressring*, .actionSheet*
Video player OSD unverified .videoOsdBottom, .osdControls, .osdTitle, …

"verified" = the class appears in a stylesheet this server actually serves.

The OSD row is the exception and section 18 says so in the file. The video OSD's stylesheet is not in any CSS chunk 10.11.11 serves, so those names come from Jellyfin's long-standing markup rather than something confirmable on this build. An unmatched selector is a no-op, so the worst case is the player keeps its stock look. If it does, inspect the OSD and fix the names in section 18.

Live TV badges are colour-coded: LIVE red, NEW/PREMIERE green, REPEAT teal, HD gold, record dot red.

The one thing to be careful about

Jellyfin's guide is two independent scrolling columns — the channel list and the program grid — kept in sync only by having identical row heights.

Adding margin to a row, or a border to a content-box element, changes the row pitch on one side and the columns silently desynchronise. The error is cumulative: the first draft added margin-bottom: 3px to the channel cells, which drifted 3px per row — fine across the 7 rows in the preview, but ~1600px of drift across the 552 channels on this server, i.e. channel names lining up against completely the wrong programmes.

So every gutter in the guide is a transparent border on a border-box element, drawn inside the stock 4.42em row height and 12vw column width. Same for the -1px sibling pull stock Jellyfin applies to both columns — zero it on one side only and you reintroduce 1px/row.

Verified 0px row drift and 0px ribbon offset at 1440 / 1024 / mobile. If you edit section 7, re-check with the preview open:

var ch=[...document.querySelectorAll('.guide-channelHeaderCell')];
var pr=[...document.querySelectorAll('.channelPrograms')];
console.log(ch.map((x,i)=>Math.round(x.getBoundingClientRect().top-pr[i].getBoundingClientRect().top)));
// want all zeros

Optional: the extras layer

flamenet-extras.js adds the things CSS cannot:

  • Navigation sounds — a set-top "bloop" on moving the selection and a "ding" on choosing. Synthesised with Web Audio, so there are no audio files to host, 404, or trip a CSP.
  • Guide NOW line — a live red time marker down the channel guide, positioned from the time-slot headers. It is a pure overlay and never touches the guide's own layout, so it cannot cause the drift described above.
  • Boot chime on first load.

Runtime controls (browser console):

FlameNet.status()          // what's on
FlameNet.sound(false)      // mute — persists in localStorage
FlameNet.volume(0.1)       // 0.01 – 1.0
FlameNet.nowLine(false)    // hide the guide marker

Verified in the preview against Jellyfin's real guide markup: the marker lands where the arithmetic says it should (checked in both percentage and pixel space), handles 12-hour and 24-hour labels identically, puts 12:00 PM at 720 minutes and 12:00 AM at 0, wraps correctly past midnight, and hides itself when the guide is scrolled to a time window that doesn't contain now.

Installing the extras

Jellyfin has no supported hook for custom JavaScript — the only way in is a <script> tag in index.html:

./install-extras.sh --dry-run     # show exactly what would change
./install-extras.sh --install
./install-extras.sh --status
./install-extras.sh --uninstall

Takes --container NAME (default jellyfin) and --host USER@HOST to work over ssh. It finds the web root rather than hardcoding it, backs up index.html first, and is idempotent — reinstalling replaces the block instead of stacking.

Three caveats, in order of how likely they are to bite:

  1. This script has never been run against a live server. It was written for jellyfin.example.com but not executed there. Use --dry-run and read it first.
  2. The change is inside the container, so an image update erases it. That's how containers work, not a bug. Re-run --install after each update; --status tells you whether it's currently present.
  3. It deliberately does not bind-mount index.html. That would survive updates but pin a stale index.html over a newer web client, which breaks the app confusingly the next time bundle names change. Re-running a script is the lesser evil.

The CSS theme is completely independent of all this.

Preview

./build-preview.sh     # rebuild preview-standalone.html after editing

Open preview-standalone.html anywhere, or serve the folder and open preview.html. Four screens, deep-linkable by hash: #home, #guide, #vod, #parts.

It reproduces Jellyfin's actual markup — same class names, same absolutely-positioned guide grid — so what you see is the real theme, not a mockup. Everything inside the PREVIEW HARNESS ONLY block is layout scaffolding Jellyfin's own bundles normally provide; none of it ships in flamenet.css.

Sourcing the selectors

Worth recording, because it is not obvious and it is how to do this again:

  1. curl /web/index.html → lists main.jellyfin.*.css and runtime.bundle.js.
  2. runtime.bundle.js contains two webpack chunk maps. The smaller one is the CSS chunk map; there is also a chunk-id → readable-name map.
  3. Download the CSS chunks and grep them for the classes you need.

The important part: the Live TV guide CSS is a lazy chunk (36154.*.css), absent from main.jellyfin.*.css entirely. Read only the main bundle and every guide class looks missing. Not all ids in the map resolve — several 404, which is why the video OSD stayed unverified.

Fetch the chunks serially. A parallel sweep returned 91 empty files; this box runs CrowdSec, which reacts to bursts.

Tweaks

  • Phosphor — --fn-crt-scanline (0 = off) and --fn-crt-vignette in section 11, or delete the block.
  • Accent — --fn-gold / --fn-gold-2 / --fn-gold-dk.
  • Logo — the data URI in .skinHeader .headerLeft::before.
  • Less rounding — --fn-r, --fn-r-sm.

Gotchas hit while building this

  • .videoPlayerContainer body::after can never match — body is not a descendant of anything. Playback state in 10.11 is body.noScroll / body.hide-scroll / .hiddenViewMenuBar.
  • .button-submit alone (0,1,0) loses to the base rule's button.emby-button (0,1,1), so primary buttons silently stayed blue.
  • Don't force background on the scrub slider: Jellyfin paints the played portion with an inline gradient, and !important erases it. Use accent-color.
S
Description
FlameNet Classic — a 90s TiVo-style set-top skin for Jellyfin 10.11 (custom CSS + optional extras)
Readme MIT
73 KiB
Languages
HTML 65.5%
CSS 22.7%
JavaScript 6%
Shell 5.8%