From 7d5e86d26da3ac38f947530b9f6f689820dc6f38 Mon Sep 17 00:00:00 2001 From: James Cridland Date: Mon, 2 Aug 2021 12:33:58 +1000 Subject: [PATCH] Update 1.0.md Explanation about how fast-follow share links work, as a subsection of `podcast:guid`. --- docs/1.0.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/docs/1.0.md b/docs/1.0.md index 17fc3ea..369a664 100644 --- a/docs/1.0.md +++ b/docs/1.0.md @@ -504,4 +504,18 @@ Example GUID for feed url `podnews.net/rss`: ```xml 9b024349-ccf0-5f69-a609-6b82873eab3c -``` \ No newline at end of file +``` + +### Guid-enabled fast-follow share links +The `podcast:guid` value above enables podcasters to produce a link that can share a podcast on a variety of different platforms. + +The format of the link is `https://(a podcast website link)#fastfollow-(type):(a podcast guid)` + +`type` is currently `podcast`, but may be extended in future. + +A working example is https://podnews.net/podcast/i8xe9/listen#fastfollow-podcast:9b024349-ccf0-5f69-a609-6b82873eab3c or the QR code given below. +![podnews-qr](https://user-images.githubusercontent.com/231941/127796108-d819de43-6c0e-4c7b-9579-ed1f19989443.png) + +When scanned on a mobile phone's camera app, this link will go to the specified podcast website. Behavior of this website is up to the creator: some may use a default homepage, others may sniff the useragent and open a default podcast app on a device. In the working example, above, an iPhone user may be taken to Apple Podcasts; an Android user may be taken to Google Podcasts; and another device will be given a page with a player. + +When scanned on a QR code reader inside a podcast app, like [CurioCaster](https://curiocaster.com/), the app can parse the `podcast:guid` value from the URL, allowing the podcast to be opened within the application.