Rethink channel/playout/schedule creation: PseudoTV-style channel-first flow with a Kodi-smart-playlist-like query builder #176
Closed
opened 2026-07-07 20:42:47 +02:00 by timothy
·
2 comments
No Branch/Tag Specified
main
renovate/dotnet-monorepo
renovate/meziantou.analyzer-3.x
renovate/lucene.net
renovate/sqlitepclraw.bundle_e_sqlite3-3.x
renovate/cliwrap-3.x
913-scripted-playout-401
release/v26.15.0-notes
issue-806-guard-populations
scratch/767b-poisoned
scratch/767b-control
release/v26.14.0-notes
release/v26.14.0
docs/510-skill-logo-bug-policy
fix/510-watermark-resolution-policy
fix/629-verdict-classifier-falseopens
fix/609-decisions-edit-token-scope
issue-135-clear-to-none
release/v26.12.0-notes
fix/409b-lastscan-api-parity
fix/401-updatechannel-mirror-422
fix/327-playlist-rename-validation
fix/410-scancancel-log-level
fix/409-447-librariesscreen-neverscanned
fix/338-zap-exit-code
fix/367-plex-budget-message
fix/310-debom-legacy-cs
ci/604-lane-rebalance
feat/388-design-mirror
feat/247-test-ownership
feat/247-primary-action
feat/357-player-owned-playback
feat/357-jellyfin-plugin-poc
fix/289-mcp-hardening
issue58-mcp
feat/244-channels-extract
ci/auto-bump-prod-compose
feat/multi-rerun-collections-api
feat/collections-api
feat/quick-wins
feat/185-docs-part2
feat/140-collections-screen
feat/146-channel-edit
feat/147-classic-ui-link
issue22-renovate-dashboard
feat/91-cutover
feat/63-composite-create
feat/65-library-browse
feat/85-epg
feat/86-schedule-editor
feat/109-dashboard-data
feat/99-session-tracking
fix/dockerfile-node-tag
feat/59-spa-foundation
docs/59-ui-redesign-brief
feat/102-json-guide
feat/111-schedule-durations
feat/104-artwork-upload
feat/103-media-sources-api
feat/playouts-read-api
feat/108-health-api
feat/105-picker-list-endpoints
issue-97-channel-state-api
issue42-jellyfin-musicvideos
issue46-rest-api-error-contract
dependabot/nuget/ErsatzTV.FFmpeg.Tests/multi-d307a2e06f
qsv-improvements
hdr-vulkan-cuda-test
v26.16.0
v26.15.0
v26.14.0
v26.13.0
v26.12.0
v26.11.0
v26.10.0
v26.9.0
v26.8.0
v26.7.0
blazor-final
v26.6.0
v26.5.0
v26.4.0
v26.3.1
v26.3.0
v26.2.0
v26.1.1
v26.1.0
v25.9.0
v25.8.0
v25.7.1
v25.7.0
v25.6.0
v25.5.0
v25.4.0
v25.3.1
v25.3.0
v25.2.0
v25.1.0
v0.8.8-beta
v0.8.7-beta
v0.8.6-beta
v0.8.5-beta
v0.8.4-beta
v0.8.3-beta
v0.8.2-beta
v0.8.1-beta
v0.8.0-beta
v0.7.9-beta
v0.7.8-beta
v0.7.7-beta
v0.7.6-beta
v0.7.5-beta
v0.7.4-beta
v0.7.3-beta
v0.7.2-beta
v0.7.1-beta
v0.7.0-beta
v0.6.9-beta
v0.6.8-beta
v0.6.7-beta
v0.6.6-beta
v0.6.5-beta
v0.6.4-beta
v0.6.3-beta
v0.6.2-beta
v0.6.1-beta
v0.6.0-beta
v0.5.8-beta
v0.5.7-beta
v0.5.6-beta
v0.5.5-beta
v0.5.4-beta
v0.5.3-beta
v0.5.2-beta
v0.5.1-beta
v0.5.0-beta
v0.4.5-alpha
v0.4.4-alpha
v0.4.3-alpha
v0.4.2-alpha
v0.4.1-alpha
v0.4.0-alpha
v0.3.8-alpha
v0.3.7-alpha
develop
v0.3.6-alpha
v0.3.5-alpha
v0.3.4-alpha
v0.3.3-alpha
v0.3.2-alpha
v0.3.1-alpha
v0.3.0-alpha
v0.2.5-alpha
v0.2.4-alpha
v0.2.3-alpha
v0.2.2-alpha
v0.2.1-alpha
v0.2.0-alpha
v0.1.5-alpha
v0.1.4-alpha
v0.1.3-alpha
v0.1.2-alpha
v0.1.1-alpha
v0.1.0-alpha
v0.0.62-alpha
v0.0.61-alpha
v0.0.60-alpha
v0.0.59-alpha
v0.0.58-alpha
v0.0.57-alpha
v0.0.56-alpha
v0.0.55-alpha
v0.0.54-alpha
v0.0.53-alpha
v0.0.52-alpha
v0.0.51-alpha
v0.0.50-alpha
v0.0.49-prealpha
v0.0.48-prealpha
v0.0.47-prealpha
v0.0.46-prealpha
v0.0.45-prealpha
v0.0.44-prealpha
v0.0.43-prealpha
v0.0.42-prealpha
v0.0.41-prealpha
v0.0.40-prealpha
v0.0.39-prealpha
v0.0.38-prealpha
v0.0.37-prealpha
v0.0.36-prealpha
v0.0.35-prealpha
v0.0.34-prealpha
v0.0.33-prealpha
v0.0.32-prealpha
v0.0.31-prealpha
v0.0.30-prealpha
v0.0.29-prealpha
v0.0.28-prealpha
v0.0.27-prealpha
v0.0.26-prealpha
v0.0.25-prealpha
v0.0.24-prealpha
v0.0.23-prealpha
v0.0.22-prealpha
v0.0.21-prealpha
v0.0.20-prealpha
v0.0.19-prealpha
v0.0.18-prealpha
v0.0.17-prealpha
v0.0.16-prealpha
v0.0.15-prealpha
v0.0.14-prealpha
v0.0.13-prealpha
v0.0.12-prealpha
v0.0.11-prealpha
v0.0.10-prealpha
v0.0.9-prealpha
v0.0.8-prealpha
v0.0.7-prealpha
v0.0.6-prealpha
v0.0.5-prealpha
v0.0.4-prealpha
v0.0.3-prealpha
v0.0.2-prealpha
v0.0.1-prealpha
Labels
Clear labels
ad-hoc
api
bug
ci-cd
content
dependencies
enhancement
frontend
in-progress
jellyfin
parked
priority: high
priority: low
priority: medium
review
security
One-off / ad-hoc work not tracked by a dedicated issue
REST API / HTTP endpoints
Something isn't working
Build, test, deploy pipeline
Channel content / schedules / playlists
Dependency updates (Renovate)
New feature or improvement
ChicoryTV React SPA frontend
Claimed by an active session — do not pick up
Jellyfin tuner / IPTV integration
Excluded from automatic queue pickup; work only when explicitly selected
Adversarial review finding
Security / vulnerability fix
Milestone
No items
No Milestone
Scheduling: refactor + distribution
Projects
Clear projects
No projects
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: timothy/ersatztv#176
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Vision (from Timothy): channel/playout/schedule creation should fundamentally work more like PseudoTV (Kodi add-on) — channel-first and straightforward — with a Kodi smart-playlist-style WYSIWYG rule builder (visual SQL-ish query builder over the media collection) for defining what plays.
How the inspirations work
Kodi smart playlists (XSP): rules of
field + operator + value(s)(type-scoped fields; operators like is/contains/greaterthan/inthelast), AND/OR via<match>+ nested<group>s, playlists referencing playlists,<order>(incl. random) +<limit>. Docs: Smart playlists, Rules and groupings.PseudoTV Live (repo): Autotune one-click generates channels per TV network / genre / studio / music genre; the Channel Manager builds a custom channel from any source with an inline dynamic smart-playlist builder; per-channel advanced rules (Even Show Distribution, Force Episode Ordering, sort) supersede the query's own order; broadcast day fills automatically (auto-filler pads to 15-min marks). Net: channel = one query + a few toggles; no separate schedule authoring for the common case.
Mapping to what we already have
SearchQueryParser,SearchTargets)smart_collection:"Name"recursive resolution w/ cycle detectionDesign directions (progressive disclosure — wizard output stays inspectable/editable as real SmartCollection+Template+Playout)
genre:"Horror"). Near-zero new backend.Notes
Done-when
Scope note: this closes the remaining leg of #176 — the visual rule builder in the SmartCollection editor. Autotune (#69) and the composite Create-Channel wizard (#63) already shipped. Enhancements (facet typeahead, relative dates, deeper nesting, ChannelBuilder/Auto-Tune adoption, builder validation polish) are filed as separate follow-ups.
Claiming (in-progress). Scoped this vision down after recon: Autotune (#69) and the composite Create-Channel wizard (
/app/new-channel, #63) already shipped, so the remaining heart of #176 is the visual WYSIWYG rule builder. Brainstormed a first sub-project with Timothy: a Kodi-style one-level-nested rule builder (compile-only to a closed Lucene subset, no schema change) landing in the SmartCollection create/edit dialog, backed by a new read-onlyGET /api/v1/search/fieldscatalog. Writing the design doc now; follow-ups (facet typeahead, relative dates, deeper nesting, ChannelBuilder/Auto-Tune inline adoption) will be filed as separate issues.Closed — visual rule builder shipped (PR #433, merged to main)
This completes the remaining leg of #176. Autotune (#69) and the composite Create-Channel wizard (#63) shipped earlier; this PR adds the visual WYSIWYG rule builder to the SmartCollection editor.
What was done
GET /api/v1/search/fields— curated, typed, labeled field catalog (single source of truth, MCP-introspectable). No DB change, no write-path change.web/src/builder/rules/: Kodi one-level-nesting rule model → compiles to a closed Lucene subset and parses exactly that back (exact inverses; out-of-subset → raw-text fallback). Total escaping; round-trip proven by a 500-tree property test.useSearchFieldshook + controlledRuleBuilder.SmartDialoggains aBuilder | Advancedtoggle; the compiled Lucene string stays the single submitted value.Design decisions (docs/decisions.md 2026-07-18): compile-only, no stored AST, no schema change — an authoritative AST would still need a Lucene→rules parser for every pre-existing/Auto-Tune query, so it buys little for a dual-provider migration cost. One-level-nesting Kodi model (arbitrary nesting = YAGNI).
Files changed: backend catalog (SearchController + GetSearchFieldCatalog + SearchFieldCatalog + DTO),
web/src/builder/rules/*,web/src/screens/CollectionsScreen.tsx, docs (api-conventions, decisions, spa-conventions §12). Full test suites + property test added.Review: 8 per-task adversarial reviews + a whole-branch Opus review. Bugs caught & fixed in-flight: fulltext operator ambiguity (split matches/notMatches), special-char escaping round-trip (made total), all-nullable generated DTO (clean RuleField), and an Important date-format bug (compiled
yyyy-MM-ddvs the index'syyyyMMddlexicographic format — would have silently excluded same-year items; fixed + re-reviewed CLEAN).Deferred (filed as follow-ups): #434 facet-value typeahead · #435 relative dates · #436 deeper nesting · #437 ChannelBuilder/Auto-Tune inline adoption · #438 input validation/polish (bundles review minors).
Live-E2E: not gated (read-only endpoint, unchanged SmartCollection write path) — stated exemption per the skip rubric.
Docs updated: api-conventions.md (endpoint inventory), decisions.md (2026-07-18 entry), spa-conventions.md (§12 reusable rule builder), endpoint-index.md + v1.json + v1.d.ts (regenerated).