Hacker News Reader

Comment by mro_name | Hacker News Reader

100% includes iTunes or Podcatchers in general where I hardly find documentation for but would be interested for (my) https://mro.name/radio-privatkopie/

Can you give me a pointer how to write the Atom podcast feed?

View on HN

Podcasting is kind of a special case, since Apple's guidelines mandate the use of RSS [1]. So if you're publishing a podcast and you want to get into the Apple Podcasts directory, you have to publish a RSS 2.0 feed (as well as meet all their other extra requirements).

If you don't care about the Apple Podcasts directory you can publish an Atom podcast feed that will work with most podcatchers. The primary thing you do differently from a normal Atom feed is to use the `link` element with `rel=enclosure` to reference the audio file for each episode/entry.

    <link rel="enclosure" href="http://example.com/audio.m4a" length="100" type="audio/mp4" />

I wrote Splitflap, the valid RSS/Atom feed generator package for Racket [2]. Not many folks use Racket but you might find the docs a good resource on this sort of thing anyway.

[1]: https://podcasters.apple.com/support/823-podcast-requirement...

[2]: https://docs.racket-lang.org/splitflap/index.html

I have some like this http://rec.mro.name/podcasts/zuendfunk/broadcasts.atom (and .rss, too) which plays the audio nicely e.g. in https://miniflux.app but I remember having trouble with iTunes on MacOS and the Apple podcast iOS app.

But his is mostly try-and-error and merely no specs. Apple doesn't talk about atom AFAIK.

Racket is interesting, I'm into Ocaml, but create those feeds via https://codeberg.org/mro/internet-radio-recorder/src/branch/...

Hey thanks for your comment. Today I actually added support for this. If you make a markdown link to an audio file it will create an RSS enclosure. Including the file length (if it can be retrieved from header information).

[audio/mpeg](http://example.mp3)

Reply on news.ycombinator.com