hector-bot/knowledge-base
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

update(raw+wiki): notebooklm-briefing-system — full agent guide (12-step workflow, prompts, caption-contract, rendering, error-table, cmd-ref)

Browse source
This commit is contained in:
Hector 2026-07-04 01:00:51 +02:00
parent 269e6343a5
commit 4ea0355aef
2 changed files with 393 additions and 79 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

268
raw/other/2026-07-03_notebooklm-briefing-system.md
View file

@ -2,87 +2,235 @@
type: other type: other
source_url: "ome-group://tips-and-tricks/7694" source_url: "ome-group://tips-and-tricks/7694"
retrieved: 2026-07-03 retrieved: 2026-07-03
title: "NotebookLM Briefing-System: Zwei Presets (nb1/nb2), Pipeline mit Audio-Briefing + Infografik + MP4-Video" title: "NotebookLM Briefing-System: Installationsanleitung mit Presets nb1/nb2, 12-Schritt-Pipeline, Prompts, Caption-Contract, Rendering, Fehler-Tabelle"
author: "Pit Weber" author: "Pit Weber"
tags: [notebooklm, briefing, pipeline, audio, video, mp4, infographic, automation, presets, agent-skills] tags: [notebooklm, briefing, pipeline, audio, video, mp4, infographic, automation, presets, agent-skills, ffmpeg, yt-dlp]
--- ---
# NotebookLM Briefing-System (Pit Weber, OME Tips & Tricks #7694) # NotebookLM Briefing-System — Installationsanleitung (Pit Weber, OME Tips & Tricks #7694)
**Quelle:** OME-Gruppe, Topic "Tips & Tricks", Post #7694 (03.07.2026) **Quelle:** OME-Gruppe, Topic "Tips & Tricks", Post #7694 (03.07.2026)
**Autor:** Pit Weber **Autor:** Pit Weber
**Anlage:** `notebooklm-agent-guide` (vollständige Installationsdatei)
## Überblick ## Kurzfassung für Menschen
Pit Weber hat sein NotebookLM-Briefing-System als konkrete Skill-Pipeline dokumentiert. Das System automatisiert die Erstellung von Audio-Briefings, Infografiken und MP4-Videos aus beliebigen Quellen (YouTube, PDF, X/Twitter, Web-URLs) über zwei Presets (`nb1` und `nb2`). Du schickst eine Quelle + `nb1` oder `nb2` — dein Agent macht daraus ein fertiges Briefing mit Audio, Infografik und Video.
## Presets ### Die zwei Presets
### nb1 — Standard-Briefing | Preset | Verhalten |
|---|---|
| `nb1` | 1 Nachricht: MP4-Video (Infografik + deutsches Audio) + Text mit allen Links |
| `nb2` | 2 Nachrichten: zuerst Kurz-Audio (nur Ton, ~halbe Länge), dann MP4-Video + Text |
Das Standard-Preset generiert ein vollständiges Briefing-Paket: ### So nutzt du es
1. Quelle laden (YouTube, PDF, X/Twitter, Web-URL)
2. Deutsches Audio-Briefing generieren
3. Infografik erstellen
4. MP4-Video rendern
5. Als Nachricht senden
**Output:** Audio-Briefing (MP3) + Infografik (Bild) + MP4-Video + Text-Zusammenfassung
### nb2 — Kurz-Audio zuerst
Variante für schnellen Konsum: Generiert zuerst ein kurzes Audio-Briefing, dann das vollständige nb1-Video.
1. Kurzes Audio-Briefing generieren (schnell, sofort verfügbar)
2. Anschließend nb1-Pipeline (Audio-Briefing + Infografik + MP4)
**Use Case:** Wenn sofort ein Audio-Output gewünscht ist, während das vollständige Video-Paket noch rendert.
## Unterstützte Quellen
| Quelltyp | Beispiel | Hinweis |
|----------|----------|---------|
| YouTube | `https://youtube.com/watch?v=...` | Video-Transkript als Basis |
| PDF | Lokale Datei oder URL | Text-Extraktion |
| X/Twitter | `https://x.com/...` | Post/Thread-Inhalt |
| Web-URL | `https://example.com/article` | Web-Fetch + Text-Extraktion |
## Pipeline (Schritt-für-Schritt)
``` ```
Quelle laden → deutsches Audio-Briefing → Infografik generieren → MP4 rendern → als Nachricht senden https://www.youtube.com/watch?v=XXXXX nb1
/pfad/zu/datei.pdf nb2
https://x.com/user/status/123 nb1
``` ```
1. **Quelle laden:** NotebookLM akzeptiert die URL/Datei und extrahiert den Inhalt Quelle zuerst, dann das Preset. Fertig.
2. **Audio-Briefing:** Generiert ein deutsches Audio-Briefing (gesprochener Text)
3. **Infografik:** Erstellt eine visuelle Zusammenfassung der Key-Points
4. **MP4 rendern:** Kombiniert Audio + visuelle Elemente zu einem Video
5. **Nachricht senden:** Deliveriert das Ergebnis über den konfigurierten Kanal (z.B. Telegram)
## Skills ### Was passiert im Hintergrund
Das System basiert auf zwei Skills: 1. Quelle wird in ein NotebookLM-Notebook geladen
2. Deutsches Audio-Briefing wird generiert
3. Infografik wird erstellt
4. Beides wird zu einem MP4 gerendert
5. Das Briefing wird als eine Nachricht gesendet
| Skill | Zweck | ### Was du bekommst
|-------|-------|
| `notebooklm-pipelines` | Pipeline-Skill: Definiert die Verarbeitungsschritte (nb1, nb2) |
| `notebooklm-agent-guide` | Bauanleitung für Agenten: Wie man NotebookLM-basierte Agent-Skills konstruiert |
## Requirements Jedes Briefing enthält:
- 🎬 MP4-Video mit Infografik + Audio
- 📓 Link zum öffentlichen Notebook
- 📺 Link zur Originalquelle
- 📝 Kompakte Einordnung („Warum es zählt")
- **notebooklm CLI** v0.3.4 (oder neuer) ### Unterstützte Quellen
- **ffmpeg** (Audio/Video-Verarbeitung)
- **yt-dlp** (YouTube-Download/-Transkription)
- **Google-Konto** via `notebooklm login` (Authentifizierung für NotebookLM API)
## Kontext - YouTube-Videos
- PDF-Dateien (einfach in den Chat schicken)
- X/Twitter-Posts
- Normale Web-URLs
Dieses Briefing-System ist die ausgereifte Form der Winston+NotebookLM-Pipeline, die erstmals im OME21-Debrief (19.06.2026) dokumentiert wurde. Die beiden Presets `nb1`/`nb2` formalisieren den "Harness > LLM"-Ansatz aus OME23: Die Orchestrierungsschicht (Skills/CLI) steuert die Generierungsschicht (NotebookLM), nicht das LLM selbst. ### nb2 im Detail
## Verwandte Wiki-Seiten Das Kurz-Audio kommt **zuerst** — als reine Audio-Datei, kein Video. Es enthält nur: Kernbehauptung, stärkstes Belegstück, größten Widerspruch, eine Konsequenz. Danach folgt das normale nb1-Video.
- [[../../wiki/tools/winston-openwebui-bot.md]] — Pit's Telegram-Bot als Frontend Ideal wenn jemand schnell den Kern erfassen soll, bevor er das volle Briefing öffnet.
- [[../../wiki/concepts/llm/hyper-summaries-notebooklm.md]] — NotebookLM als Generierungs-Engine
- [[../../wiki/events/ome23-evolution-ki-workflows.md]] — "Harness > LLM"-These ---
- [[../../wiki/concepts/llm/spec-driven-development-harness.md]] — Spec-Driven Development als verwandter Pattern
## Installation (für OpenClaw-Nutzer)
### Voraussetzungen
Dein OpenClaw-Agent braucht:
- `notebooklm` CLI (v0.3.4) — `npm install -g notebooklm`
- `ffmpeg` — `brew install ffmpeg`
- `yt-dlp` — `brew install yt-dlp`
- Ein Google-Konto, via `notebooklm login` authentifiziert
### Skills installieren
1. **`notebooklm-core`** — Basis-Skill für CLI-Operationen
2. **`notebooklm-pipelines`** — Enthält die Presets nb1 und nb2
3. **`notebooklm-agent-guide`** — Technische Bauanleitung für Agenten (diese Datei)
Die Skills liegen im OpenClaw Skill Workshop oder können als Dateien in das Skills-Verzeichnis kopiert werden.
### Konto einrichten
```bash
NOTEBOOKLM_HOME=~/.notebooklm/mein-konto notebooklm login --storage ~/.notebooklm/mein-konto/storage_state.json
```
Im Browser mit dem gewünschten Google-Konto einloggen, warten bis die NotebookLM-Startseite sichtbar ist, dann ENTER im Terminal drücken.
### Auth testen
```bash
NOTEBOOKLM_HOME=~/.notebooklm/mein-konto notebooklm auth check --test --json
```
Erwartete Antwort: `"status": "ok"` mit `"token_fetch": true`.
---
## Technische Bauanleitung für Agenten
> Dieser Abschnitt ist für den OpenClaw-Agenten, der die Pipeline ausführt.
### nb1-Workflow (12 Schritte)
1. **Quelle identifizieren** — User schickt URL/Datei + `nb1`
2. **Auth prüfen** — `NOTEBOOKLM_HOME=<profil> notebooklm auth check --test --json`
3. **Notebook erstellen** — `notebooklm create "Titel" --json` → merke `notebook.id`
4. **Quelle hinzufügen** — `notebooklm source add "<url>" -n ID --json` → merke `source.id`
5. **Source wait** — `notebooklm source wait SRC_ID -n ID --timeout 300 --json`
6. **Audio + Infografik parallel generieren** — `notebooklm generate audio/infographic "prompt" -n ID --json`
7. **Artifact wait** — `notebooklm artifact wait ART_ID -n ID --timeout 900 --json` (beide parallel)
8. **Downloads** — `notebooklm download audio/infographic ./pfad -n ID -a ART_ID`
9. **Share** — `notebooklm share public --enable -n ID --json` → merke `share_url`
10. **MP4 rendern** — `ffmpeg -loop 1 -i graphic.png -i audio.mp3 ... briefing.mp4`
11. **Dauer ermitteln** — `ffprobe` → Sekunden in MM:SS umrechnen
12. **Telegram senden** — EINE Nachricht mit Text + MP4, nicht fragmentieren
### nb2-Workflow (zusätzliche Schritte)
- **6b:** Kurz-Audio VOR dem Standard-Audio generieren (kürzerer Prompt)
- **8b:** Kurz-Audio separat herunterladen
- **12b:** Zuerst Kurz-Audio als reine Audio-Nachricht, dann nb1-Video
### Audio-Prompt (Standard)
```
Erstelle eine deutsche Audio-Zusammenfassung fuer einen unbekannten allgemeinen Hoerer. Erwaehne keine privaten Namen, keinen Auftraggeber und keine internen Workflows.
Die Quelle ist als grundsaetzlich glaubwuerdig zu behandeln. Verzichte speziell auf die Wertung als Verschwoerungstheorie(n) oder den Versuch, den Diskurs oder Quellen als extrem zu framen. Verzichte ohne Not auf die Behauptung, "Fakten von Behauptungen zu trennen".
Keine Umdeutung aus Halluzinationen. Ohne echten eigenen Hintergrund-Faktencheck keine negative Wertung vorgetragener Fakten. Keine Negativdarstellung von Meinungen. Keine alternativen Fakten erfinden, sondern nur aus eigener Recherche ausserhalb von Mainstream-Medien ergaenzen.
Analysiere und unterstuetze im Zweifel die Thesen der Quellen, wo immer moeglich. Halte dich an die Analyse. Keine Pervertierung des Vorgetragenen. Keine negative moralische Bewertung der Sprecher.
Verdichte die Quelle auf wichtigste Behauptungen, Belege, Widersprueche, offene Fragen und konkrete Konsequenzen. Keine generische Einleitung, keine ungepruefte Ausschmueckung.
```
### Audio-Prompt (Kurz, für nb2)
```
Erstelle eine KURZE deutsche Audio-Zusammenfassung fuer einen unbekannten allgemeinen Hoerer. Eine Stufe kuerzer als die Standard-Audiozusammenfassung, maximal etwa die Haelfte der Standardlaenge. Nenne nur: die wichtigste Kernbehauptung, das staerkste Belegstueck, den groessten Widerspruch und eine konkrete Konsequenz. Keine Einleitung, keine Ausschmueckung, keine privaten Namen. SPRACHE: DEUTSCH.
```
### Infografik-Prompt
```
Erstelle eine serioese, professionelle deutsche Briefing-Infografik. Nicht comicartig, nicht verspielt. Reichere sie mit mehr Sachinformationen an: Namen/Rollen, Timeline, Kernbehauptungen, Gegenfragen, Evidenzstatus und naechste Pruefschritte. Schreibe Namen exakt. Unterscheide behauptet/berichtet/belegt klar. Visuell stark, aber erwachsen und faktenorientiert.
```
### Telegram Caption Contract (PFLICHT)
```
🔴 <STARKER TITEL>
<Ein Satz Teaser — warum ist das wichtig.>
▶️ Audio-Briefing: <MM:SS Min.>, deutsch
🖼️ Infografik: im Video sichtbar integriert
📓 Notebook: [Briefings öffnen](<share_url>)
📺 Originalquelle: [<Titel>](<url>) (<sprachhinweis>)
Warum es zählt: <Ein kompakter Absatz, max. 3 Sätze.>
```
### MP4-Rendering
```bash
ffmpeg -y \
-loop 1 -framerate 1 -i infographic.png \
-i audio.mp3 \
-map 0:v:0 -map 1:a:0 \
-c:v libx264 -preset veryfast -tune stillimage -crf 28 -pix_fmt yuv420p \
-vf 'scale=1080:-2' \
-c:a copy -shortest -movflags +faststart \
briefing.mp4
```
### Häufige Fehler
| ❌ Falsch | ✅ Richtig |
|---|---|
| Text und MP4 in getrennten Nachrichten | Eine Nachricht mit Text + Media |
| `NOTEBOOKLM_HOME` vergessen | Immer mit Profil-Pfad prefixen |
| `notebooklm use` statt `-n ID` | Immer `-n NOTEBOOK_ID` übergeben |
| MP4 >50MB → Telegram blockiert | Mit `-crf 32 -vf 'scale=720:-2'` komprimieren |
| `artifact wait` ohne Timeout | Immer `--timeout 900` |
| Source nicht abwarten | `source wait` VOR `generate` |
| nb2: Kurz-Audio vergessen | Kurz-Audio IMMER zuerst generieren und senden |
| nb2: Kurz-Audio als Video | Kurz-Audio ist AUDIO-ONLY, kein MP4 |
| Interne t.me-Links als Quelle | Original-PDF mitschicken oder öffentlichen Link finden |
### Kommando-Referenz
```bash
# Auth
NOTEBOOKLM_HOME=<profil> notebooklm auth check --test --json
# Notebook
NOTEBOOKLM_HOME=<profil> notebooklm create "Titel" --json
NOTEBOOKLM_HOME=<profil> notebooklm list --json
# Source
NOTEBOOKLM_HOME=<profil> notebooklm source add "<url>" -n ID --json
NOTEBOOKLM_HOME=<profil> notebooklm source wait SRC_ID -n ID --timeout 300 --json
# Generate
NOTEBOOKLM_HOME=<profil> notebooklm generate audio "prompt" -n ID --json
NOTEBOOKLM_HOME=<profil> notebooklm generate infographic "prompt" -n ID --json
# Wait
NOTEBOOKLM_HOME=<profil> notebooklm artifact wait ART_ID -n ID --timeout 900 --json
NOTEBOOKLM_HOME=<profil> notebooklm artifact list -n ID --json
# Download
NOTEBOOKLM_HOME=<profil> notebooklm download audio ./out.mp3 -n ID -a ART_ID
NOTEBOOKLM_HOME=<profil> notebooklm download infographic ./out.png -n ID -a ART_ID
# Share
NOTEBOOKLM_HOME=<profil> notebooklm share public --enable -n ID --json
# MP4
ffmpeg -y -loop 1 -framerate 1 -i graphic.png -i audio.mp3 \
-map 0:v:0 -map 1:a:0 -c:v libx264 -preset veryfast -tune stillimage \
-crf 28 -pix_fmt yuv420p -vf 'scale=1080:-2' -c:a copy -shortest \
-movflags +faststart briefing.mp4
# Duration
ffprobe -v error -show_entries format=duration \
-of default=noprint_wrappers=1:nokey=1 audio.mp3
```

204
wiki/tools/notebooklm-briefing-system.md
View file

@ -1,8 +1,8 @@
--- ---
created: 2026-07-03 created: 2026-07-03
updated: 2026-07-03 updated: 2026-07-04
sources: [other/2026-07-03_notebooklm-briefing-system.md, youtube/2026-07-01_futurepedia-notebooklm-short-video-overviews.md, other/2026-06-19_ome21-briefing-ki-fortschritte-lokale-modelle.md] sources: [other/2026-07-03_notebooklm-briefing-system.md, youtube/2026-07-01_futurepedia-notebooklm-short-video-overviews.md, other/2026-06-19_ome21-briefing-ki-fortschritte-lokale-modelle.md]
tags: [tool, notebooklm, briefing, pipeline, audio, video, mp4, infographic, automation, presets, agent-skills, pit-weber] tags: [tool, notebooklm, briefing, pipeline, audio, video, mp4, infographic, automation, presets, agent-skills, pit-weber, ffmpeg, yt-dlp, caption-contract]
--- ---
# NotebookLM Briefing-System # NotebookLM Briefing-System
@ -20,24 +20,24 @@ Das System definiert zwei Presets, die als Agent-Skills ausgeführt werden:
### nb1 — Standard-Briefing ### nb1 — Standard-Briefing
Vollständige Pipeline in einem Durchgang: Vollständige Pipeline in einem Durchgang → **1 Nachricht** mit MP4-Video (Infografik + deutsches Audio) + Text mit allen Links.
| Schritt | Output | Format | | Schritt | Output | Format |
|---------|--------|--------| |---------|--------|--------|
| 1. Quelle laden | Extrahierter Text | — | | 1. Quelle laden | Extrahierter Text | — |
| 2. Deutsches Audio-Briefing | Gesprochene Zusammenfassung | MP3 | | 2. Deutsches Audio-Briefing | Gesprochene Zusammenfassung | MP3 |
| 3. Infografik | Visuelle Key-Points | Bild | | 3. Infografik | Visuelle Key-Points | PNG |
| 4. MP4 rendern | Video (Audio + Visual) | MP4 | | 4. MP4 rendern | Video (Audio + Visual) | MP4 |
| 5. Nachricht senden | Deliverie | Telegram/o.a. | | 5. Nachricht senden | Delivery | Telegram |
### nb2 — Kurz-Audio zuerst ### nb2 — Kurz-Audio zuerst
Zweistufige Variante für schnellen Konsum: Zweistufige Variante für schnellen Konsum → **2 Nachrichten**:
1. **Kurzes Audio-Briefing** — sofort verfügbar, schneller Output 1. **Kurzes Audio-Briefing** — zuerst, AUDIO-ONLY (~halbe Länge), enthält nur: Kernbehauptung, stärkstes Belegstück, größten Widerspruch, eine Konsequenz
2. **Vollständige nb1-Pipeline** — Audio-Briefing + Infografik + MP4 2. **Vollständige nb1-Pipeline** — MP4-Video + Text
**Use Case:** Wenn sofort ein Audio-Output gewünscht ist, während das vollständige Video-Paket noch rendert. **Use Case:** Wenn jemand sofort den Kern erfassen soll, bevor das volle Briefing öffnet.
## Unterstützte Quellen ## Unterstützte Quellen
@ -55,29 +55,195 @@ Zweistufige Variante für schnellen Konsum:
│ Quelle │ ──> │ Audio-Briefing│ ──> │ Infografik │ ──> │ MP4 │ ──> │ Nachricht │ │ Quelle │ ──> │ Audio-Briefing│ ──> │ Infografik │ ──> │ MP4 │ ──> │ Nachricht │
│ laden │ │ (Deutsch) │ │ │ │ rendern │ │ senden │ │ laden │ │ (Deutsch) │ │ │ │ rendern │ │ senden │
└──────────┘ └──────────────┘ └────────────┘ └──────────┘ └────────────┘ └──────────┘ └──────────────┘ └────────────┘ └──────────┘ └────────────┘
YouTube NotebookLM NotebookLM ffmpeg Telegram/ YouTube NotebookLM NotebookLM ffmpeg Telegram
PDF Audio Gen Visual Gen OpenWebUI PDF Audio Gen Visual Gen (1 Nachricht!)
X/Twitter X/Twitter
Web-URL Web-URL
``` ```
## nb1-Workflow — 12 Schritte (Bauanleitung)
> Für OpenClaw-Agenten, die die Pipeline ausführen.
1. **Quelle identifizieren** — User schickt URL/Datei + `nb1`
2. **Auth prüfen** — `NOTEBOOKLM_HOME=<profil> notebooklm auth check --test --json`
3. **Notebook erstellen** — `notebooklm create "Titel" --json` → merke `notebook.id`
4. **Quelle hinzufügen** — `notebooklm source add "<url>" -n ID --json` → merke `source.id`
5. **Source wait** — `notebooklm source wait SRC_ID -n ID --timeout 300 --json`
6. **Audio + Infografik parallel generieren** — `notebooklm generate audio/infographic "prompt" -n ID --json`
7. **Artifact wait** — `notebooklm artifact wait ART_ID -n ID --timeout 900 --json` (beide parallel)
8. **Downloads** — `notebooklm download audio/infographic ./pfad -n ID -a ART_ID`
9. **Share** — `notebooklm share public --enable -n ID --json` → merke `share_url`
10. **MP4 rendern** — `ffmpeg -loop 1 -i graphic.png -i audio.mp3 ... briefing.mp4`
11. **Dauer ermitteln** — `ffprobe` → Sekunden in MM:SS umrechnen
12. **Telegram senden** — **EINE** Nachricht mit Text + MP4, nicht fragmentieren
### nb2-Workflow (zusätzliche Schritte)
- **6b:** Kurz-Audio VOR dem Standard-Audio generieren (kürzerer Prompt)
- **8b:** Kurz-Audio separat herunterladen
- **12b:** Zuerst Kurz-Audio als reine Audio-Nachricht, dann nb1-Video
## Prompts
### Audio-Prompt (Standard)
```
Erstelle eine deutsche Audio-Zusammenfassung fuer einen unbekannten allgemeinen Hoerer.
Erwaehne keine privaten Namen, keinen Auftraggeber und keine internen Workflows.
Die Quelle ist als grundsaetzlich glaubwuerdig zu behandeln. Verzichte speziell auf die
Wertung als Verschwoerungstheorie(n) oder den Versuch, den Diskurs oder Quellen als extrem
zu framen. Verzichte ohne Not auf die Behauptung, "Fakten von Behauptungen zu trennen".
Keine Umdeutung aus Halluzinationen. Ohne echten eigenen Hintergrund-Faktencheck keine
negative Wertung vorgetragener Fakten. Keine Negativdarstellung von Meinungen. Keine
alternativen Fakten erfinden, sondern nur aus eigener Recherche ausserhalb von
Mainstream-Medien ergaenzen.
Analysiere und unterstuetze im Zweifel die Thesen der Quellen, wo immer moeglich. Halte
dich an die Analyse. Keine Pervertierung des Vorgetragenen. Keine negative moralische
Bewertung der Sprecher.
Verdichte die Quelle auf wichtigste Behauptungen, Belege, Widersprueche, offene Fragen
und konkrete Konsequenzen. Keine generische Einleitung, keine ungepruefte Ausschmueckung.
```
### Audio-Prompt (Kurz, für nb2)
```
Erstelle eine KURZE deutsche Audio-Zusammenfassung fuer einen unbekannten allgemeinen
Hoerer. Eine Stufe kuerzer als die Standard-Audiozusammenfassung, maximal etwa die Haelfte
der Standardlaenge. Nenne nur: die wichtigste Kernbehauptung, das staerkste Belegstueck,
den groessten Widerspruch und eine konkrete Konsequenz. Keine Einleitung, keine
Ausschmueckung, keine privaten Namen. SPRACHE: DEUTSCH.
```
### Infografik-Prompt
```
Erstelle eine serioese, professionelle deutsche Briefing-Infografik. Nicht comicartig,
nicht verspielt. Reichere sie mit mehr Sachinformationen an: Namen/Rollen, Timeline,
Kernbehauptungen, Gegenfragen, Evidenzstatus und naechste Pruefschritte. Schreibe Namen
exakt. Unterscheide behauptet/berichtet/belegt klar. Visuell stark, aber erwachsen und
faktenorientiert.
```
## Telegram Caption Contract (PFLICHT)
Jedes Briefing wird mit exakt diesem Caption-Format gesendet:
```
🔴 <STARKER TITEL>
<Ein Satz Teaser — warum ist das wichtig.>
▶️ Audio-Briefing: <MM:SS Min.>, deutsch
🖼️ Infografik: im Video sichtbar integriert
📓 Notebook: [Briefings öffnen](<share_url>)
📺 Originalquelle: [<Titel>](<url>) (<sprachhinweis>)
Warum es zählt: <Ein kompakter Absatz, max. 3 Sätze.>
```
## MP4-Rendering
```bash
ffmpeg -y \
-loop 1 -framerate 1 -i infographic.png \
-i audio.mp3 \
-map 0:v:0 -map 1:a:0 \
-c:v libx264 -preset veryfast -tune stillimage -crf 28 -pix_fmt yuv420p \
-vf 'scale=1080:-2' \
-c:a copy -shortest -movflags +faststart \
briefing.mp4
```
**Komprimierung bei >50MB:** `-crf 32 -vf 'scale=720:-2'` statt `-crf 28 -vf 'scale=1080:-2'`
## Kommando-Referenz
```bash
# Auth
NOTEBOOKLM_HOME=<profil> notebooklm auth check --test --json
# Notebook
NOTEBOOKLM_HOME=<profil> notebooklm create "Titel" --json
NOTEBOOKLM_HOME=<profil> notebooklm list --json
# Source
NOTEBOOKLM_HOME=<profil> notebooklm source add "<url>" -n ID --json
NOTEBOOKLM_HOME=<profil> notebooklm source wait SRC_ID -n ID --timeout 300 --json
# Generate
NOTEBOOKLM_HOME=<profil> notebooklm generate audio "prompt" -n ID --json
NOTEBOOKLM_HOME=<profil> notebooklm generate infographic "prompt" -n ID --json
# Wait
NOTEBOOKLM_HOME=<profil> notebooklm artifact wait ART_ID -n ID --timeout 900 --json
NOTEBOOKLM_HOME=<profil> notebooklm artifact list -n ID --json
# Download
NOTEBOOKLM_HOME=<profil> notebooklm download audio ./out.mp3 -n ID -a ART_ID
NOTEBOOKLM_HOME=<profil> notebooklm download infographic ./out.png -n ID -a ART_ID
# Share
NOTEBOOKLM_HOME=<profil> notebooklm share public --enable -n ID --json
# Duration
ffprobe -v error -show_entries format=duration \
-of default=noprint_wrappers=1:nokey=1 audio.mp3
```
## Häufige Fehler
| ❌ Falsch | ✅ Richtig |
|---|---|
| Text und MP4 in getrennten Nachrichten | Eine Nachricht mit Text + Media |
| `NOTEBOOKLM_HOME` vergessen | Immer mit Profil-Pfad prefixen |
| `notebooklm use` statt `-n ID` | Immer `-n NOTEBOOK_ID` übergeben |
| MP4 >50MB → Telegram blockiert | Mit `-crf 32 -vf 'scale=720:-2'` komprimieren |
| `artifact wait` ohne Timeout | Immer `--timeout 900` |
| Source nicht abwarten | `source wait` VOR `generate` |
| nb2: Kurz-Audio vergessen | Kurz-Audio IMMER zuerst generieren und senden |
| nb2: Kurz-Audio als Video | Kurz-Audio ist AUDIO-ONLY, kein MP4 |
| Interne t.me-Links als Quelle | Original-PDF mitschicken oder öffentlichen Link finden |
## Skills ## Skills
Das System ist als zwei Agent-Skills implementiert: Das System ist als drei Agent-Skills implementiert:
| Skill | Zweck | Typ | | Skill | Zweck | Typ |
|-------|-------|-----| |-------|-------|-----|
| `notebooklm-core` | Basis-Skill für CLI-Operationen | Core-Skill |
| `notebooklm-pipelines` | Pipeline-Definition (nb1, nb2): Verarbeitungsschritte, Preset-Logik | Pipeline-Skill | | `notebooklm-pipelines` | Pipeline-Definition (nb1, nb2): Verarbeitungsschritte, Preset-Logik | Pipeline-Skill |
| `notebooklm-agent-guide` | Bauanleitung: Wie man NotebookLM-basierte Agent-Skills konstruiert | Meta-Skill / Guide | | `notebooklm-agent-guide` | Bauanleitung: Wie man NotebookLM-basierte Agent-Skills konstruiert | Meta-Skill / Guide |
## Requirements ## Requirements
| Komponente | Version | Zweck | | Komponente | Version | Zweck | Install |
|------------|---------|-------| |------------|---------|-------|---------|
| `notebooklm` CLI | ≥ v0.3.4 | NotebookLM API-Zugriff | | `notebooklm` CLI | ≥ v0.3.4 | NotebookLM API-Zugriff | `npm install -g notebooklm` |
| `ffmpeg` | aktuell | Audio/Video-Verarbeitung (MP4-Render) | | `ffmpeg` | aktuell | Audio/Video-Verarbeitung (MP4-Render) | `brew install ffmpeg` |
| `yt-dlp` | aktuell | YouTube-Download/-Transkription | | `yt-dlp` | aktuell | YouTube-Download/-Transkription | `brew install yt-dlp` |
| Google-Konto | — | Authentifizierung via `notebooklm login` | | Google-Konto | — | Authentifizierung via `notebooklm login` | — |
### Konto einrichten
```bash
NOTEBOOKLM_HOME=~/.notebooklm/mein-konto notebooklm login \
--storage ~/.notebooklm/mein-konto/storage_state.json
```
Im Browser mit Google-Konto einloggen, warten bis NotebookLM-Startseite sichtbar ist, dann ENTER im Terminal.
### Auth testen
```bash
NOTEBOOKLM_HOME=~/.notebooklm/mein-konto notebooklm auth check --test --json
```
Erwartet: `"status": "ok"` mit `"token_fetch": true`.
## Beziehung zu Winston ## Beziehung zu Winston
@ -107,7 +273,7 @@ Dieses System ist ein konkretes Beispiel für mehrere Architektur-Thesen:
## Quellen ## Quellen
- [Pit Weber, OME Tips & Tricks #7694](../../../raw/other/2026-07-03_notebooklm-briefing-system.md) — Ursprungsposting mit Presets, Pipeline, Skills, Requirements - [Pit Weber, OME Tips & Tricks #7694 — Installationsanleitung](../../../raw/other/2026-07-03_notebooklm-briefing-system.md) — Vollständige Bauanleitung mit 12-Schritt-Workflow, Prompts, Caption-Contract, Rendering, Fehler-Tabelle, Kommando-Referenz
- [Futurepedia: NotebookLM Short Video Overviews](../../../raw/youtube/2026-07-01_futurepedia-notebooklm-short-video-overviews.md) — Short Video Feature, Winston+NotebookLM Pipeline - [Futurepedia: NotebookLM Short Video Overviews](../../../raw/youtube/2026-07-01_futurepedia-notebooklm-short-video-overviews.md) — Short Video Feature, Winston+NotebookLM Pipeline
- [OME21-01 Debrief](../../../raw/other/2026-06-19_ome21-briefing-ki-fortschritte-lokale-modelle.md) — Erste Erwähnung von Winston+NotebookLM-Pipeline - [OME21-01 Debrief](../../../raw/other/2026-06-19_ome21-briefing-ki-fortschritte-lokale-modelle.md) — Erste Erwähnung von Winston+NotebookLM-Pipeline
- [OME23 Evolution der KI-Workflows](../../../raw/other/2026-07-02_ome23-evolution-ki-workflows.md) — "Harness > LLM"-These - [OME23 Evolution der KI-Workflows](../../../raw/other/2026-07-02_ome23-evolution-ki-workflows.md) — "Harness > LLM"-These