Skip to main content

youtube-to-docs

PyPI version

Click on the image below to see a demo of YouTube to docs:

Convert YouTube videos into structured docs, summaries, audio, and visual assets for easier discovery.

It's built for people to stay in charge. Every output is a plain file (or a Google Doc or Word file on Drive or SharePoint) that you can review and edit. The next run reads your edited files instead of regenerating them, so a corrected transcript carries through to the summary, Q&A, infographic, audio and captions you make from it. See Review and edit the outputs.

View all available CLI options:

uvx youtube-to-docs --help

Optional Features

To keep the installation light, some features are optional. You can enable them by specifying "extras":

  • audio: Required for downloading audio and video from YouTube (uses yt-dlp, with yt-dlp-ejs and Deno to solve YouTube's challenges).
  • video: Required for video generation (uses static-ffmpeg).
  • workspace: Required for Google Drive integration.
  • m365: Required for Microsoft SharePoint/OneDrive integration.
  • huggingface: Required for storing artifacts to a Hugging Face dataset (uses huggingface_hub).
  • aws: AWS Bedrock support.
  • azure: Required for Azure OpenAI models.
  • gcp: Required for Google Gemini, Vertex AI models, and GCP Cloud TTS (uses google-genai and google-cloud libs).
  • app: Web app with browser-based UI (uses fastapi, uvicorn).
  • all: Installs everything.

Example: Run with audio and video support

uvx --with "youtube-to-docs[audio,video]" youtube-to-docs ...

Example: Run with everything

uvx --with "youtube-to-docs[all]" youtube-to-docs ...

Note: The commands above require uv. You can install it via:

  • macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
  • Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Install as a plugin (the process_video MCP server and the youtube-to-docs skill) in Claude Code:

claude plugin marketplace add DoIT-Artificial-Intelligence/youtube-to-docs
claude plugin install youtube-to-docs@youtube-to-docs

or in Antigravity:

agy plugin install https://github.com/DoIT-Artificial-Intelligence/youtube-to-docs

Then ask for what you want, e.g. "Make the best accessible captions for https://www.youtube.com/watch?v=B0x2I_doX9o", or run /youtube-to-docs <url>.

Run as a web app:

uvx --from "youtube-to-docs[all]" youtube-to-docs-app

Then open http://localhost:8000 in your browser. See the Web App docs for details.

Created with the help of AI. All artifacts have been checked and work as expected.

Metadata

Release files for youtube-to-docs 0.0.127

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for youtube-to-docs 0.0.127
File Size Uploaded Provenance
youtube_to_docs-0.0.127.tar.gz 774.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for youtube-to-docs 0.0.127
File Interpreter ABI Platform
youtube_to_docs-0.0.127-py3-none-any.whl Python 3 none any Details

Total release size: 1.5 MB

Release files / youtube_to_docs-0.0.127.tar.gz

Download URL youtube_to_docs-0.0.127.tar.gz
Size 774.3 kB
Tags Source
SHA-256 checksum
How to use checksums
2d04d390513a9ed94aa350e0f3af3256f97499db8b8443ad7fc500960bebbfda
BLAKE2b-256 checksum
How to use checksums
8e41c16281f277cc2e5793f64d542cdec8787025b57042a881afb2e286707a7a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / youtube_to_docs-0.0.127-py3-none-any.whl

Download URL youtube_to_docs-0.0.127-py3-none-any.whl
Size 725.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5d078a7f3514d92bcd12ecd6f72a91039bbe00e88eea42ebd312a420471f112b
BLAKE2b-256 checksum
How to use checksums
f73edcb279c5c4b02b1f1f781ee7b3089c950f920c8157538a0b4ee9dfeef4c0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Security for youtube-to-docs 0.0.127

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

0.0.127 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page