youtube-to-docs
Convert YouTube videos into structured docs, summaries, audio, and visual assets for easier discovery.
Open source Open in the app JSON README (API)
About
Convert YouTube videos into structured docs, summaries, audio, and visual assets for easier discovery.
Details
- Kind
- Plugins
- Topic
- Social & content
- Publisher
- doit-artificial-intelligence
- Origin
- gemini
- Category
- ferramentas
- Version
- 1.0.0
- Stars
- 50
- Forks
- 6
- Open pull requests
- 1
- Last push
- 2026-09-01T21:00:10Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
doit-artificial-intelligence/youtube-to-docs
README
# youtube-to-docs
[](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.
- `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**
```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 --from "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.*