Skip to content

Update podcaster docs to use Podcast Index self-service add flow#508

Merged
ByteHamster merged 3 commits into
masterfrom
copilot/update-documentation-for-podcasters
May 12, 2026
Merged

Update podcaster docs to use Podcast Index self-service add flow#508
ByteHamster merged 3 commits into
masterfrom
copilot/update-documentation-for-podcasters

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 12, 2026

Podcaster documentation still directed users to hoster/API-based feed submission for Podcast Index. This updates the guidance to reflect the current self-service flow where creators can add their feed and description directly on Podcast Index.

  • What changed

    • Updated English podcaster guide content in:
      • _i18n/en/documentation/podcasters-hosters/list-podcast.md
    • Replaced the Podcast Index API-focused instruction with the direct add-page flow.
  • Documentation behavior update

    • Before: suggested asking hoster or adding via API.
    • Now: points creators to Podcast Index’s add page to submit feed + description.
* [Podcast Index](https://podcastindex.org/) (ask your hoster how to add your podcast, or add your own podcast and description via [their add page](https://podcastindex.org/add))

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • accounts.google.com
    • Triggering command: /proc/self/exe /proc/self/exe --type=utility --utility-sub-type=network.mojom.NetworkService --lang=en-US --service-sandbox-type=network --no-sandbox --use-angle=swiftshader-webgl --crashpad-handler-pid=6595 --enable-crash-reporter=, --noerrdialogs --user-data-dir=/tmp/org.chromium.Chromium.scoped_dir.mymYFu --change-stack-guard-on-fork=enable --shared-files=network_parent_dirs_pipe:100,v8_context_snapshot_data:101 --field-trial-handle=3,i,8945436319623663532,8350020255563320033,262144 --disable-features=PaintHolding --variations-seed-version --pseudonymization-salt-handle=7,i,10826472646558520610,14225711270022339713,4 --trace-process-track-uuid=3190708989122997041 -I y-3.2.0 (dns block)
    • Triggering command: /usr/bin/chromium-browser chromium-browser --headless --disable-gpu --no-sandbox --screenshot=/tmp/list-podcast-doc.png --window-size=1440,2000 file:///home/REDACTED/work/antennapod.github.io/antennapod.github.io/_site/documentation/podcasters-hosters/list-podcast.html --gdwarf-5 --64 -o static_literals.o /tmp/cccgTV9c.s s u/13/liblto_plug-I _64-linux-gnu/13/usr/include/ruby-3.2.0/ruby/backward or/bundle/ruby/3-I -I or/bundle/ruby/3-I -I y-3.2.0 (dns block)
  • clients2.google.com
    • Triggering command: /proc/self/exe /proc/self/exe --type=utility --utility-sub-type=network.mojom.NetworkService --lang=en-US --service-sandbox-type=network --no-sandbox --use-angle=swiftshader-webgl --crashpad-handler-pid=6595 --enable-crash-reporter=, --noerrdialogs --user-data-dir=/tmp/org.chromium.Chromium.scoped_dir.mymYFu --change-stack-guard-on-fork=enable --shared-files=network_parent_dirs_pipe:100,v8_context_snapshot_data:101 --field-trial-handle=3,i,8945436319623663532,8350020255563320033,262144 --disable-features=PaintHolding --variations-seed-version --pseudonymization-salt-handle=7,i,10826472646558520610,14225711270022339713,4 --trace-process-track-uuid=3190708989122997041 -I y-3.2.0 (dns block)
    • Triggering command: /usr/bin/chromium-browser chromium-browser --headless --disable-gpu --no-sandbox --screenshot=/tmp/list-podcast-doc.png --window-size=1440,2000 file:///home/REDACTED/work/antennapod.github.io/antennapod.github.io/_site/documentation/podcasters-hosters/list-podcast.html --gdwarf-5 --64 -o static_literals.o /tmp/cccgTV9c.s s u/13/liblto_plug-I _64-linux-gnu/13/usr/include/ruby-3.2.0/ruby/backward or/bundle/ruby/3-I -I or/bundle/ruby/3-I -I y-3.2.0 (dns block)
  • hosted.weblate.org
    • Triggering command: /usr/bin/ruby3.2 ruby3.2 /home/REDACTED/work/antennapod.github.io/antennapod.github.io/vendor/bundle/ruby/3.2.0/bin/jekyll build as -I in.so /lto-wrapper kward or/bundle/ruby/3as hub.io/antennapo-I or/bundle/ruby/3. as -I by-3.2.0 -I .2.0/gems/prism-1.9.0/include -I .2.0/gems/prism-1.9.0/ext -I u/13/cc1 (dns block)
  • https://api.github.com/repos/AntennaPod/AntennaPod/releases
    • Triggering command: /usr/bin/ruby3.2 ruby3.2 /home/REDACTED/work/antennapod.github.io/antennapod.github.io/vendor/bundle/ruby/3.2.0/bin/jekyll build as -I in.so /lto-wrapper kward or/bundle/ruby/3as hub.io/antennapo-I or/bundle/ruby/3. as -I by-3.2.0 -I .2.0/gems/prism-1.9.0/include -I .2.0/gems/prism-1.9.0/ext -I u/13/cc1 (http block)
  • redirector.gvt1.com
    • Triggering command: /proc/self/exe /proc/self/exe --type=utility --utility-sub-type=network.mojom.NetworkService --lang=en-US --service-sandbox-type=network --no-sandbox --use-angle=swiftshader-webgl --crashpad-handler-pid=6595 --enable-crash-reporter=, --noerrdialogs --user-data-dir=/tmp/org.chromium.Chromium.scoped_dir.mymYFu --change-stack-guard-on-fork=enable --shared-files=network_parent_dirs_pipe:100,v8_context_snapshot_data:101 --field-trial-handle=3,i,8945436319623663532,8350020255563320033,262144 --disable-features=PaintHolding --variations-seed-version --pseudonymization-salt-handle=7,i,10826472646558520610,14225711270022339713,4 --trace-process-track-uuid=3190708989122997041 -I y-3.2.0 (dns block)
    • Triggering command: /usr/bin/chromium-browser chromium-browser --headless --disable-gpu --no-sandbox --screenshot=/tmp/list-podcast-doc.png --window-size=1440,2000 file:///home/REDACTED/work/antennapod.github.io/antennapod.github.io/_site/documentation/podcasters-hosters/list-podcast.html --gdwarf-5 --64 -o static_literals.o /tmp/cccgTV9c.s s u/13/liblto_plug-I _64-linux-gnu/13/usr/include/ruby-3.2.0/ruby/backward or/bundle/ruby/3-I -I or/bundle/ruby/3-I -I y-3.2.0 (dns block)
  • www.google.com
    • Triggering command: /proc/self/exe /proc/self/exe --type=utility --utility-sub-type=network.mojom.NetworkService --lang=en-US --service-sandbox-type=network --no-sandbox --use-angle=swiftshader-webgl --crashpad-handler-pid=6595 --enable-crash-reporter=, --noerrdialogs --user-data-dir=/tmp/org.chromium.Chromium.scoped_dir.mymYFu --change-stack-guard-on-fork=enable --shared-files=network_parent_dirs_pipe:100,v8_context_snapshot_data:101 --field-trial-handle=3,i,8945436319623663532,8350020255563320033,262144 --disable-features=PaintHolding --variations-seed-version --pseudonymization-salt-handle=7,i,10826472646558520610,14225711270022339713,4 --trace-process-track-uuid=3190708989122997041 -I y-3.2.0 (dns block)
    • Triggering command: /usr/bin/chromium-browser chromium-browser --headless --disable-gpu --no-sandbox --screenshot=/tmp/list-podcast-doc.png --window-size=1440,2000 file:///home/REDACTED/work/antennapod.github.io/antennapod.github.io/_site/documentation/podcasters-hosters/list-podcast.html --gdwarf-5 --64 -o static_literals.o /tmp/cccgTV9c.s s u/13/liblto_plug-I _64-linux-gnu/13/usr/include/ruby-3.2.0/ruby/backward or/bundle/ruby/3-I -I or/bundle/ruby/3-I -I y-3.2.0 (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Copilot AI changed the title [WIP] Update documentation for podcasters to add feed Update podcaster docs to use Podcast Index self-service add flow May 12, 2026
Copilot AI requested a review from ByteHamster May 12, 2026 19:43

AntennaPod mainly uses two directories for its search feature:
* [Podcast Index](https://podcastindex.org/) (ask your hoster how to add your podcast, or add your own podcast via the [API](https://podcastindex-org.github.io/docs-api/#get-/add/byfeedurl))
* [Podcast Index](https://podcastindex.org/) (ask your hoster how to add your podcast, or add your own podcast and description via [their add page](https://podcastindex.org/add))
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@copilot description? There is none on that page, remove that

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Updated in commit e9de296 — I removed the incorrect “and description” wording and now only mention adding the podcast via the Podcast Index add page.

Screenshot of the updated page: /tmp/list-podcast-doc-updated.png

Copy link
Copy Markdown
Contributor Author

Copilot AI commented May 12, 2026

Just as a heads up, I was blocked by some firewall rules while working on your feedback. Expand below for details.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • accounts.google.com
    • Triggering command: /proc/self/exe /proc/self/exe --type=utility --utility-sub-type=network.mojom.NetworkService --lang=en-US --service-sandbox-type=network --no-sandbox --use-angle=swiftshader-webgl --crashpad-handler-pid=5803 --enable-crash-reporter=, --noerrdialogs --user-data-dir=/tmp/org.chromium.Chromium.scoped_dir.QlkY6O --change-stack-guard-on-fork=enable --shared-files=network_parent_dirs_pipe:100,v8_context_snapshot_data:101 --field-trial-handle=3,i,2320374286216137116,3533755771251471441,262144 --disable-features=PaintHolding --variations-seed-version --pseudonymization-salt-handle=7,i,11521283251348250333,9029002019022390226,4 --trace-process-track-uuid=3190708989122997041 /usr/include/rub. as (dns block)
    • Triggering command: /usr/bin/chromium-browser chromium-browser --headless --disable-gpu --no-sandbox --screenshot=/tmp/list-podcast-doc-updated.png --window-size=1440,2000 file:///home/REDACTED/work/antennapod.github.io/antennapod.github.io/_site/documentation/podcasters-hosters/list-podcast.html /tmp/ccOxx6ib.s (dns block)
  • clients2.google.com
    • Triggering command: /proc/self/exe /proc/self/exe --type=utility --utility-sub-type=network.mojom.NetworkService --lang=en-US --service-sandbox-type=network --no-sandbox --use-angle=swiftshader-webgl --crashpad-handler-pid=5803 --enable-crash-reporter=, --noerrdialogs --user-data-dir=/tmp/org.chromium.Chromium.scoped_dir.QlkY6O --change-stack-guard-on-fork=enable --shared-files=network_parent_dirs_pipe:100,v8_context_snapshot_data:101 --field-trial-handle=3,i,2320374286216137116,3533755771251471441,262144 --disable-features=PaintHolding --variations-seed-version --pseudonymization-salt-handle=7,i,11521283251348250333,9029002019022390226,4 --trace-process-track-uuid=3190708989122997041 /usr/include/rub. as (dns block)
    • Triggering command: /usr/bin/chromium-browser chromium-browser --headless --disable-gpu --no-sandbox --screenshot=/tmp/list-podcast-doc-updated.png --window-size=1440,2000 file:///home/REDACTED/work/antennapod.github.io/antennapod.github.io/_site/documentation/podcasters-hosters/list-podcast.html /tmp/ccOxx6ib.s (dns block)
  • hosted.weblate.org
    • Triggering command: /usr/bin/ruby3.2 ruby3.2 /home/REDACTED/work/antennapod.github.io/antennapod.github.io/vendor/bundle/ruby/3.2.0/bin/jekyll build -I /home/REDACTED/work/antennapod.github.io/antennapod.github.io/vendor/bundle/ruby/3-D -I /home/REDACTED/work/antennapod.github.io/antennapod.github.io/vendor/bundle/ruby/3-D --gdwarf-5 --64 -o static_literals.o /tmp/ccfe1h0L.s -I _64-linux-gnu/ru-I by-3.2.0 or/bundle/ruby/3-I kward or/bundle/ruby/3-I 1.9.0/ext as (dns block)
  • https://api.github.com/repos/AntennaPod/AntennaPod/releases
    • Triggering command: /usr/bin/ruby3.2 ruby3.2 /home/REDACTED/work/antennapod.github.io/antennapod.github.io/vendor/bundle/ruby/3.2.0/bin/jekyll build -I /home/REDACTED/work/antennapod.github.io/antennapod.github.io/vendor/bundle/ruby/3-D -I /home/REDACTED/work/antennapod.github.io/antennapod.github.io/vendor/bundle/ruby/3-D --gdwarf-5 --64 -o static_literals.o /tmp/ccfe1h0L.s -I _64-linux-gnu/ru-I by-3.2.0 or/bundle/ruby/3-I kward or/bundle/ruby/3-I 1.9.0/ext as (http block)
  • redirector.gvt1.com
    • Triggering command: /proc/self/exe /proc/self/exe --type=utility --utility-sub-type=network.mojom.NetworkService --lang=en-US --service-sandbox-type=network --no-sandbox --use-angle=swiftshader-webgl --crashpad-handler-pid=5803 --enable-crash-reporter=, --noerrdialogs --user-data-dir=/tmp/org.chromium.Chromium.scoped_dir.QlkY6O --change-stack-guard-on-fork=enable --shared-files=network_parent_dirs_pipe:100,v8_context_snapshot_data:101 --field-trial-handle=3,i,2320374286216137116,3533755771251471441,262144 --disable-features=PaintHolding --variations-seed-version --pseudonymization-salt-handle=7,i,11521283251348250333,9029002019022390226,4 --trace-process-track-uuid=3190708989122997041 /usr/include/rub. as (dns block)
    • Triggering command: /usr/bin/chromium-browser chromium-browser --headless --disable-gpu --no-sandbox --screenshot=/tmp/list-podcast-doc-updated.png --window-size=1440,2000 file:///home/REDACTED/work/antennapod.github.io/antennapod.github.io/_site/documentation/podcasters-hosters/list-podcast.html /tmp/ccOxx6ib.s (dns block)
  • www.google.com
    • Triggering command: /proc/self/exe /proc/self/exe --type=utility --utility-sub-type=network.mojom.NetworkService --lang=en-US --service-sandbox-type=network --no-sandbox --use-angle=swiftshader-webgl --crashpad-handler-pid=5803 --enable-crash-reporter=, --noerrdialogs --user-data-dir=/tmp/org.chromium.Chromium.scoped_dir.QlkY6O --change-stack-guard-on-fork=enable --shared-files=network_parent_dirs_pipe:100,v8_context_snapshot_data:101 --field-trial-handle=3,i,2320374286216137116,3533755771251471441,262144 --disable-features=PaintHolding --variations-seed-version --pseudonymization-salt-handle=7,i,11521283251348250333,9029002019022390226,4 --trace-process-track-uuid=3190708989122997041 /usr/include/rub. as (dns block)
    • Triggering command: /usr/bin/chromium-browser chromium-browser --headless --disable-gpu --no-sandbox --screenshot=/tmp/list-podcast-doc-updated.png --window-size=1440,2000 file:///home/REDACTED/work/antennapod.github.io/antennapod.github.io/_site/documentation/podcasters-hosters/list-podcast.html /tmp/ccOxx6ib.s (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Copilot AI requested a review from ByteHamster May 12, 2026 19:51
@ByteHamster ByteHamster marked this pull request as ready for review May 12, 2026 19:54
@ByteHamster ByteHamster merged commit f4e418f into master May 12, 2026
5 checks passed
@ByteHamster ByteHamster deleted the copilot/update-documentation-for-podcasters branch May 12, 2026 19:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update documentation for podcasters to add feed

2 participants