From 5fde7ff2a75904b2827c0769bb6eff267b5de567 Mon Sep 17 00:00:00 2001
From: wmj <wmj@falahos.my>
Date: Mon, 12 Oct 2026 01:53:42 +0000
Subject: [PATCH] docs: update Falah Cast podcast RSS syndication manual for
 YouTube, Apple, Spotify

---
 README.md | 74 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 72 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index ca7fd26..e10191c 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,73 @@
-# falah-cast-feed
+# Falah Cast — Official Podcast Feed & Syndication Manual
 
-Public podcast feed + artwork for Falah Cast (iqra.falahos.my). Auto-generated daily.
\ No newline at end of file
+Public podcast feed + artwork for **Falah Cast** ([iqra.falahos.my/tag/falah-cast/](https://iqra.falahos.my/tag/falah-cast/)).  
+Published by **Darul Falah** & *Iqra Times*.
+
+---
+
+## 1. Live Feed URLs
+
+* **Primary Raw Podcast RSS (Gitea Raw):**  
+  `https://git.falahos.my/falah/falah-cast-feed/raw/branch/main/podcast.xml`
+* **Ghost Publication Archive RSS:**  
+  `https://iqra.falahos.my/tag/falah-cast/rss/`
+* **Official Cover Artwork (1400x1400px minimum):**  
+  `https://git.falahos.my/falah/falah-cast-feed/raw/branch/main/falahcast-cover.png`
+
+---
+
+## 2. Platform Submission Guide
+
+### A. YouTube Podcasts (RSS Ingestion)
+1. Navigate to **YouTube Studio** (`studio.youtube.com`).
+2. Click **Create** (top right) → **New Podcast** → Select **Submit RSS Feed**.
+3. Paste the raw podcast feed URL:
+   ```
+   https://git.falahos.my/falah/falah-cast-feed/raw/branch/main/podcast.xml
+   ```
+4. Verify email ownership via the verification code sent to `editor@iqra.falahos.my`.
+5. YouTube will automatically ingest all 42 episodes, match the audio from `<enclosure type="audio/mpeg"/>`, and create individual video episodes with the episode thumbnail art.
+
+### B. Apple Podcasts Connect
+1. Sign in to **Apple Podcasts Connect** (`podcastsconnect.apple.com`).
+2. Click **+** (Add Show) → **Add a show with an RSS feed**.
+3. Enter the URL:
+   ```
+   https://git.falahos.my/falah/falah-cast-feed/raw/branch/main/podcast.xml
+   ```
+4. Review show details: Category is mapped to `Society & Culture > Philosophy` and `Education`.
+5. Click **Submit for Review**.
+
+### C. Spotify for Podcasters
+1. Sign in to **Spotify for Podcasters** (`podcasters.spotify.com`).
+2. Click **Claim Show** or **Add a new show**.
+3. Paste the RSS feed link and confirm ownership.
+
+---
+
+## 3. Feed Architecture & Compliance Specifications
+
+* **Specification:** RSS 2.0 with `xmlns:itunes` and `xmlns:podcast`.
+* **Audio Enclosure:** Every `<item>` MUST contain an `<enclosure>` tag with:
+  - `url`: Direct accessible MP3 URL (e.g. `https://iqra.falahos.my/content/media/2026/10/...mp3`).
+  - `length`: File byte length.
+  - `type`: `audio/mpeg` (mandatory for YouTube and Apple).
+* **Artwork Requirements:**
+  - Standard iTunes Cover Art: Minimum 1400x1400px up to 3000x3000px, RGB, JPEG or PNG.
+* **Episode Metadata:**
+  - `<itunes:duration>` (Seconds or HH:MM:SS)
+  - `<itunes:explicit>`: `false`
+  - `<guid isPermaLink="false">` unique ID per episode.
+
+---
+
+## 4. Regenerating the RSS Feed
+
+To regenerate the podcast feed when new episodes are published on Ghost:
+```bash
+python3 /Users/wanjauhari24/.gemini/antigravity-cli/brain/779b3a05-a495-407b-83bb-a82b23766837/scratch/update_falah_cast_rss.py
+```
+Or execute the automated Gitea webhook / cron pipeline.
+
+---
+*© 2026 Darul Falah. All rights reserved.*