getscript 0.12.0__py3-none-any.whl

getscript-0.12.0.dist-info/METADATA

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: getscript
+Version: 0.12.0
+Summary: Fast, Unix-friendly CLI for fetching transcripts from YouTube and 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,youtube,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: youtube-transcript-api>=1.0.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: defusedxml>=0.7.1
+Dynamic: license-file
+
+# getscript
+
+A fast, Unix-friendly CLI for fetching transcripts from YouTube and Apple Podcasts.
+
+## Install
+
+```bash
+pip install .
+```
+
+Requires Python 3.10+.
+
+**Apple Podcasts** transcripts additionally require macOS 15.5+ with Xcode CLI tools.
+
+## Usage
+
+```bash
+# Fetch from URL
+getscript "https://youtube.com/watch?v=VIDEO_ID"
+getscript "https://podcasts.apple.com/...?i=EPISODE_ID"
+
+# Fetch from bare ID
+getscript dQw4w9WgXcQ          # YouTube (11-char ID)
+getscript 1000753754819         # Apple (numeric ID)
+
+# Output formats
+getscript VIDEO_ID --json | jq .
+getscript VIDEO_ID --markdown > notes.md
+getscript VIDEO_ID --timestamps
+getscript EPISODE_ID --ttml      # raw TTML XML (Apple only)
+
+# Write to file
+getscript VIDEO_ID -o transcript.txt
+
+# Search & pick interactively (requires fzf)
+getscript --search "topic keywords"
+getscript --search "topic" --apple
+getscript --search "topic" --list          # print results, no fzf
+getscript --search "topic" --limit 20
+
+# YouTube auth options
+getscript VIDEO_ID --proxy socks5://127.0.0.1:1080
+getscript VIDEO_ID --cookies ~/cookies.txt
+
+# Transcripts are automatically indexed at voxlytranscribes.com
+# To disable:
+getscript VIDEO_ID --no-upload
+GETSCRIPT_UPLOAD=0 getscript VIDEO_ID
+
+# Shell completions
+getscript --completions bash >> ~/.bashrc
+getscript --completions zsh >> ~/.zshrc
+getscript --completions fish > ~/.config/fish/completions/getscript.fish
+```
+
+## Configuration
+
+Config file: `~/.config/getscript/config.json`
+
+```json
+{
+  "youtube_api_key": "YOUR_KEY",
+  "output_format": "text",
+  "timestamps": false,
+  "search_limit": 10,
+  "no_upload": false
+}
+```
+
+Environment variables:
+- `GETSCRIPT_YOUTUBE_API_KEY` — YouTube Data API v3 key (required for `--search`)
+- `GETSCRIPT_PROXY` — proxy URL for YouTube requests
+- `GETSCRIPT_COOKIE_FILE` — Netscape cookie file for YouTube auth
+- `GETSCRIPT_UPLOAD` — set to `0` to disable automatic shared library indexing
+- `GETSCRIPT_SUPABASE_URL` — custom Supabase URL (for development)
+- `GETSCRIPT_SUPABASE_ANON_KEY` — custom Supabase anon key (for development)
+- `NO_COLOR` — disable colors
+
+Priority: config file < environment variables < CLI flags.
+
+## How it works
+
+**YouTube:** Wraps [youtube-transcript-api](https://github.com/jdepoix/youtube-transcript-api) with proxy and cookie support.
+
+**Apple Podcasts:** Compiles a small Obj-C helper that uses Apple's private AMSMescal framework (FairPlay) to obtain a bearer token, then fetches TTML transcripts from the AMP API. The token is cached for 30 days at `~/.cache/getscript/apple_token`.
+
+## Dependencies
+
+- `youtube-transcript-api` — YouTube transcript fetching
+- `requests` — HTTP sessions for cookie-based auth
+- `fzf` (optional, system binary) — interactive search result selection
+
+## License
+
+MIT

getscript-0.12.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+getscript/__init__.py,sha256=X2DFrIRqj_Fm0_g7o-6I2Lc4AaSP4ppDhWqRH22mLb0,213
+getscript/apple.py,sha256=F-a2yeWN7MfYx150iSaQ1UrF6sVOvbAa9d0ENQmeCII,9522
+getscript/cli.py,sha256=ecwKrXuALV0Yz4u8CB_bZ2_YSVg8dD1rWYdOJV9Nn5U,11738
+getscript/completions.py,sha256=H-QBQMfnBXwK8sXBqBvgjQ36Zl1-AoqJYr3V9Ewazb8,3052
+getscript/config.py,sha256=iuvC2qE9skMXrVsNISFR10DufUENv8aGOar093UYMZ0,2084
+getscript/detect.py,sha256=xtqeSz1-aKqJmALO07cAJ6qBlK9gMGOnDSq6sLvN3d0,1786
+getscript/output.py,sha256=gHbcfhBeDGeeFLc5qKuTq-EHs_uvU4MebQAgVquu_KQ,2628
+getscript/picker.py,sha256=-I6wK2oh54Wcbi-508nAPXHxeMsK72LNAPF_ZD_jz5M,1851
+getscript/progress.py,sha256=ZTF-KnipnULd58v4QKF1xt_NKMyCHWZthfg2E3AOZSI,974
+getscript/search.py,sha256=CNUkhQ_IaG9ZP1gPWJGjEmrg09ZjfwNTSDXLurmH1Hk,2536
+getscript/upload.py,sha256=NYR70b68c5N2yGoLrUiuBCVkpXuwyazpffTfHSWNYCg,4172
+getscript/youtube.py,sha256=5RNrcp-bMO0pn7hbA_CFUPcV4xH5UG-u8LYstdJk_jY,1777
+getscript-0.12.0.dist-info/licenses/LICENSE,sha256=CoZlvAfv_mmtFA54JMbE3w2u8Cni28sMh753jm6h_us,1062
+getscript-0.12.0.dist-info/METADATA,sha256=i_tRoReoIoNYnpFIi3_DIfdObJRDwQFpj6w_f1niims,4031
+getscript-0.12.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+getscript-0.12.0.dist-info/entry_points.txt,sha256=vLclcSOUEw_s-uC5NNNc_KwQkblBJj41a97ssappfP4,49
+getscript-0.12.0.dist-info/top_level.txt,sha256=yHBYpEvg2hKjVr_e1l2UIgnTp-xmfGxDne4SNYAqNP0,10
+getscript-0.12.0.dist-info/RECORD,,

getscript-0.12.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

getscript-0.12.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+getscript = getscript.cli:main

getscript-0.12.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Voxly
+
+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.

getscript-0.12.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+getscript