Podcast Notes
A content creation toolkit for podcast producers. Podcast Notes provides 12 dedicated commands for drafting show notes, editing content, optimizing text, scheduling episodes, generating hashtags, writing hooks, creating CTAs, rewriting copy, translating content, adjusting tone, crafting headlines, and building outlines — all backed by timestamped log files.
Commands
| Command |
Description |
podcast-notes draft <input> |
Draft show notes or episode content. Without args, shows recent draft entries. |
podcast-notes edit <input> |
Log an edit pass on existing content (corrections, restructuring). Without args, shows recent edit entries. |
podcast-notes optimize <input> |
Record SEO or engagement optimization notes (keywords, structure). Without args, shows recent optimize entries. |
podcast-notes schedule <input> |
Log scheduling decisions (publish date, release cadence). Without args, shows recent schedule entries. |
podcast-notes hashtags <input> |
Save hashtag sets for episodes or social media promotion. Without args, shows recent hashtag entries. |
podcast-notes hooks <input> |
Record attention-grabbing hooks for episode intros or social clips. Without args, shows recent hook entries. |
podcast-notes cta <input> |
Save call-to-action copy (subscribe prompts, review requests, links). Without args, shows recent CTA entries. |
podcast-notes rewrite <input> |
Log rewritten versions of content for A/B testing or improvement. Without args, shows recent rewrite entries. |
podcast-notes translate <input> |
Record translated content or translation notes for multi-language episodes. Without args, shows recent translate entries. |
podcast-notes tone <input> |
Log tone adjustment notes (casual, professional, energetic, storytelling). Without args, shows recent tone entries. |
podcast-notes headline <input> |
Save episode title ideas and headline variations. Without args, shows recent headline entries. |
podcast-notes outline <input> |
Record episode outlines with segments, timing, and topic flow. Without args, shows recent outline entries. |
podcast-notes stats |
Show summary statistics across all categories — entry counts per log file, total entries, and data size. |
podcast-notes export <fmt> |
Export all data to a file. Supported formats: json, csv, txt. |
podcast-notes search <term> |
Search across all log files for a keyword (case-insensitive). |
podcast-notes recent |
Show the 20 most recent entries from the activity history log. |
podcast-notes status |
Health check — version, data directory, total entries, disk usage, last activity. |
podcast-notes help |
Display the full help message with all available commands. |
podcast-notes version |
Print the current version (v2.0.0). |
Data Storage
All data is stored as plain-text log files in ~/.local/share/podcast-notes/:
- Each command writes to its own log file (e.g.
draft.log, hashtags.log, outline.log)
- Every action is also recorded in
history.log with a timestamp
- Entries use the format
YYYY-MM-DD HH:MM|<input> (pipe-delimited)
- Export produces files at
~/.local/share/podcast-notes/export.{json,csv,txt}
- No database required — all data is grep-friendly and human-readable
Requirements
- Bash 4+ (uses
set -euo pipefail)
- Standard Unix utilities:
date, wc, du, head, tail, grep, cat, cut
- No external dependencies — pure bash, no Python, no API keys
- Works on Linux and macOS
When to Use
- Episode pre-production — Use
outline to structure your episode segments, hooks to craft an attention-grabbing intro, and schedule to lock in your publish date.
- Show notes creation — Run
draft to write initial show notes, edit to refine them, and optimize with SEO keywords for better discoverability.
- Social media promotion — Use
hashtags to generate tag sets, headline to test different episode titles, and cta to create share-worthy call-to-action copy.
- Multi-language distribution — Log
translate entries for episode descriptions in different languages, and tone to adjust the style for different regional audiences.
- Content repurposing — Use
rewrite to transform episode content into blog posts, newsletters, or social clips, keeping all versions tracked with timestamps.
Examples
# Draft show notes for a new episode
podcast-notes draft "Ep 42: Interview with Jane on AI trends — key topics: LLMs, agents, open source"
# Create a hook for the episode intro
podcast-notes hooks "What if your AI assistant could actually think? Today we talk to someone building exactly that."
# Save hashtag ideas for social promotion
podcast-notes hashtags "#podcast #AI #LLM #techtalks #futureofwork #ep42"
# Log an episode outline with segments
podcast-notes outline "Intro (2min) -> Guest intro (3min) -> Topic 1: LLMs (10min) -> Topic 2: Agents (10min) -> Q&A (5min) -> Outro (2min)"
# Export all content to JSON for your CMS
podcast-notes export json
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
1---2name: podcast-notes3description: 播客大纲、Show Notes生成、开场白、嘉宾问题、变现策略、分发渠道。Podcast assistant with outlines, show notes, intro scripts, guest questions, monetization strategies.4---5# Podcast Notes
6
7A content creation toolkit for podcast producers. Podcast Notes provides 12 dedicated commands for drafting show notes, editing content, optimizing text, scheduling episodes, generating hashtags, writing hooks, creating CTAs, rewriting copy, translating content, adjusting tone, crafting headlines, and building outlines — all backed by timestamped log files.
8
9## Commands
10
11| Command | Description |
12|---------|-------------|
13| `podcast-notes draft <input>` | Draft show notes or episode content. Without args, shows recent draft entries. |
14| `podcast-notes edit <input>` | Log an edit pass on existing content (corrections, restructuring). Without args, shows recent edit entries. |
15| `podcast-notes optimize <input>` | Record SEO or engagement optimization notes (keywords, structure). Without args, shows recent optimize entries. |
16| `podcast-notes schedule <input>` | Log scheduling decisions (publish date, release cadence). Without args, shows recent schedule entries. |
17| `podcast-notes hashtags <input>` | Save hashtag sets for episodes or social media promotion. Without args, shows recent hashtag entries. |
18| `podcast-notes hooks <input>` | Record attention-grabbing hooks for episode intros or social clips. Without args, shows recent hook entries. |
19| `podcast-notes cta <input>` | Save call-to-action copy (subscribe prompts, review requests, links). Without args, shows recent CTA entries. |
20| `podcast-notes rewrite <input>` | Log rewritten versions of content for A/B testing or improvement. Without args, shows recent rewrite entries. |
21| `podcast-notes translate <input>` | Record translated content or translation notes for multi-language episodes. Without args, shows recent translate entries. |
22| `podcast-notes tone <input>` | Log tone adjustment notes (casual, professional, energetic, storytelling). Without args, shows recent tone entries. |
23| `podcast-notes headline <input>` | Save episode title ideas and headline variations. Without args, shows recent headline entries. |
24| `podcast-notes outline <input>` | Record episode outlines with segments, timing, and topic flow. Without args, shows recent outline entries. |
25| `podcast-notes stats` | Show summary statistics across all categories — entry counts per log file, total entries, and data size. |
26| `podcast-notes export <fmt>` | Export all data to a file. Supported formats: `json`, `csv`, `txt`. |
27| `podcast-notes search <term>` | Search across all log files for a keyword (case-insensitive). |
28| `podcast-notes recent` | Show the 20 most recent entries from the activity history log. |
29| `podcast-notes status` | Health check — version, data directory, total entries, disk usage, last activity. |
30| `podcast-notes help` | Display the full help message with all available commands. |
31| `podcast-notes version` | Print the current version (v2.0.0). |
32
33## Data Storage
34
35All data is stored as plain-text log files in `~/.local/share/podcast-notes/`:
36
37- Each command writes to its own log file (e.g. `draft.log`, `hashtags.log`, `outline.log`)
38- Every action is also recorded in `history.log` with a timestamp
39- Entries use the format `YYYY-MM-DD HH:MM|<input>` (pipe-delimited)
40- Export produces files at `~/.local/share/podcast-notes/export.{json,csv,txt}`
41- No database required — all data is grep-friendly and human-readable
42
43## Requirements
44
45- **Bash 4+** (uses `set -euo pipefail`)
46- **Standard Unix utilities**: `date`, `wc`, `du`, `head`, `tail`, `grep`, `cat`, `cut`
47- **No external dependencies** — pure bash, no Python, no API keys
48- Works on **Linux** and **macOS**
49
50## When to Use
51
521. **Episode pre-production** — Use `outline` to structure your episode segments, `hooks` to craft an attention-grabbing intro, and `schedule` to lock in your publish date.
532. **Show notes creation** — Run `draft` to write initial show notes, `edit` to refine them, and `optimize` with SEO keywords for better discoverability.
543. **Social media promotion** — Use `hashtags` to generate tag sets, `headline` to test different episode titles, and `cta` to create share-worthy call-to-action copy.
554. **Multi-language distribution** — Log `translate` entries for episode descriptions in different languages, and `tone` to adjust the style for different regional audiences.
565. **Content repurposing** — Use `rewrite` to transform episode content into blog posts, newsletters, or social clips, keeping all versions tracked with timestamps.
57
58## Examples
59
60```bash
61# Draft show notes for a new episode
62podcast-notes draft "Ep 42: Interview with Jane on AI trends — key topics: LLMs, agents, open source"
63
64# Create a hook for the episode intro
65podcast-notes hooks "What if your AI assistant could actually think? Today we talk to someone building exactly that."
66
67# Save hashtag ideas for social promotion
68podcast-notes hashtags "#podcast #AI #LLM #techtalks #futureofwork #ep42"
69
70# Log an episode outline with segments
71podcast-notes outline "Intro (2min) -> Guest intro (3min) -> Topic 1: LLMs (10min) -> Topic 2: Agents (10min) -> Q&A (5min) -> Outro (2min)"
72
73# Export all content to JSON for your CMS
74podcast-notes export json
75```
76
77---
78
79Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
bytesagain