Files
OrbitTv/docs/refinement-notes.md
T
pauljdandClaude Opus 5.5 70b8cf3a86
pauljd/davidson-ci: Davidson CI / quality (push) Failing after 1m48s
pauljd/davidson-ci: Davidson CI / ai-review (push) Failing after 1m26s
Replace the rating-based fill with longer hand-picked film lists (0.75.0)
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-11-02 14:11:01 +00:00

35 lines
3.3 KiB
Markdown

# Refinement notes
Paul's approach, 2 November 2026: build in pieces, learn by using it, and note every refinement, so the next user gets a much easier time because we did the refining. Each note says what happened and what a new user should get by default. These feed "Build your own network" on the roadmap.
## Channels and pools
- **Rules let in misfits.** Family films, shorts, blockbusters and foreign films reached After Dark until year, rating, genre and score rules tightened. A new user should get channels that fit first time, and never have to judge a long list.
- **Lists of well-known titles work best.** Curated lists found nearly everything in Paul's library (Orbit 2 31 of 31, Sci-Fi 48 of 48). Rules are for growing a pool, not starting one.
- **Reviewing is tiring.** Paul said he'd need to go through each one again, and can't judge every title. Filling automatically and taking out what's wrong suits better than ticking what's right.
- **Rating alone is not a signal.** Filling by highest rating in 0.74 brought UFC events, wrestling and obscure films with a 10 from a few votes. Emby's type and genre don't separate a film from a recorded event. A director needs popularity or vote counts, an event filter, and a check against title lists. Until then, lists are better.
- **Titles still suggests by rating**, and ticks new suggestions by default. Fix this before a new user sees it.
- **A film channel needs about 100 films** to go a week without a repeat. With 45 it repeats in 3 to 4 days. Tell the user if their library falls short.
- **Library details have limits.** Nothing tells a British film or hand-drawn animation apart, so those need title lists or other sources.
- **Names vary by library.** WWE Raw and IMPACT! Wrestling were found under different names from those guessed. Matching should cope with this, and show what it couldn't find.
- **The same show on two channels at once looks wrong**, and is now avoided. Check this across every new source of programmes, such as the Drive-In.
## Playback
- **Some files can't play on some boxes.** The MP3 audio on Transformers failed every time, and Forensic Files had sound with no picture. Leave these out before they're scheduled, and never show an error on air.
- **Transcoding is not a safe default.** Paul decided against it, and a provider may not allow it.
- **Foreign audio** needs catching: Recess came up not in English.
## Screens
- **Paul prefers uncluttered screens, showing only what's needed.** Test tools and technical readouts confused the flow, and took 0.73 to clear out.
- **Real artwork beats drawn scenes.** Drawn channel backdrops looked off brand; real Emby artwork was "clean af", and his own Drive-In pictures beat my drawn ones.
- **Screenshots are blocked on the box**, so text placed over artwork needs a photo to check. Fixed-height lines fixed the first attempt.
- **Remote reach:** check every screen by remote. The gear couldn't be reached from the first column until 0.73.1.
## First run, for the next user
- **One screen at a time:** sign in, channels ticked from what the library holds, then the main menu.
- **Smart schedules on by default.** Today a fresh sign-in starts every channel off, and needs 29 presses.
- **Numbers in blocks like Sky** from the start, so there's never a move to make. The one move we made missed two channels until a test caught it.