Skip to content
Merged
Changes from 12 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
76 changes: 76 additions & 0 deletions docs/060-meetings-and-communication/publishing-podcasts.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,76 @@
---
title: Publishing meetings as podcasts
weight: 40
---

# FAQ

## Publishing recorded meetings as podcasts on AsyncAPI
This document covers FAQs on publishing recorded AsyncAPI meetings as podcasts. It is intended to guide any AsyncAPI member who has the rights/access to stream and record meetings; on how to publish the recorded meetings as podcasts. For more information on streaming and recording meetings, check the [Meetings-Organization](https://www.asyncapi.com/docs/community/060-meetings-and-communication/MEETINGS_ORGANIZATION) document.

### Why do we need this feature?

- Some people prefer to listen to the video/livestream as an audio (podcast) instead of watching the video.

- The goal is to upload our AsyncAPI video/live streams on `Spotify For Podcasters` platform, ultimately allowing the listener to play the episodes on Spotify. Almost every YouTube video can be converted into a podcast.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Brand casing: “Spotify for Podcasters.”

Use official styling.

- - The goal is to upload our AsyncAPI video/live streams on `Spotify For Podcasters` platform, ultimately allowing the listener to play the episodes on Spotify. Almost every YouTube video can be converted into a podcast.
+ - The goal is to upload our AsyncAPI video/live streams on `Spotify for Podcasters`, ultimately allowing the listener to play the episodes on Spotify. Almost every YouTube video can be converted into a podcast.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- The goal is to upload our AsyncAPI video/live streams on `Spotify For Podcasters` platform, ultimately allowing the listener to play the episodes on Spotify. Almost every YouTube video can be converted into a podcast.
- The goal is to upload our AsyncAPI video/live streams on `Spotify for Podcasters`, ultimately allowing the listener to play the episodes on Spotify. Almost every YouTube video can be converted into a podcast.
🤖 Prompt for AI Agents
In docs/060-meetings-and-communication/publishing-podcasts.md around line 15,
the phrase "Spotify For Podcasters" uses incorrect brand casing; change it to
the official styling "Spotify for Podcasters." and update any other occurrences
in the file to match exact brand casing and punctuation.



### Who can upload the videos?

- Anyone with write access to the `asyncapi/community` repository’s `master` branch.

### What is needed?

- The YouTube video ID.

### What is a YouTube video ID?
The video ID is an 11-character alphanumeric string that uniquely identifies a YouTube video.
ID is usually the last part of the URL after `v=` or separated by a forward slash (`/`):
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
- https://www.youtube.com/shorts/VIDEO_ID
- https://www.youtube.com/embed/VIDEO_ID
You may also find URLs with a video in a playlist: `https://www.youtube.com/watch?v=VIDEO_ID&list=PLAYLIST_ID`
Here, video ID is located between `?v=` and `&list=` URL parameters.
**This workflow accepts only the YouTube *video ID*, not a full URL or playlist. You need to extract the `VIDEO_ID` and provide it as an input.**

- [More examples](#list-of-different-types-of-youtube-links) of video ID are given below: ⬇️

#### How to find YouTube ID?

Let's take this video link, for example: https://www.youtube.com/watch?v=3rg_7hIb9PQ.

Here the video ID is the word/entity after `https://www.youtube.com/watch?v=`, i.e., `3rg_7hIb9PQ`

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

Autolink the example and format the extracted ID

-Let's take this video link, for example: https://www.youtube.com/watch?v=3rg_7hIb9PQ.
+Let's take this video link, for example: <https://www.youtube.com/watch?v=3rg_7hIb9PQ>.
-Here the video ID is the word/entity after `https://www.youtube.com/watch?v=`, i.e., `3rg_7hIb9PQ`
+Here the video ID is the part after `https://www.youtube.com/watch?v=`, i.e., `3rg_7hIb9PQ`.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
Let's take this video link, for example: https://www.youtube.com/watch?v=3rg_7hIb9PQ.
Here the video ID is the word/entity after `https://www.youtube.com/watch?v=`, i.e., `3rg_7hIb9PQ`
Let's take this video link, for example: <https://www.youtube.com/watch?v=3rg_7hIb9PQ>.
Here the video ID is the part after `https://www.youtube.com/watch?v=`, i.e., `3rg_7hIb9PQ`.
🧰 Tools
🪛 markdownlint-cli2 (0.17.2)

41-41: Bare URL used

(MD034, no-bare-urls)

🤖 Prompt for AI Agents
In docs/060-meetings-and-communication/publishing-podcasts.md around lines 41 to
44, the plain URL example should be made clickable and the extracted video ID
should be formatted as inline code; replace the raw URL with a Markdown/autolink
(e.g., <https://www.youtube.com/watch?v=3rg_7hIb9PQ> or a standard Markdown
link) and wrap the ID 3rg_7hIb9PQ in inline code formatting so it stands out as
an extracted identifier.


### List of different types of YouTube links

- `https://www.youtube.com/watch?v=VIDEO_ID`
- Here, it can be https://www.youtube.com/watch?v=3rg_7hIb9PQ
- `https://youtu.be/VIDEO_ID`
- Here, it can be https://www.youtu.be/3rg_7hIb9PQ
- `https://www.youtube.com/embed/VIDEO_ID`
- Here, it can be https://www.youtube.com/embed/3rg_7hIb9PQ
- `https://www.youtube.com/playlist?list=PLAYLIST_ID`
- Here, it can be https://www.youtube.com/playlist?list=PLbi1gRlP7piiaD67o1F4EOPoZztg2r8l6
- `https://www.youtube.com/shorts/VIDEO_ID`
- Here, it can be https://www.youtube.com/shorts/3rg_7hIb9PQ
- `https://www.youtube.com/watch?v=VIDEO_ID&list=PLAYLIST_ID`
- Here, it can be https://www.youtube.com/watch?v=deLUAobdVpw&list=PLbi1gRlP7piiaD67o1F4EOPoZztg2r8l6
- `https://youtube.com/shorts/VIDEO_ID?feature=share`
- Here, it can be https://youtube.com/shorts/U5jUr8XAF_M?feature=share

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

Wrap bare URLs in examples and fix invalid youtu.be domain.

   - `https://www.youtube.com/watch?v=VIDEO_ID`
-   - Here, it can be https://www.youtube.com/watch?v=3rg_7hIb9PQ
+   - Here, it can be <https://www.youtube.com/watch?v=3rg_7hIb9PQ>
   - `https://youtu.be/VIDEO_ID`
-   - Here, it can be https://www.youtu.be/3rg_7hIb9PQ
+   - Here, it can be <https://youtu.be/3rg_7hIb9PQ>
   - `https://www.youtube.com/embed/VIDEO_ID`
-   - Here, it can be https://www.youtube.com/embed/3rg_7hIb9PQ
+   - Here, it can be <https://www.youtube.com/embed/3rg_7hIb9PQ>
-  - `https://www.youtube.com/playlist?list=PLAYLIST_ID`
-  - Here, it can be https://www.youtube.com/playlist?list=PLbi1gRlP7piiaD67o1F4EOPoZztg2r8l6
+  - `https://www.youtube.com/playlist?list=PLAYLIST_ID`
+  - Here, it can be <https://www.youtube.com/playlist?list=PLbi1gRlP7piiaD67o1F4EOPoZztg2r8l6>
   - `https://www.youtube.com/shorts/VIDEO_ID`
-  - Here, it can be https://www.youtube.com/shorts/3rg_7hIb9PQ
+  - Here, it can be <https://www.youtube.com/shorts/3rg_7hIb9PQ>
   - `https://www.youtube.com/watch?v=VIDEO_ID&list=PLAYLIST_ID`
-  - Here, it can be https://www.youtube.com/watch?v=deLUAobdVpw&list=PLbi1gRlP7piiaD67o1F4EOPoZztg2r8l6
+  - Here, it can be <https://www.youtube.com/watch?v=deLUAobdVpw&list=PLbi1gRlP7piiaD67o1F4EOPoZztg2r8l6>
   - `https://youtube.com/shorts/VIDEO_ID?feature=share`
-  - Here, it can be https://youtube.com/shorts/U5jUr8XAF_M?feature=share
+  - Here, it can be <https://youtube.com/shorts/U5jUr8XAF_M?feature=share>
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- `https://www.youtube.com/watch?v=VIDEO_ID`
- Here, it can be https://www.youtube.com/watch?v=3rg_7hIb9PQ
- `https://youtu.be/VIDEO_ID`
- Here, it can be https://www.youtu.be/3rg_7hIb9PQ
- `https://www.youtube.com/embed/VIDEO_ID`
- Here, it can be https://www.youtube.com/embed/3rg_7hIb9PQ
- `https://www.youtube.com/playlist?list=PLAYLIST_ID`
- Here, it can be https://www.youtube.com/playlist?list=PLbi1gRlP7piiaD67o1F4EOPoZztg2r8l6
- `https://www.youtube.com/shorts/VIDEO_ID`
- Here, it can be https://www.youtube.com/shorts/3rg_7hIb9PQ
- `https://www.youtube.com/watch?v=VIDEO_ID&list=PLAYLIST_ID`
- Here, it can be https://www.youtube.com/watch?v=deLUAobdVpw&list=PLbi1gRlP7piiaD67o1F4EOPoZztg2r8l6
- `https://youtube.com/shorts/VIDEO_ID?feature=share`
- Here, it can be https://youtube.com/shorts/U5jUr8XAF_M?feature=share
- `https://www.youtube.com/watch?v=VIDEO_ID`
- Here, it can be <https://www.youtube.com/watch?v=3rg_7hIb9PQ>
- `https://youtu.be/VIDEO_ID`
- Here, it can be <https://youtu.be/3rg_7hIb9PQ>
- `https://www.youtube.com/embed/VIDEO_ID`
- Here, it can be <https://www.youtube.com/embed/3rg_7hIb9PQ>
- `https://www.youtube.com/playlist?list=PLAYLIST_ID`
- Here, it can be <https://www.youtube.com/playlist?list=PLbi1gRlP7piiaD67o1F4EOPoZztg2r8l6>
- `https://www.youtube.com/shorts/VIDEO_ID`
- Here, it can be <https://www.youtube.com/shorts/3rg_7hIb9PQ>
- `https://www.youtube.com/watch?v=VIDEO_ID&list=PLAYLIST_ID`
- Here, it can be <https://www.youtube.com/watch?v=deLUAobdVpw&list=PLbi1gRlP7piiaD67o1F4EOPoZztg2r8l6>
- `https://youtube.com/shorts/VIDEO_ID?feature=share`
- Here, it can be <https://youtube.com/shorts/U5jUr8XAF_M?feature=share>
🧰 Tools
🪛 markdownlint-cli2 (0.17.2)

43-43: Bare URL used

(MD034, no-bare-urls)


45-45: Bare URL used

(MD034, no-bare-urls)


47-47: Bare URL used

(MD034, no-bare-urls)


49-49: Bare URL used

(MD034, no-bare-urls)


51-51: Bare URL used

(MD034, no-bare-urls)


53-53: Bare URL used

(MD034, no-bare-urls)


55-55: Bare URL used

(MD034, no-bare-urls)

🤖 Prompt for AI Agents
In docs/060-meetings-and-communication/publishing-podcasts.md around lines 42 to
56, the example URLs are bare (triggering MD034) and one entry uses the invalid
domain "www.youtu.be"; update the examples by autolinking each URL (wrap each
example URL in <> so they render as links) and replace "https://www.youtu.be/…"
with the correct short-domain form "https://youtu.be/…", keeping all other
example URLs unchanged and ensuring consistent https scheme.


### Step-by-step procedure

1. Open the Upload Episode from YouTube To Spotify for Podcasters actions workflow in the `<repo name>` repository
2. Click on the `Run Workflow` button.
3. Provide the YouTube ID in the box.
4. Click on `Run workflow` button.
5. Wait for the workflow to finish (It may take some time to upload the video).

(Optional) You can modify the description and other information for the uploaded podcast directly in Spotify:
1. Go to https://creators.spotify.com/.
2. Login using AsyncAPI account.
3. Go to the 'Episodes' section to see your latest upload.
4. Perform edits and save them.
Loading