# YouTube Transcript to Article

YouTube Transcript to Article is a self-hosted web app and HTTP API that converts YouTube captions into structured Markdown articles using an OpenAI-compatible model. It is open source and self-hosted, installable on Unraid and Docker Hub.

Canonical page: https://ourlocalhost.com/app/2385/youtube-transcript-to-article

## Description

YouTube Transcript to Article is a self-hosted web app and HTTP API that converts YouTube captions into structured Markdown articles using an OpenAI-compatible model. It resolves videos by URL or ID, supports depth levels and optional word targets, and lets users choose OpenAI or LocalAI for model calls. An optional MCP server mode returns only the transcript and video metadata so an external assistant can perform the writing. It is aimed at homelab users, writers, and researchers who want a controllable, API-driven way to turn spoken YouTube content into publishable text.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

37/100 (Low), based on 3 of 4 factors.
- Maintained: 50 (last commit 226 days ago)
- Popular: 18 (7 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- GitHub: https://github.com/patrickstigler/youtube-transcript-to-article
- Unraid: https://ca.unraid.net/apps/youtube-transcript-to-article-19wq6d019wl5fs?q=youtube-transcript-to-article
- Docker Hub: https://hub.docker.com/r/patrickstigler/youtube-transcript-to-article

## Common questions

### Can I use LocalAI instead of OpenAI?

Yes, the web app and HTTP API use an OpenAI-compatible chat model. OpenAI or LocalAI are supported.

### Does MCP mode use an LLM inside the container?

No, optional MCP mode returns the transcript and video metadata only. It does not require an LLM in the container.

### Can I adjust the article depth, length, language, or model?

Yes, the web/API can generate structured Markdown while you control depth, length, language, and model.

### Can I pull the image from GitHub Container Registry?

Yes, the image is also available on GHCR. Set the repository to the GHCR repository and the registry to ghcr.io.

---
Source: Our Local Host (https://ourlocalhost.com/app/2385/youtube-transcript-to-article), the self-hosted and open-source app directory.
