fix(jellyfin-now-playing): make the bitmap fonts work, and document every setting

[ChuckBuilds]

The font bug

A .bdf is a bitmap face that exists at exactly one pixel size. Requesting any other raises inside FreeType, and _load_font caught it and fell back to ImageFont.load_default() — much smaller than anything the schema offers — with only a log warning. Measured against the 4–16 sizes the schema actually allows:

5x7.bdf                    loads only at 7    fails at 12 of 13 offered sizes
4x6.bdf                    loads only at 6    fails at 12 of 13 offered sizes
cozette.bdf                loads at nothing   fails at 13 of 13
5by7.regular.ttf           loads at all 13
4x6-font.ttf               loads at all 13
PressStart2P-Regular.ttf   loads at all 13

Bitmap faces now load at their declared PIXEL_SIZE when the requested size is unavailable — the same fix already merged for clock-simple (#362), countdown (#363), news (#369), tide-display (#370) and mqtt-notifications / youtube-stats (#374).

cozette.bdf is dropped from both font menus. The core ships no file of that name anywhere, so selecting it could never work. Eleven other plugins offer the same non-existent font — filed as #387.

On the version bump: removing an enum value is a removed option, which the contributing rules put at MAJOR. I have used MINOR (1.1.0 → 1.2.0) because no working configuration can break — the value never loaded. Happy to make it 2.0.0 if you would rather hold the line.

The README

It had no images, and two of its settings were effectively undocumented:

• progress_bar_match_text was missing entirely from the configuration reference.
• customization was one table row — "Fonts, sizes, and colors for the title, subtitle, and progress bar" — covering eight nested settings. Each now has its key, default and description.

All 21 schema leaves are documented by key; the config-token audit drops nothing.

New images, all real plugin output rendered against a recorded Jellyfin response:

• the three content types, showing that the subtitle row is what changes (watching user / series / artist)
• playing, paused (amber bar and the pause indicator), and the "Nothing Playing" screen
• both progress_bar_match_text settings on a 256-wide panel, where the difference actually shows
• four panel sizes, including the position / duration readout wide and tall panels get

The poster art in the fixtures is generated gradients, not real cover art.

Tooling

The HTTP replay shim can now serve a file as raw bytes (body_file), so a render can include artwork the plugin fetches instead of the grey placeholder. That will also cover ledmatrix-music's album art and the weather icons.

Checks

• check_plugin.py: 8/8 pass
• render_docs_assets.py --check: all five images reproduce
• Also added the plugin to the root README's listing, which was missing it (part of Three plugins are missing from the root README's Available Plugins listing #385)

🤖 Generated with Claude Code

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: efe61c0c-beff-423e-a7c1-c9f4c8a8ae4b

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[codacy-production]

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

🟢 Metrics 11 complexity

Metric	Results
Complexity	11

View in Codacy

_{NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.}