Add Pocket Casts Provider

[yfhyou]

Summary

Adds a new music provider for Pocketcasts podcast service, allowing users to:

• Access their Pocketcasts podcast library
• Browse subscribed podcasts and 5 special folders (Up Next, New Releases, In Progress, Starred, History)
• Search for new podcasts
• Subscribe/unsubscribe to podcasts (syncs back to Pocketcasts)
• Sync playback progress bidirectionally with Pocketcasts
• Resume playback from saved positions

Features

Feature	Status
LIBRARY_PODCASTS	✅
LIBRARY_PODCASTS_EDIT	✅
BROWSE	✅
SEARCH	✅

Implementation

• 4 files, ~1900 lines total
• manifest.json - Provider configuration
• api_client.py - Custom API client for Pocketcasts (reverse-engineered API)
• __init__.py - Main provider implementation
• STATUS.md - Development documentation

Playback Sync

• Progress syncs every 30 seconds during playback
• Episode completion triggers: mark played → remove from Up Next → archive
• Starting playback adds episode to Pocketcasts Up Next queue
• Handles duration discrepancy between static API and actual episode length

Test plan

• Login with valid/invalid credentials
• Browse podcast library and episodes
• Play episodes with resume position
• Subscribe/unsubscribe to podcasts
• Progress sync to Pocketcasts
• Episode completion sequence
• Search functionality
• Large libraries (100+ podcasts)

Notes

• Uses unofficial/undocumented Pocketcasts API (reverse-engineered)
• Authentication uses JWT bearer tokens (~5 month validity)
• No additional Python dependencies required

🤖 Generated with Claude Code

[github-actions]

🔒 Dependency Security Report

✅ No dependency changes detected in this PR.

[yfhyou]

Hello! I have updated this provider starting with the great work that @OzGav did. I was going to use a seperate API library, but decided to use the local api_client.py that was already created.
There are still a few possible missing features, and somethings that don't match between pocketcasts and MA.
You can track a lot of the progress in the STATUS.md. A few things to consider:

• there is no 'favorites' podcast option in pocket casts, only subscribe/unsubscribe so the favorites is local to MA only
• there is no way to 'favorite' an episode in MA, so there is only the 'starred' items playlist in browse
• There sometimes seems to be a discrepency between what the pocket casts API duration and actual duration are. I tried to setup the syncing best as possible for different scenarios, but better testing probably still needs to happen.
• The episode list doesn't always seem to reflect the actual from the API - probably needs a little more investigation.
• Listen statistics are not synced at the moment so playing does not add to the user statistics. (/user/stats/add endpoint)
• As far as I can tell MA cannot change the playback speed.

Overall this should be a usable provider with basic sync functions.
Big shoutout to Claude Code - it is an amazing tool.

[OzGav]

This will be reviewed fully in due course however a couple of things. I wont be the code owner. You can remove the status.md file. You need to add icon.svg and icon_monochrome.svg

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 5 changed files in this pull request and generated 7 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 5 changed files in this pull request and generated 5 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The 45-second threshold for marking episodes as played (line 924) and the 30-second callback interval (line 922) are magic numbers that would be clearer as named constants at the module or class level. Consider defining COMPLETION_THRESHOLD_SECONDS = 45 and CALLBACK_INTERVAL_SECONDS = 30 to make the relationship between these values explicit and easier to maintain if the callback interval changes.

[Copilot]

The 0.9 threshold for determining "fully played" status appears in four different places (lines 475, 659, 782, 836). This duplicated magic number should be extracted as a module-level or class-level constant like FULLY_PLAYED_THRESHOLD = 0.9 to ensure consistency and make it easier to adjust if needed.

[Copilot]

The special folder names ("up_next", "new_releases", "in_progress", "starred", "history") are duplicated as string literals across multiple locations: line 558-563 (_create_browse_folders), line 506-515 (_get_special_folder_episodes), and line 614 (browse method check). Consider extracting these as class-level or module-level constants to avoid typos and make maintenance easier. For example, define a constant like SPECIAL_FOLDERS = ("up_next", "new_releases", "in_progress", "starred", "history") and use it consistently.

[Copilot]

Unlike other API methods in this client, get_podcast_episodes does not check for 401/403 authentication errors before the general non-200 check. This endpoint uses the unauthenticated podcast-api.pocketcasts.com domain (line 91), so auth errors are unlikely. However, for consistency with the pattern established by all other methods (see lines 75-76, 113-114, 134-135, etc.), consider adding an explicit 401/403 check that raises LoginError, even if authentication isn't strictly required for this endpoint.

Suggested change

	if response.status != 200:
	raise PocketCastsAPIError(
	f"Failed to get episodes for {podcast_uuid}: {response.status}"
	if response.status in (401, 403):
	raise LoginError(f"Authentication failed with status {response.status}")
	if response.status != 200:
	text = await response.text()
	raise PocketCastsAPIError(
	f"Failed to get episodes for {podcast_uuid}: {response.status} - {text}"

[Copilot]

The logic for enriching episodes with playback status (lines 640-663) is duplicated from get_podcast_episodes (lines 456-488). This includes creating the same lookup maps and applying the same status logic. Consider extracting this into a helper method like _enrich_episodes_with_status that takes episodes and applies the in-progress/history lookups, returning the enriched list. This would improve maintainability by ensuring both code paths use identical logic.