docs: 2.22.0 release docs

README.md

@@ -21,27 +21,28 @@
       <source media="(max-width: 600px) and (prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/chhoumann/PodNotes/HEAD/docs/public/screenshots/hero-phone-dark.webp">
       <source media="(max-width: 600px)" srcset="https://raw.githubusercontent.com/chhoumann/PodNotes/HEAD/docs/public/screenshots/hero-phone.webp">
       <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/chhoumann/PodNotes/HEAD/docs/public/screenshots/demo-dark.gif">
-      <img src="https://raw.githubusercontent.com/chhoumann/PodNotes/HEAD/docs/public/screenshots/demo.gif" width="880" alt="An episode note in Obsidian with timestamp links captured while the episode plays in PodNotes">
+      <img src="https://raw.githubusercontent.com/chhoumann/PodNotes/HEAD/docs/public/screenshots/demo.gif" width="880" alt="An episode note in Obsidian with timestamp links captured from the episode in PodNotes">
     </picture>
   </a>
 </p>
 
 ## What you can do
 
-- **Listen beside your notes.** Search Apple Podcasts or paste any RSS feed, then play audio and video with speed control, a queue, and playlists.
+- **Listen beside your notes.** Search Apple Podcasts or paste any RSS feed, then play audio and video with chapters, the feed's transcript, speed control, a queue, and playlists.
 - **Capture the moment.** One command inserts a timestamp link, such as `00:12:41`, into your note. Select it later to play from that second.
 - **Create a note for any episode.** A template fills in the show, date, description, and a link that resumes playback. Browse the notes as a table with Obsidian Bases.
 - **Take it with you.** PodNotes works on iOS and Android. Download episodes for offline listening, or play your own audio and video files.
-- **Transcribe episodes.** Use your own OpenAI API key, or a Deepgram key when you turn on speaker labels and choose Deepgram.
+- **Transcribe episodes.** Save the transcript a podcast publishes for free, or transcribe the audio with your own OpenAI or Deepgram key.
 - **Build your own workflows.** Use the commands, the JavaScript API, and QuickAdd.
 
 ## Get started
 
 PodNotes needs Obsidian 1.13 or later.
 
 1. In Obsidian, open **Settings → Community plugins**. If you see **Exit Restricted mode**, select it. Select **Browse**, search for PodNotes, then select **Install** and **Enable**.
-2. In **Settings → PodNotes**, search for a show or paste its RSS feed URL, then select **Add**.
-3. From the command palette, run **PodNotes: Show player**, then select the show and an episode to play it. In a note in editing view, run **PodNotes: Capture Timestamp**.
+2. In the PodNotes view, which opens in the right sidebar, search for a show or paste its RSS feed URL, then select the show.
+3. On the show's page, select an episode to play it.
+4. In a note in editing view, run **PodNotes: Capture Timestamp**, or select **Timestamp** in the player.
 
 [Getting started](https://podnotes.obsidian.guide/getting-started/) walks through each step.
 

docs/README.md

@@ -31,30 +31,37 @@ plugin's dependencies.
 - `public/` holds static assets served as-is. Older images live in
   `public/resources/` and stay for existing links.
 
-## Screenshots
+## Screenshots and clips
 
-Every screenshot in `public/screenshots/` comes from one script. From the repo
-root, after `npm run build`:
+Every screenshot in `public/screenshots/` and every clip in `public/videos/`
+comes from a script that drives this worktree's isolated Obsidian (see
+AGENTS.md) with the verify skill's screens tooling and its fixture podcasts.
+From the repo root:
 
 ```sh
+npm run build && npm run start:e2e-obsidian
 node docs/scripts/screenshots.mjs
+node docs/scripts/videos.mjs
 ```
 
-It builds a vault from `screenshots/` (the notes, a Bases file, the PodNotes
-settings in `seed.json`, and the Minimal theme), opens it in a private Obsidian
-capture instance at 2x, adds the podcast feeds through Settings, plays the
-episodes, creates notes and captures timestamps with PodNotes' own commands, and
-writes each shot as `<name>.webp` and `<name>-dark.webp`, with a
-`<name>-phone.webp` crop where the desktop shot is unreadable on a phone, plus
-the README demo
-GIFs and the social preview `og.png`. It needs network access for the feeds,
-their artwork, and the theme. The episodes in `seed.json` must still be among
-each feed's latest episodes. If one has left, pick a newer one and update its
-notes in `screenshots/notes/`.
+`screenshots.mjs` copies the notes in `screenshots/vault/` into the vault,
+creates episode notes and captures timestamps with PodNotes' own commands, as
+`screenshots/seed.json` plans them, and writes each shot at 2x as
+`<name>.webp` and `<name>-dark.webp`. Where the desktop shot is unreadable on a
+phone, it adds a `<name>-phone.webp` crop. It also writes the README demo GIFs
+and the social preview `og.png`.
+
+`videos.mjs` records each clip with real mouse or touch input at 2x, and writes
+`<name>.mp4`, a `<name>.webp` poster, and `-dark` twins for pages whose
+screenshots have them. Pass clip names to record only those, such as
+`node docs/scripts/videos.mjs transcript`.
 
 To show a screenshot on a page, write
 `![What it shows](/screenshots/<name>.webp)`. The site adds the size, lazy
-loading, the dark twin, and the phone crop if there is one.
+loading, the dark twin, and the phone crop if there is one. To show a clip,
+write `![What it shows](/videos/<name>.mp4)` after a sentence that says what
+the clip shows. The site plays it muted on a loop, or shows its poster with
+controls to readers who prefer reduced motion.
 
 ## Brand
 

docs/STYLE.md

@@ -85,6 +85,17 @@ other than the home page.
       captured in Obsidian's phone layout. The site shows it on narrow screens.
 - [ ] Alt text says what the screenshot shows in under 150 characters.
 
+## Clips
+
+- [ ] A clip shows a task of a few steps in 10 to 20 seconds. The steps stay in
+      the text.
+- [ ] `docs/scripts/videos.mjs` records every clip from the same fixtures.
+      Never add one by hand. Rerun the script after a UI change.
+- [ ] One sentence before the clip says what it shows, and its alt text names
+      it in under 150 characters. Alt text leaves out times such as 38:28,
+      because the site's directive syntax drops the `:28` from an alt.
+- [ ] Each clip is under about 1.5 MB.
+
 ## Before you merge
 
 - [ ] `npm run docs:build` passes. It checks links, legacy fragments, and that

docs/screenshots/notes/memory-palaces.md

@@ -0,0 +1,9 @@
+{{at 0:03:40}} Forgetting is the default. A note decides what I keep.
+{{at 0:14:05}} The forgetting curve: most of a new idea is gone within a day unless I come back to it.
+{{at 0:27:30}} Memory palace: put each idea in a room of a place I know by heart.
+{{at 0:36:12}} Make each image strange. The brain holds on to the absurd.
+
+**Follow up**
+
+- Try it with chapter 4 of [[How to Take Smart Notes]]
+- Exercise for [[Reading notes that stick]]: walk the room, then recall the argument

docs/screenshots/notes/slip-box.md

@@ -0,0 +1,7 @@
+{{at 0:04:10}} One idea per card, each with a fixed number, so a card can always point at another.
+{{at 0:21:45}} The links matter more than the cards. A card with no link is lost.
+{{at 0:48:30}} Forty years and 90,000 cards. He called it his partner in conversation.
+
+**Follow up**
+
+- Compare with [[How to Take Smart Notes]], chapter 2

docs/screenshots/seed.json

@@ -1,82 +1,49 @@
 {
-	"vaultName": "Notes",
-	"theme": {
-		"name": "Minimal",
-		"repo": "kepano/obsidian-minimal",
-		"version": "9.1.4"
-	},
-	"feeds": [
-		"https://feeds.simplecast.com/BqbsxVfO",
-		"https://feeds.npr.org/510289/podcast.xml",
-		"https://feeds.simplecast.com/EmVW7VGp",
-		"https://feeds.megaphone.fm/FSMI7575968096",
-		"https://feeds.transistor.fm/acquired",
-		"https://relay.fm/cortex/feed",
-		"https://feeds.simplecast.com/Y8lFbOT4",
-		"https://feeds.simplecast.com/6HKOhNgS",
-		"https://api.substack.com/feed/podcast/10845.rss"
-	],
-	"search": "the daily",
-	"settings": {
-		"episodeListLimit": 25
-	},
-	"noteTemplate": "---\ntype: podcastEpisode\npodcast: \"{{podcastlink}}\"\ndate: {{date:YYYY-MM-DD}}\nduration: \"{{duration}}\"\ntags:\n  - podcastEpisode\nstatus:\nrating:\n---\n![|96]({{artwork}})\n\n[Resume in PodNotes]({{episodelink}})\n\n> [!summary]- Episode description\n{{description:> }}\n\n## Notes\n\n",
+	"noteTemplate": "---\ntype: podcastEpisode\npodcast: \"{{podcastlink}}\"\ndate: {{date:YYYY-MM-DD}}\nduration: \"{{duration}}\"\ntags:\n  - podcastEpisode\nstatus:\nrating:\n---\n![|96]({{artwork}})\n\n{{episodelink:Resume in PodNotes}}\n\n> [!summary]- Episode description\n{{description:> }}\n\n## Notes\n\n",
 	"episodes": [
 		{
-			"podcast": "Cortex",
-			"title": "183: Scouting Indie Games for a Living, with Lucy James",
+			"podcast": "Signal & Noise",
+			"title": "Ep. 87",
+			"notes": "open-source.md",
 			"status": "next"
 		},
 		{
-			"podcast": "Planet Money",
-			"title": "The Domino’s Pizza Tracker Theory of Everything",
-			"notes": "pizza-tracker.md",
-			"status": "finished",
-			"rating": 4
+			"podcast": "Lunch Break History",
+			"title": "Medieval monks",
+			"status": "next"
 		},
 		{
-			"podcast": "Acquired",
-			"title": "The Home Depot",
+			"podcast": "Slow Thinking",
+			"title": "Walking as thinking",
 			"status": "finished",
 			"rating": 4
 		},
 		{
-			"podcast": "Radiolab",
-			"title": "Math Vs Machine",
-			"notes": "math-vs-machine.md",
-			"status": "next"
+			"podcast": "The Archive Hour",
+			"title": "Luhmann",
+			"notes": "slip-box.md",
+			"status": "finished",
+			"rating": 5
 		},
 		{
-			"podcast": "The Knowledge Project",
-			"title": "The 12 Years that Changed Steve Jobs",
-			"notes": "steve-jobs.md",
+			"podcast": "Field Notes",
+			"title": "#213",
+			"notes": "memory-palaces.md",
 			"status": "listening",
 			"rating": 5,
-			"playAt": 640,
-			"playbackRate": 1.5
+			"rename": "How to remember everything you read",
+			"playAt": 2294
 		}
 	],
 	"feedNotes": [
-		"Planet Money",
-		"The Knowledge Project",
-		"Acquired",
-		"Radiolab",
-		"Cortex"
+		"Field Notes",
+		"The Archive Hour",
+		"Slow Thinking",
+		"Lunch Break History",
+		"Signal & Noise"
 	],
-	"playlist": {
-		"name": "Commute",
-		"icon": "headphones",
-		"episodes": [
-			"A 4-Track Mind",
-			"Doves Type",
-			"Ferrari",
-			"Grass Apes",
-			"The Rocky Statue"
-		]
-	},
-	"maxTitleLength": 24,
 	"demo": {
-		"at": 698,
-		"note": "A perfect cube, and why the case took years."
+		"at": 2287,
+		"note": "Opportunity cost is a man at the door with two keys. Use it in the talk."
 	}
 }

docs/screenshots/vault/Daily/2026-10-09.md

@@ -1,4 +1,4 @@
 # Thursday, October 9
 
-- Finished the outline for [[Designing for the wait]].
-- Listened to The Knowledge Project on the NeXT years on the walk home. Notes in [[The 12 Years that Changed Steve Jobs]].
+- Finished the outline for [[Reading notes that stick]].
+- Listened to The Archive Hour on Luhmann's slip box on the walk home. Notes in [[Luhmanns slip box forty years later]].

docs/screenshots/vault/Daily/2026-10-10.md

@@ -1,4 +1,4 @@
 # Friday, October 10
 
 - Booked the room for the talk on the 24th.
-- Started the Planet Money episode on the pizza tracker. Notes in [[The Domino’s Pizza Tracker Theory of Everything]].
+- Started the Field Notes episode on memory palaces. Notes in [[How to remember everything you read]].

docs/screenshots/vault/Daily/2026-10-11.md

@@ -1,5 +1,5 @@
 # Saturday, October 11
 
-- [ ] Finish the pizza tracker notes
+- [ ] Finish the memory palace notes
 - [ ] Pick three examples for the slides
 - Coffee with Maya at 10

docs/screenshots/vault/Home.md

@@ -1,6 +1,6 @@
 # Home
 
 - [[Daily/2026-10-11|Today]]
-- [[Projects/Designing for the wait|Designing for the wait]]
+- [[Projects/Reading notes that stick|Reading notes that stick]]
 - [[PodNotes/Episodes.base|Podcast episodes]]
-- [[Reading/The Design of Everyday Things|Currently reading]]
+- [[Reading/How to Take Smart Notes|Currently reading]]

docs/screenshots/vault/Projects/Reading notes that stick.md

@@ -0,0 +1,19 @@
+---
+tags:
+  - project
+due: 2026-10-24
+---
+# Reading notes that stick
+
+A 20 minute talk on how to keep what you read and hear.
+
+## Examples
+
+- Memory palaces. Notes in [[How to remember everything you read]].
+- A slip box that grows for decades. See [[Luhmanns slip box forty years later]].
+- Queued: [[Medieval monks and the first sticky notes]].
+
+## Open questions
+
+- Start with the memory palace or end with it?
+- How many examples before the first exercise?

docs/screenshots/vault/Reading/How to Take Smart Notes.md

@@ -0,0 +1,11 @@
+---
+author: Sönke Ahrens
+status: reading
+tags:
+  - book
+---
+# How to Take Smart Notes
+
+- Write each idea in your own words, one idea per note.
+- Compare with the memory palace episode: both turn an idea into something you can find again.
+- Chapter 4 next.