mirror of
https://github.com/MrSleeps/jellyfin-scene-search.git
synced 2026-11-16 23:11:27 +00:00
Explain specialist video summaries, model overrides and safe regeneration
This commit is contained in:
@@ -657,6 +657,8 @@ a short, natural-language description and append it to Jellyfin's **Overview**
|
||||
metadata field. It uses **one text-only Ollama chat request** with up to 64
|
||||
time-spaced caption segments from throughout the video — **no extra Trickplay
|
||||
downloads, image captioning, visual embeddings, or Meilisearch indexing**.
|
||||
The input now reserves space for each selected time segment rather than silently
|
||||
dropping the later scenes when captions are long.
|
||||
It is a **visual description**, not a reliable official movie synopsis:
|
||||
frames can be ambiguous, it may contain spoilers, and the model may still make
|
||||
mistakes.
|
||||
@@ -688,12 +690,38 @@ overwrite later manual edits to Jellyfin's Overview. If a title is duplicated
|
||||
(e.g. two editions of a film), use `--media-id` instead.
|
||||
|
||||
To generate a new draft after caption coverage improves, use `--regenerate`
|
||||
before publishing; if already published, `--restore` first. Generated drafts
|
||||
are cached so a normal preview reuses the same wording unless the sampled
|
||||
captions change. Set `OVERVIEW_MODEL` to a suitable **text** Ollama model if
|
||||
you don't want to use your existing general caption model, and optionally
|
||||
increase `OVERVIEW_TIMEOUT_SECONDS`. The Ollama model must be accessible from
|
||||
the same container that already performs captioning.
|
||||
before publishing; if already published, `--restore` first. Drafts are
|
||||
cached by caption evidence **and** summary style/model/prompt version, so a
|
||||
new specialist style automatically regenerates outdated drafts without
|
||||
requiring extra captioning.
|
||||
|
||||
For videos with a substantial share of captions routed through the specialist
|
||||
captioner, `jellyfin-overview` automatically uses a dedicated **neutral,
|
||||
non-graphic but concrete** summarisation prompt. It describes the broad
|
||||
visible adult context and setting instead of obscuring them with vague
|
||||
euphemisms, while avoiding invented events and graphic details. The command
|
||||
prints the automatically selected style and the routing counts. You can
|
||||
force the specialist style when routing metadata is incomplete:
|
||||
|
||||
```bash
|
||||
docker compose exec -T scene-search python -m scene_search.cli \
|
||||
jellyfin-overview --title "Exact Film Title" --style specialist --regenerate
|
||||
```
|
||||
|
||||
If the video's current AI Overview is **already published**, run `--restore`
|
||||
first (which preserves your original synopsis), then preview again and
|
||||
`--apply` only after reviewing the new draft. You can also use
|
||||
`--style general` for a mixed film where automatic detection chooses poorly.
|
||||
|
||||
Set `OVERVIEW_MODEL` to a suitable **text** Ollama model if you don't
|
||||
want to use your existing general caption model. Optionally set
|
||||
`OVERVIEW_SPECIALIST_MODEL` to another **text-capable** model specifically
|
||||
for sensitive/adult caption summaries; when empty, the general Overview
|
||||
model is reused with the specialist summarisation prompt. Avoid assuming
|
||||
that the image-captioning specialist model itself is necessarily good at
|
||||
text-only summaries. `--model` overrides either choice for a one-off
|
||||
preview. `OVERVIEW_TIMEOUT_SECONDS` controls the HTTP timeout. Both
|
||||
models must be accessible from the scene-search container.
|
||||
|
||||
This edits **Jellyfin's metadata record, not the video file**; Jellyfin
|
||||
metadata-refresh providers may change the field again unless it is protected
|
||||
|
||||
Reference in New Issue
Block a user