applepodbar 0.1.0__tar.gz

applepodbar-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Christopher Patti
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

applepodbar-0.1.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: applepodbar
+Version: 0.1.0
+Summary: A command-line TUI podcast player for Apple Podcasts
+Author: Christopher Patti
+Author-email: Christopher Patti <feoh@feoh.org>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: cyclopts>=4.0
+Requires-Dist: feedparser>=6.0.11
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: platformdirs>=4.10.0
+Requires-Dist: textual>=8.2.7
+Requires-Dist: textual-image>=0.8
+Requires-Dist: keyring>=25.0 ; extra == 'login'
+Requires-Dist: playwright>=1.49.0 ; extra == 'login'
+Requires-Python: >=3.12
+Provides-Extra: login
+Description-Content-Type: text/markdown
+
+# applepodbar
+
+A keyboard-driven terminal podcast player for [Apple
+Podcasts](https://podcasts.apple.com), built with Python and
+[Textual](https://textual.textualize.io/).
+
+> [!IMPORTANT]
+> applepodbar is an independent, early-stage project and is not affiliated with
+> or endorsed by Apple. It uses the undocumented AMP API that backs the
+> podcasts.apple.com web player, so Apple can change or withdraw it without
+> notice. No DRM bypass is implemented — applepodbar plays only the plain audio
+> URLs the web player itself receives.
+
+## Status
+
+Early. Home charts, genre/editorial browse, search, show detail, and free-episode
+playback are wired to the AMP catalog. Playwright login is available as an
+optional extra. If Apple's web token cannot be found, search and playback fall
+back to iTunes Search and publisher RSS. Signed-in Library, Up Next, and
+cross-device playback-position sync, and follow/save actions are now wired.
+Paid FairPlay content remains out of scope; see [`docs/SPEC.md`](docs/SPEC.md).
+
+![applepodbar home screen showing top podcasts](https://raw.githubusercontent.com/feoh/applepodbar/main/docs/screenshot.svg)
+
+![applepodbar playing an ANTIC episode, with the show's episode list, cover art, and queue](https://raw.githubusercontent.com/feoh/applepodbar/main/docs/screenshot-playing.png)
+
+## Features
+
+- Browse and search the Apple Podcasts catalog; play free episodes through `mpv`
+- Signed-in Library, Up Next, follows/saves, and cross-device position sync
+- Zero-auth iTunes Search + RSS fallback with local follows and resume positions
+- Paid FairPlay episodes are listed but not playable
+
+## Requirements
+
+- Python 3.12+
+- [`uv`](https://docs.astral.sh/uv/)
+- [`mpv`](https://mpv.io/) on `PATH` (needed for playback; browsing works
+  without it)
+- An Apple account, only for the signed-in features
+
+## Install
+
+```bash
+uv tool install applepodbar
+applepodbar
+
+# With sign-in support (Library, Up Next, position sync):
+uv tool install 'applepodbar[login]' --with-executables-from playwright
+playwright install chromium
+applepodbar login
+```
+
+## Installation for development
+
+```bash
+git clone git@github.com:feoh/applepodbar.git
+cd applepodbar
+uv sync
+uv run applepodbar
+```
+
+## Signing in
+
+Catalog browsing, search, and playback of free episodes need no sign-in at all.
+
+Library, Up Next, and position sync need a per-user token. applepodbar captures
+it once by opening a real browser window for you to sign in to Apple yourself —
+**it never sees or stores your Apple ID password.** This needs the optional
+`login` extra:
+
+```bash
+uv sync --extra login
+uv run playwright install chromium
+uv run applepodbar login
+```
+
+## Configuration
+
+Configuration lives in the platform-standard user config directory:
+
+```
+<config_dir>/applepodbar/
+  config.toml          storefront and playback preferences
+  tokens.json          cached developer JWT, written user-only (mode 600)
+  local_library.json   local follows and RSS resume positions (mode 600)
+OS keyring             media-user-token and browser session cookies
+```
+
+Set `[general] catalog_backend = "rss"` in `config.toml` to avoid the private
+API altogether. In RSS mode, press `a` on a show to follow it locally; `l`
+lists locally followed shows. Resume positions stay on this device.
+
+Linux keyring support requires an unlocked Secret Service backend. No account
+password is handled by applepodbar.
+
+## Development
+
+```bash
+uv run pytest -q
+uv run ruff check src tests
+uv run ruff format --check src tests
+uv run mypy src/applepodbar tests
+uv run pyright
+uvx prek run --all-files
+uv build
+```
+
+## Releasing
+
+Publishing a GitHub release runs `.github/workflows/publish.yml`, which re-runs
+the checks, builds, and uploads to PyPI through trusted publishing (no API
+token). The release tag must be `v` plus the `pyproject.toml` version:
+
+```bash
+uv version --bump patch        # or minor / major
+git commit -am "Release v$(uv version --short)"
+git push
+gh release create "v$(uv version --short)" --generate-notes
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

applepodbar-0.1.0/README.md

@@ -0,0 +1,124 @@
+# applepodbar
+
+A keyboard-driven terminal podcast player for [Apple
+Podcasts](https://podcasts.apple.com), built with Python and
+[Textual](https://textual.textualize.io/).
+
+> [!IMPORTANT]
+> applepodbar is an independent, early-stage project and is not affiliated with
+> or endorsed by Apple. It uses the undocumented AMP API that backs the
+> podcasts.apple.com web player, so Apple can change or withdraw it without
+> notice. No DRM bypass is implemented — applepodbar plays only the plain audio
+> URLs the web player itself receives.
+
+## Status
+
+Early. Home charts, genre/editorial browse, search, show detail, and free-episode
+playback are wired to the AMP catalog. Playwright login is available as an
+optional extra. If Apple's web token cannot be found, search and playback fall
+back to iTunes Search and publisher RSS. Signed-in Library, Up Next, and
+cross-device playback-position sync, and follow/save actions are now wired.
+Paid FairPlay content remains out of scope; see [`docs/SPEC.md`](docs/SPEC.md).
+
+![applepodbar home screen showing top podcasts](https://raw.githubusercontent.com/feoh/applepodbar/main/docs/screenshot.svg)
+
+![applepodbar playing an ANTIC episode, with the show's episode list, cover art, and queue](https://raw.githubusercontent.com/feoh/applepodbar/main/docs/screenshot-playing.png)
+
+## Features
+
+- Browse and search the Apple Podcasts catalog; play free episodes through `mpv`
+- Signed-in Library, Up Next, follows/saves, and cross-device position sync
+- Zero-auth iTunes Search + RSS fallback with local follows and resume positions
+- Paid FairPlay episodes are listed but not playable
+
+## Requirements
+
+- Python 3.12+
+- [`uv`](https://docs.astral.sh/uv/)
+- [`mpv`](https://mpv.io/) on `PATH` (needed for playback; browsing works
+  without it)
+- An Apple account, only for the signed-in features
+
+## Install
+
+```bash
+uv tool install applepodbar
+applepodbar
+
+# With sign-in support (Library, Up Next, position sync):
+uv tool install 'applepodbar[login]' --with-executables-from playwright
+playwright install chromium
+applepodbar login
+```
+
+## Installation for development
+
+```bash
+git clone git@github.com:feoh/applepodbar.git
+cd applepodbar
+uv sync
+uv run applepodbar
+```
+
+## Signing in
+
+Catalog browsing, search, and playback of free episodes need no sign-in at all.
+
+Library, Up Next, and position sync need a per-user token. applepodbar captures
+it once by opening a real browser window for you to sign in to Apple yourself —
+**it never sees or stores your Apple ID password.** This needs the optional
+`login` extra:
+
+```bash
+uv sync --extra login
+uv run playwright install chromium
+uv run applepodbar login
+```
+
+## Configuration
+
+Configuration lives in the platform-standard user config directory:
+
+```
+<config_dir>/applepodbar/
+  config.toml          storefront and playback preferences
+  tokens.json          cached developer JWT, written user-only (mode 600)
+  local_library.json   local follows and RSS resume positions (mode 600)
+OS keyring             media-user-token and browser session cookies
+```
+
+Set `[general] catalog_backend = "rss"` in `config.toml` to avoid the private
+API altogether. In RSS mode, press `a` on a show to follow it locally; `l`
+lists locally followed shows. Resume positions stay on this device.
+
+Linux keyring support requires an unlocked Secret Service backend. No account
+password is handled by applepodbar.
+
+## Development
+
+```bash
+uv run pytest -q
+uv run ruff check src tests
+uv run ruff format --check src tests
+uv run mypy src/applepodbar tests
+uv run pyright
+uvx prek run --all-files
+uv build
+```
+
+## Releasing
+
+Publishing a GitHub release runs `.github/workflows/publish.yml`, which re-runs
+the checks, builds, and uploads to PyPI through trusted publishing (no API
+token). The release tag must be `v` plus the `pyproject.toml` version:
+
+```bash
+uv version --bump patch        # or minor / major
+git commit -am "Release v$(uv version --short)"
+git push
+gh release create "v$(uv version --short)" --generate-notes
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

applepodbar-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[project]
+name = "applepodbar"
+version = "0.1.0"
+description = "A command-line TUI podcast player for Apple Podcasts"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.12"
+dependencies = [
+    "cyclopts>=4.0",
+    "feedparser>=6.0.11",
+    "httpx>=0.28.1",
+    "platformdirs>=4.10.0",
+    "textual>=8.2.7",
+    "textual-image>=0.8",
+]
+
+[[project.authors]]
+name = "Christopher Patti"
+email = "feoh@feoh.org"
+
+[project.optional-dependencies]
+login = [
+    "keyring>=25.0",
+    "playwright>=1.49.0",
+]
+
+[project.scripts]
+applepodbar = "applepodbar.app:main"
+
+[build-system]
+requires = ["uv_build>=0.9.18,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+source-exclude = [".ruff_cache"]
+
+[dependency-groups]
+dev = [
+    "mypy>=2.1.0",
+    "pyright>=1.1.400",
+    "pytest>=9.0.3",
+    "ruff>=0.15.16",
+]

applepodbar-0.1.0/pyproject.toml.orig

@@ -0,0 +1,41 @@
+[project]
+name = "applepodbar"
+version = "0.1.0"
+description = "A command-line TUI podcast player for Apple Podcasts"
+readme = "README.md"
+authors = [{ name = "Christopher Patti", email = "feoh@feoh.org" }]
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.12"
+dependencies = [
+  "cyclopts>=4.0",
+  "feedparser>=6.0.11",
+  "httpx>=0.28.1",
+  "platformdirs>=4.10.0",
+  "textual>=8.2.7",
+  "textual-image>=0.8",
+]
+
+[project.optional-dependencies]
+login = [
+    "keyring>=25.0",
+    "playwright>=1.49.0",
+]
+
+[project.scripts]
+applepodbar = "applepodbar.app:main"
+
+[build-system]
+requires = ["uv_build>=0.9.18,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+source-exclude = [".ruff_cache"]
+
+[dependency-groups]
+dev = [
+    "mypy>=2.1.0",
+    "pyright>=1.1.400",
+    "pytest>=9.0.3",
+    "ruff>=0.15.16",
+]

applepodbar-0.1.0/src/applepodbar/__init__.py

@@ -0,0 +1 @@
+"""applepodbar package."""

applepodbar-0.1.0/src/applepodbar/__main__.py

@@ -0,0 +1,6 @@
+"""Run applepodbar as a module."""
+
+from .app import main
+
+if __name__ == "__main__":
+    main()