getscript 0.12.0__tar.gz → 0.14.1__tar.gz

getscript-0.14.1/PKG-INFO

@@ -0,0 +1,194 @@
+Metadata-Version: 2.4
+Name: getscript
+Version: 0.14.1
+Summary: Fast, Unix-friendly CLI for fetching transcripts from Apple Podcasts
+Author: Voxly
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/outerbanks73/cli-tools
+Project-URL: Documentation, https://voxlytranscribes.com/docs/getscript
+Project-URL: Repository, https://github.com/outerbanks73/cli-tools
+Project-URL: Issues, https://github.com/outerbanks73/cli-tools/issues
+Keywords: transcript,podcast,apple-podcasts,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Sound/Audio
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: defusedxml>=0.7.1
+Dynamic: license-file
+
+# getscript
+
+A fast, Unix-friendly CLI for fetching transcripts from Apple Podcasts.  You don't need to transcribe much of anything nowadays
+because Apple is transcribing everything for us.  'getscript' lets you use the transcripts in a more human / text friendly manner.
+The idea behind getscript is to put the transcripts to use in a meaningful way.
+
+For example - let's say you're curious about AI Slop as a podcast topic:
+
+$ getscript --search "AI Slop" --list
+   <removing list of 10 podcasts and their podcast id's>
+$ getscript 1000730374732 | claude -p "Summarize the top 5 Points"
+
+Of course you can also export to TTML, JSON, markdown and run from cron if you want to schedule things.
+
+[![PyPI](https://img.shields.io/pypi/v/getscript)](https://pypi.org/project/getscript/)
+[![CI](https://github.com/outerbanks73/cli-tools/actions/workflows/test.yml/badge.svg)](https://github.com/outerbanks73/cli-tools/actions/workflows/test.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org)
+
+## Install
+
+```bash
+pip install getscript
+```
+
+Or via Homebrew:
+
+```bash
+brew install outerbanks73/tap/getscript
+```
+
+Requires Python 3.10+. Apple Podcasts transcripts require macOS 15.5+ with Xcode CLI tools.
+
+## Quick Start
+
+```bash
+# Fetch from an episode URL
+getscript "https://podcasts.apple.com/us/podcast/the-daily/id1200361736?i=1000753754819"
+
+# Fetch from a bare episode ID
+getscript 1000753754819
+
+# Raw TTML XML output
+getscript 1000753754819 --ttml
+
+# Search Apple Podcasts interactively (requires fzf)
+getscript --search "artificial intelligence"
+```
+
+### Output Formats
+
+Output formats are mutually exclusive (`--json`, `--ttml`, `--markdown`). The `--timestamps` flag can be combined with any format.
+
+```bash
+# JSON piped to jq
+getscript EPISODE_ID --json | jq '.segments[].text'
+
+# Markdown with timestamps
+getscript EPISODE_ID --markdown --timestamps > notes.md
+
+# Write to file
+getscript EPISODE_ID -o transcript.txt
+```
+
+### Search
+
+```bash
+# Search Apple Podcasts (requires fzf)
+getscript --search "climate change"
+
+# List results without fzf
+getscript --search "topic" --list --limit 20
+```
+
+### Stdin & Batch Processing
+
+```bash
+# Read episode ID from stdin
+echo "1000753754819" | getscript -
+
+# Batch process a list of IDs
+cat ids.txt | xargs -n1 getscript --no-upload --quiet
+
+# Disable upload via environment variable
+GETSCRIPT_UPLOAD=0 getscript EPISODE_ID
+
+# Silent file output for scripting
+getscript EPISODE_ID --quiet --no-upload -o out.txt
+```
+
+### Shared Transcript Library
+
+Fetched transcripts are automatically submitted to [voxlytranscribes.com](https://voxlytranscribes.com) for indexing and enrichment. To disable:
+
+```bash
+getscript EPISODE_ID --no-upload
+GETSCRIPT_UPLOAD=0 getscript EPISODE_ID
+```
+
+### Shell Completions
+
+```bash
+getscript --completions bash >> ~/.bashrc
+getscript --completions zsh >> ~/.zshrc
+getscript --completions fish > ~/.config/fish/completions/getscript.fish
+```
+
+## Configuration
+
+Config file: `~/.config/getscript/config.json`
+
+| Key | Type | Default | Description |
+|-----|------|---------|-------------|
+| `output_format` | string | `text` | Default format: `text`, `json`, `markdown`, `ttml` |
+| `timestamps` | bool | `false` | Include timestamps in text output |
+| `search_limit` | int | `10` | Number of search results |
+| `no_upload` | bool | `false` | Disable shared library submissions |
+| `quiet` | bool | `false` | Suppress progress and upload status messages |
+
+Environment variables:
+
+| Variable | Description |
+|----------|-------------|
+| `GETSCRIPT_UPLOAD` | Set to `0` to disable submissions |
+| `NO_COLOR` | Disable colored output |
+
+Precedence: config file < environment variables < CLI flags.
+
+See [examples/config.example.md](examples/config.example.md) for a full annotated reference.
+
+## How It Works
+
+Compiles a small Obj-C helper that calls Apple's private AMSMescal framework (FairPlay DRM) to generate a bearer token. That token authenticates requests to the AMP API, which returns TTML transcripts. The token is cached at `~/.cache/getscript/apple_token` for 30 days. This is the only open-source tool that can fetch Apple Podcasts transcripts programmatically.
+
+## Shared Transcript Library
+
+Every fetch contributes to the shared library at [voxlytranscribes.com](https://voxlytranscribes.com). Submissions go through a quarantine pipeline: server-side re-fetch, content hash verification, and provenance tracking before promotion to the canonical library. See the [technical docs](https://voxlytranscribes.com/docs/getscript) for details.
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `1` | Runtime error (network, auth, missing transcript) |
+| `2` | Usage error (bad arguments, unrecognized URL) |
+| `130` | Interrupted (Ctrl-C) |
+
+## Testing
+
+87 tests across 9 modules. CI matrix: Python 3.10–3.13 on Ubuntu and macOS.
+
+```bash
+pytest -v
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).
+
+## License
+
+MIT

getscript-0.14.1/README.md

@@ -0,0 +1,166 @@
+# getscript
+
+A fast, Unix-friendly CLI for fetching transcripts from Apple Podcasts.  You don't need to transcribe much of anything nowadays
+because Apple is transcribing everything for us.  'getscript' lets you use the transcripts in a more human / text friendly manner.
+The idea behind getscript is to put the transcripts to use in a meaningful way.
+
+For example - let's say you're curious about AI Slop as a podcast topic:
+
+$ getscript --search "AI Slop" --list
+   <removing list of 10 podcasts and their podcast id's>
+$ getscript 1000730374732 | claude -p "Summarize the top 5 Points"
+
+Of course you can also export to TTML, JSON, markdown and run from cron if you want to schedule things.
+
+[![PyPI](https://img.shields.io/pypi/v/getscript)](https://pypi.org/project/getscript/)
+[![CI](https://github.com/outerbanks73/cli-tools/actions/workflows/test.yml/badge.svg)](https://github.com/outerbanks73/cli-tools/actions/workflows/test.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org)
+
+## Install
+
+```bash
+pip install getscript
+```
+
+Or via Homebrew:
+
+```bash
+brew install outerbanks73/tap/getscript
+```
+
+Requires Python 3.10+. Apple Podcasts transcripts require macOS 15.5+ with Xcode CLI tools.
+
+## Quick Start
+
+```bash
+# Fetch from an episode URL
+getscript "https://podcasts.apple.com/us/podcast/the-daily/id1200361736?i=1000753754819"
+
+# Fetch from a bare episode ID
+getscript 1000753754819
+
+# Raw TTML XML output
+getscript 1000753754819 --ttml
+
+# Search Apple Podcasts interactively (requires fzf)
+getscript --search "artificial intelligence"
+```
+
+### Output Formats
+
+Output formats are mutually exclusive (`--json`, `--ttml`, `--markdown`). The `--timestamps` flag can be combined with any format.
+
+```bash
+# JSON piped to jq
+getscript EPISODE_ID --json | jq '.segments[].text'
+
+# Markdown with timestamps
+getscript EPISODE_ID --markdown --timestamps > notes.md
+
+# Write to file
+getscript EPISODE_ID -o transcript.txt
+```
+
+### Search
+
+```bash
+# Search Apple Podcasts (requires fzf)
+getscript --search "climate change"
+
+# List results without fzf
+getscript --search "topic" --list --limit 20
+```
+
+### Stdin & Batch Processing
+
+```bash
+# Read episode ID from stdin
+echo "1000753754819" | getscript -
+
+# Batch process a list of IDs
+cat ids.txt | xargs -n1 getscript --no-upload --quiet
+
+# Disable upload via environment variable
+GETSCRIPT_UPLOAD=0 getscript EPISODE_ID
+
+# Silent file output for scripting
+getscript EPISODE_ID --quiet --no-upload -o out.txt
+```
+
+### Shared Transcript Library
+
+Fetched transcripts are automatically submitted to [voxlytranscribes.com](https://voxlytranscribes.com) for indexing and enrichment. To disable:
+
+```bash
+getscript EPISODE_ID --no-upload
+GETSCRIPT_UPLOAD=0 getscript EPISODE_ID
+```
+
+### Shell Completions
+
+```bash
+getscript --completions bash >> ~/.bashrc
+getscript --completions zsh >> ~/.zshrc
+getscript --completions fish > ~/.config/fish/completions/getscript.fish
+```
+
+## Configuration
+
+Config file: `~/.config/getscript/config.json`
+
+| Key | Type | Default | Description |
+|-----|------|---------|-------------|
+| `output_format` | string | `text` | Default format: `text`, `json`, `markdown`, `ttml` |
+| `timestamps` | bool | `false` | Include timestamps in text output |
+| `search_limit` | int | `10` | Number of search results |
+| `no_upload` | bool | `false` | Disable shared library submissions |
+| `quiet` | bool | `false` | Suppress progress and upload status messages |
+
+Environment variables:
+
+| Variable | Description |
+|----------|-------------|
+| `GETSCRIPT_UPLOAD` | Set to `0` to disable submissions |
+| `NO_COLOR` | Disable colored output |
+
+Precedence: config file < environment variables < CLI flags.
+
+See [examples/config.example.md](examples/config.example.md) for a full annotated reference.
+
+## How It Works
+
+Compiles a small Obj-C helper that calls Apple's private AMSMescal framework (FairPlay DRM) to generate a bearer token. That token authenticates requests to the AMP API, which returns TTML transcripts. The token is cached at `~/.cache/getscript/apple_token` for 30 days. This is the only open-source tool that can fetch Apple Podcasts transcripts programmatically.
+
+## Shared Transcript Library
+
+Every fetch contributes to the shared library at [voxlytranscribes.com](https://voxlytranscribes.com). Submissions go through a quarantine pipeline: server-side re-fetch, content hash verification, and provenance tracking before promotion to the canonical library. See the [technical docs](https://voxlytranscribes.com/docs/getscript) for details.
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `1` | Runtime error (network, auth, missing transcript) |
+| `2` | Usage error (bad arguments, unrecognized URL) |
+| `130` | Interrupted (Ctrl-C) |
+
+## Testing
+
+87 tests across 9 modules. CI matrix: Python 3.10–3.13 on Ubuntu and macOS.
+
+```bash
+pytest -v
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).
+
+## License
+
+MIT

{getscript-0.12.0 → getscript-0.14.1}/getscript/__init__.py

@@ -3,4 +3,4 @@ from importlib.metadata import version, PackageNotFoundError
 try:
     __version__ = version("getscript")
 except PackageNotFoundError:
-    __version__ = "0.12.0"  # fallback for editable installs without metadata
+    __version__ = "0.14.1"  # fallback for editable installs without metadata