Metadata-Version: 2.4
Name: youtube-to-docs
Version: 0.0.83
Summary: Convert YouTube videos into structured docs, summaries, audio, and visual assets for easier discovery
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: google-api-python-client>=2.187.0
Requires-Dist: isodate>=0.7.2
Requires-Dist: mcp>=1.26.0
Requires-Dist: polars>=1.36.1
Requires-Dist: requests>=2.32.5
Requires-Dist: rich>=14.2.0
Requires-Dist: rich-argparse>=1.7.2
Requires-Dist: youtube-transcript-api>=1.2.3
Provides-Extra: aws
Requires-Dist: boto3>=1.42.49; extra == "aws"
Requires-Dist: botocore[crt]; extra == "aws"
Provides-Extra: azure
Requires-Dist: openai>=1.56.0; extra == "azure"
Provides-Extra: gcp
Requires-Dist: google-genai; extra == "gcp"
Requires-Dist: google-cloud-speech>=2.29.0; extra == "gcp"
Requires-Dist: google-cloud-storage; extra == "gcp"
Requires-Dist: google-cloud-texttospeech; extra == "gcp"
Requires-Dist: google-cloud-translate>=3.0.0; extra == "gcp"
Provides-Extra: workspace
Requires-Dist: google-auth-oauthlib; extra == "workspace"
Requires-Dist: pypandoc>=1.16.2; extra == "workspace"
Requires-Dist: pypandoc_binary>=1.16.2; extra == "workspace"
Provides-Extra: m365
Requires-Dist: msal>=1.34.0; extra == "m365"
Requires-Dist: fastexcel>=0.12.0; extra == "m365"
Requires-Dist: xlsxwriter>=3.2.9; extra == "m365"
Requires-Dist: pypandoc>=1.16.2; extra == "m365"
Requires-Dist: pypandoc_binary>=1.16.2; extra == "m365"
Provides-Extra: audio
Requires-Dist: yt-dlp>=2026.01.29; extra == "audio"
Provides-Extra: video
Requires-Dist: static-ffmpeg>=2.13; extra == "video"
Provides-Extra: app
Requires-Dist: fastapi>=0.135.1; extra == "app"
Requires-Dist: uvicorn[standard]>=0.41.0; extra == "app"
Provides-Extra: all
Requires-Dist: youtube-to-docs[app,audio,aws,azure,gcp,m365,video,workspace]; extra == "all"
Dynamic: license-file

# youtube-to-docs
[![PyPI version](https://img.shields.io/pypi/v/youtube-to-docs.svg)](https://pypi.org/project/youtube-to-docs/)

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

<div align="center">
  <a href="https://www.youtube.com/watch?v=H6Jw10bmMcI">
    <img src="https://img.youtube.com/vi/H6Jw10bmMcI/0.jpg" alt="Watch the video" width="300" />
  </a>
</div>

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

View all available CLI options:

```bash
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 TTS and audio processing (uses `yt-dlp`).
- `video`: Required for video generation (uses `static-ffmpeg`).
- `workspace`: Required for Google Drive integration.
- `m365`: Required for Microsoft SharePoint/OneDrive integration.
- `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**
```bash
uvx --with "youtube-to-docs[audio,video]" youtube-to-docs ...
```

**Example: Run with everything**
```bash
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 Gemini CLI extension:

```bash
gemini extensions install https://github.com/DoIT-Artificial-Intelligence/youtube-to-docs.git
```

Install as a Claude Code plugin:

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

Run as a web app:

```bash
uvx --with "youtube-to-docs[all]" youtube-to-docs-app
```

Then open http://localhost:8000 in your browser. See the [Web App docs](https://doit-artificial-intelligence.github.io/youtube-to-docs/usage/#web-app) for details.

Install as an MCP server for Claude Code:

```bash
claude mcp add youtube-to-docs -- uvx --with "youtube-to-docs[all]" python -m youtube_to_docs.mcp_server
```

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