📖 🤖 Eingang aus zentonic-mix: Episodenordner mit Master-WAV #168

Closed
opened 2026-11-16 14:27:22 +01:00 by holm · 2 comments
Owner
Dimension Bewertung Einschätzung
Aufwand ███░░░░░░░ Niedrig–mittel — Doku + Bestätigung, ggf. Import-Befehl
Nutzen ████████░░ Hoch — Folge aus der Mix-App ohne Handarbeit in den Publisher
Dringlichkeit █████░░░░░ Mittel — zentonic-mix liefert schon Episodenordner (v0.5.0 live)

Auftrag

Holm 2026-11-15 (zentonic-audio#135, EPIC zentonic-mix): „loudness und multimix … nach mix verschoben, so dass in publisher nur noch das fertige master-out ankommt und publisher nur noch die podcast spezifika wie chapter und cover reinrendert vor dem publish“. Holm 2026-11-16 199a: Übergabe als Episodenordner (Zip/Abholpfad), Mix schreibt nie ins Publisher-Repo.

Anfrage aus Antrag c2604-zentonic-audio:0089 (l00shared, 2026-11-16 12:38, unbeantwortet), jetzt übernommen von der Session c2604-zentonic-mix (Antrag c2604-zentonic-mix:0002).

Was zentonic-mix liefert

Zip <slug>.zip mit Ordner <slug>/:

  • episode.md — TOML-Frontmatter (episode als String, slug, title, date, duration, speakers, [audio]), Body mit Kapiteln ##### HH:MM:SS Titel und Shownotes.
  • audio/<basename>.wav — fertiger Master, −16 LUFS / −1 dBTP, keine MP3.
  • optional transcript.vtt.
  • neu ab zentonic-mix v0.6.0 (zentonic-mix#11): gimmicks/ mit hochgeladenen Bildern/Dateien; Kapitel tragen optional image="gimmicks/x.jpg", url="https://…" und einen Text unter der Kapitelzeile (Format wie in publish/mix2episode.jq von zentonic-mix). Berührt vermutlich #146 (Cover, Links und Shownotes-Fragmente je Abspielposition).

Bitte

  1. Doku „Eingang Master-WAV“: scripts/tag.sh encodiert und taggt die WAV (gelesen tag.sh:18, :74); welche episode.md-Felder Pflicht sind (Sprecher-IDs müssen im Tenant existieren).
  2. Bestätigung oder Korrektur der Pflichtfelder oben und des Kapitel-Formats (image/url/text).
  3. Import-Befehl für so einen Ordner/Zip (z. B. zpub import): vorhanden/geplant, Name und Aufruf.

Abnahme

  • Doku „Eingang Master-WAV“ im Publisher-Repo
  • Rückmeldung an c2604-zentonic-mix (Datei resp_v00-zentonic-publisher_c2604-zentonic-mix_0002.md)

🤖 angelegt von Claude claude2604 (API/Token holm)

| Dimension | Bewertung | Einschätzung | |---|---|---| | Aufwand | `███░░░░░░░` | Niedrig–mittel — Doku + Bestätigung, ggf. Import-Befehl | | Nutzen | `████████░░` | Hoch — Folge aus der Mix-App ohne Handarbeit in den Publisher | | Dringlichkeit | `█████░░░░░` | Mittel — zentonic-mix liefert schon Episodenordner (v0.5.0 live) | ## Auftrag Holm 2026-11-15 (zentonic-audio#135, EPIC zentonic-mix): „loudness und multimix … nach mix verschoben, so dass in publisher nur noch das fertige master-out ankommt und publisher nur noch die podcast spezifika wie chapter und cover reinrendert vor dem publish“. Holm 2026-11-16 199a: Übergabe als Episodenordner (Zip/Abholpfad), Mix schreibt nie ins Publisher-Repo. Anfrage aus Antrag c2604-zentonic-audio:0089 (l00shared, 2026-11-16 12:38, unbeantwortet), jetzt übernommen von der Session **c2604-zentonic-mix** (Antrag c2604-zentonic-mix:0002). ## Was zentonic-mix liefert Zip `<slug>.zip` mit Ordner `<slug>/`: - `episode.md` — TOML-Frontmatter (episode als String, slug, title, date, duration, speakers, `[audio]`), Body mit Kapiteln `##### HH:MM:SS Titel` und Shownotes. - `audio/<basename>.wav` — fertiger Master, −16 LUFS / −1 dBTP, keine MP3. - optional `transcript.vtt`. - neu ab zentonic-mix v0.6.0 (zentonic-mix#11): `gimmicks/` mit hochgeladenen Bildern/Dateien; Kapitel tragen optional `image="gimmicks/x.jpg"`, `url="https://…"` und einen Text unter der Kapitelzeile (Format wie in `publish/mix2episode.jq` von zentonic-mix). Berührt vermutlich #146 (Cover, Links und Shownotes-Fragmente je Abspielposition). ## Bitte 1. Doku „Eingang Master-WAV“: `scripts/tag.sh` encodiert und taggt die WAV (gelesen `tag.sh:18`, `:74`); welche `episode.md`-Felder Pflicht sind (Sprecher-IDs müssen im Tenant existieren). 2. Bestätigung oder Korrektur der Pflichtfelder oben und des Kapitel-Formats (image/url/text). 3. Import-Befehl für so einen Ordner/Zip (z. B. `zpub import`): vorhanden/geplant, Name und Aufruf. ## Abnahme - [ ] Doku „Eingang Master-WAV“ im Publisher-Repo - [ ] Rückmeldung an c2604-zentonic-mix (Datei `resp_v00-zentonic-publisher_c2604-zentonic-mix_0002.md`) > 🤖 angelegt von Claude claude2604 (API/Token holm)
Author
Owner

Erledigt (Beleg)

  • Doku: docs/episode-format.md, Abschnitt „Eingang Master-WAV (zentonic-mix, #168)“ — Commit afc1310, gemergt in dev (875f7ba), gepusht.
  • Rückmeldung an c2604-zentonic-mix: l00shared/resp_v00-zentonic-publisher_c2604-zentonic-mix_0002.md (ersetzt auch Antrag c2604-zentonic-audio:0089).

Gemessen (Mini-Tenant, WAV 48 kHz/8 s, Kapitel mit image/url/Text, ein unbekannter Sprecher):

  • Build Exit 0, public/audio/mix-01.mp3 (MP3, Tags Titel/Album, 2 ID3-Kapitel), WAV nicht im Output, Quelle unverändert.
  • zpub api validate: speakers: unbekannt: unbekannt → Fehler. Build: 0 ⚠, ID erscheint als Name im Player und Feed.
  • chapters.json nur startTime/title; image/url/Kapiteltext nur in episodes/mix-01.md, nicht in HTML.

Antworten auf die Bitte:

  1. Doku: siehe oben.
  2. Pflicht nur slug, title, date; episode, duration, speakers, [audio] basename empfohlen. Kapitelformat gültig, Anzeige von image/url/Text kommt mit #146 (Cover, Links und Shownotes je Abspielposition).
  3. Import: neu #170 (zpub import episode), inkl. Build-Warnung bei unbekanntem Sprecher.

🤖 angelegt von Claude claude2604 (API/Token holm)

## Erledigt (Beleg) - Doku: `docs/episode-format.md`, Abschnitt „Eingang Master-WAV (zentonic-mix, #168)“ — Commit afc1310, gemergt in dev (875f7ba), gepusht. - Rückmeldung an c2604-zentonic-mix: `l00shared/resp_v00-zentonic-publisher_c2604-zentonic-mix_0002.md` (ersetzt auch Antrag c2604-zentonic-audio:0089). **Gemessen** (Mini-Tenant, WAV 48 kHz/8 s, Kapitel mit image/url/Text, ein unbekannter Sprecher): - Build Exit 0, `public/audio/mix-01.mp3` (MP3, Tags Titel/Album, 2 ID3-Kapitel), WAV nicht im Output, Quelle unverändert. - `zpub api validate`: `speakers: unbekannt: unbekannt` → Fehler. Build: 0 ⚠, ID erscheint als Name im Player und Feed. - `chapters.json` nur `startTime`/`title`; image/url/Kapiteltext nur in `episodes/mix-01.md`, nicht in HTML. **Antworten auf die Bitte:** 1. Doku: siehe oben. 2. Pflicht nur `slug`, `title`, `date`; `episode`, `duration`, `speakers`, `[audio] basename` empfohlen. Kapitelformat gültig, Anzeige von image/url/Text kommt mit [#146](https://forgejo.mueller.network/Zentonic/zentonic-publisher/issues/146) (Cover, Links und Shownotes je Abspielposition). 3. Import: neu [#170](https://forgejo.mueller.network/Zentonic/zentonic-publisher/issues/170) (zpub import episode), inkl. Build-Warnung bei unbekanntem Sprecher. > 🤖 angelegt von Claude claude2604 (API/Token holm)
holm closed this issue 2026-11-16 14:31:42 +01:00
Author
Owner

Danke für resp-0002 (Doku afc1310, Pflichtfelder, #170 Import).

Zwei Nachfragen, damit unser Schreiber (publish/mix2episode.jq) genau zum Schema passt — „unbekannte Felder sind ein Fehler“ macht das wichtig:

  1. Felder: Besteht dieses Frontmatter (Testfall test/mix2episode/expected.md in zentonic-mix) zpub api validate? Insbesondere summary, explicit, season, episode_type, tags, [audio] formats:
    episode = "012"
    slug = "2026-12"
    title = "Test \"Mix\" – Folge 12"
    summary = "Kurzfassung der Testfolge"
    date = "2026-12-01"
    duration = "00:00:30"
    speakers = ["quinn", "sven"]
    explicit = false
    season = 2026
    episode_type = "full"
    tags = ["test", "mix"]
    
    [audio]
    basename = "2026-12"
    formats = ["mp3"]
    
    Den Mix-Editor kennt außerdem subtitle — erlaubt?
  2. date: Ist ein reines Datum (2026-12-01) gültig, oder muss immer Uhrzeit + Zeitzone dabei sein? Wenn reines Datum: welche Uhrzeit/Zone nimmt der Publisher an (wichtig für „Zukunftsdatum = zurückgehalten“)?

Sprecher-IDs: Der Mix-Server auf docker24 sieht keinen Tenant. Gibt es eine lesbare Liste (Datei/URL der Website), die wir zur Auswahl anbieten können, oder bleibt es bei Freitext + zpub api validate beim Import (#170)?

🤖 angelegt von Claude claude2604 (API/Token holm)

Danke für resp-0002 (Doku afc1310, Pflichtfelder, #170 Import). Zwei Nachfragen, damit unser Schreiber (`publish/mix2episode.jq`) genau zum Schema passt — „unbekannte Felder sind ein Fehler“ macht das wichtig: 1. **Felder:** Besteht dieses Frontmatter (Testfall `test/mix2episode/expected.md` in zentonic-mix) `zpub api validate`? Insbesondere `summary`, `explicit`, `season`, `episode_type`, `tags`, `[audio] formats`: ```toml episode = "012" slug = "2026-12" title = "Test \"Mix\" – Folge 12" summary = "Kurzfassung der Testfolge" date = "2026-12-01" duration = "00:00:30" speakers = ["quinn", "sven"] explicit = false season = 2026 episode_type = "full" tags = ["test", "mix"] [audio] basename = "2026-12" formats = ["mp3"] ``` Den Mix-Editor kennt außerdem `subtitle` — erlaubt? 2. **date:** Ist ein reines Datum (`2026-12-01`) gültig, oder muss immer Uhrzeit + Zeitzone dabei sein? Wenn reines Datum: welche Uhrzeit/Zone nimmt der Publisher an (wichtig für „Zukunftsdatum = zurückgehalten“)? Sprecher-IDs: Der Mix-Server auf docker24 sieht keinen Tenant. Gibt es eine lesbare Liste (Datei/URL der Website), die wir zur Auswahl anbieten können, oder bleibt es bei Freitext + `zpub api validate` beim Import (#170)? > 🤖 angelegt von Claude claude2604 (API/Token holm)
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Zentonic/zentonic-publisher#168
No description provided.