<podcast:image> - refinement of <podcast:images> #694
Replies: 4 comments 4 replies
-
I have a doubt about the
So I assume this would be correct: Testing implementation: |
Beta Was this translation helpful? Give feedback.
-
|
In Javascript, it’s only about 20 lines to handle both decimals and ratios: function parseAspectRatio(input) {
if (typeof input === 'number') {
return input; // Already a decimal, return as is
}
if (typeof input === 'string') {
input = input.replace(/\s+/g, ''); // Remove all whitespace
if (input.includes('/')) {
const [numerator, denominator] = input.split('/').map(Number);
if (!isNaN(numerator) && !isNaN(denominator) && denominator !== 0) {
return numerator / denominator;
}
} else {
const decimal = parseFloat(input);
if (!isNaN(decimal)) {
return decimal;
}
}
}
throw new Error('Invalid aspect ratio format');
} |
Beta Was this translation helpful? Give feedback.
-
|
Since |
Beta Was this translation helpful? Give feedback.
-
|
You're right. Thanks Nathan. |
Beta Was this translation helpful? Give feedback.
-
|
Just a suggestion - https://podcasting2.org/podcast-namespace/tags/images suggests that Instead of deprecating
I'd be happy to do that work if it's helpful to do so. |
Beta Was this translation helpful? Give feedback.
-
|
I'm fine with that. I can reach out to them and discuss in the board meeting as well. |
Beta Was this translation helpful? Give feedback.
-
|
I have Ilya and Thomas's email, and @samsethi is here. |
Beta Was this translation helpful? Give feedback.
-
|
Yeah this will work, and its great we can remove Banners #527 tag and replace it with this tag, I don't mind if it is called image or images. Thank you @daveajones |
Beta Was this translation helpful? Give feedback.
-
After much discussion over #645, I'm going to refine @nathangathright's proposal into what I think/hope we can all be happy with:
Image
<podcast:image>This tag allows for the delivering of images of various sizes and use cases. It is cross-compatible with the
<itunes:image>tag but expands the use cases for delivering more than just square channel or episode art.Parent
<channel>or<item>or<podcast:liveItem>Count
Multiple
Attributes
Notes
The only required attribute is
href, specifying the url of the asset being delivered. For accessibility,altis also encouraged.The
aspect-ratioandwidthare also encouraged, as they give app developers important information about how they can display your image within their UI. Aheightattribute is also available, but not critical ifaspect-ratioandwidthare provided.The
typeattribute is available for use if the asset being delivered is not a typical image format (JPG/PNG/etc). For instance, if it's a video file, or something a-typical like a WEBP or TIFF image.The
purposetype is encouraged to provide an expected use case to app developers as a display hint. Why was this<podcast:image>included in the feed? What did the podcast creator intend to be done with it? See a fuller explanation of thepurposeattribute below.Purpose Tokens
The purpose attribute gives podcasters the flexibility to indicate how specific images should be used by podcast apps and other platforms. This attribute accepts a space-separated list of tokens, where each token corresponds to a potential use case or context. While podcast apps may choose whether to honor these tokens, they allow podcasters to signal intent for how their images should be utilized across different platforms and contexts.
Anyone may define a token and its requirements. For instance, an app might define a token like
truefans/heroto specify an image that fits their hero banner layout, providing guidelines for aspect ratios, resolution, safe areas, or text presence. A podcaster following these guidelines would include thetruefans/herotoken in the purpose attribute for any media following those guidelines. Here are some suggestions for generic tokens that multiple apps might adopt:Spotify’s Canvas
Examples
The most basic use cases
Standard square image. Assumed to be 1/1 aspect ratio intended for either podcast art or episode art, depending on if it's in the
<channel>or<item>.Using
altto describe the imageUsing
typeto provide a video fileUsing
widthandheightinstead of giving an aspect ratioUsing
aspect-ratioUsing
purposeUsing
aspect-ratioandpurposeto provide multiple art directionsMultiple image tags in the feed allow apps to select from multiple aspect ratios and media formats to display.
More complex examples
Beta Was this translation helpful? Give feedback.
All reactions