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>
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
- Open
flamenet.css, copy all of it. - Jellyfin → Dashboard → General → Custom CSS → paste → Save.
- Display → Theme → Dark (the skin assumes a dark base).
- 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:
- This script has never been run against a live server. It was written for
jellyfin.example.combut not executed there. Use--dry-runand read it first. - The change is inside the container, so an image update erases it. That's
how containers work, not a bug. Re-run
--installafter each update;--statustells you whether it's currently present. - It deliberately does not bind-mount
index.html. That would survive updates but pin a staleindex.htmlover 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:
curl /web/index.html→ listsmain.jellyfin.*.cssandruntime.bundle.js.runtime.bundle.jscontains two webpack chunk maps. The smaller one is the CSS chunk map; there is also a chunk-id → readable-name map.- 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-vignettein 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::aftercan never match —bodyis not a descendant of anything. Playback state in 10.11 isbody.noScroll/body.hide-scroll/.hiddenViewMenuBar..button-submitalone (0,1,0) loses to the base rule'sbutton.emby-button(0,1,1), so primary buttons silently stayed blue.- Don't force
backgroundon the scrub slider: Jellyfin paints the played portion with an inline gradient, and!importanterases it. Useaccent-color.