gobbler

Gobbler

Universal Content Conversion to Markdown for AI

Gobbler transforms any content—YouTube videos, web pages, documents, audio files, even live browser sessions—into clean, structured markdown that AI systems can immediately reason about.

The Problem

AI assistants work best with markdown. But content exists in countless formats—PDFs, videos, web pages behind logins, audio recordings. Getting that content into a format AI can use requires:

• Different tools for each content type
• Custom scripts to extract and format
• Lost metadata and inconsistent output
• No unified way for AI agents to access content

Gobbler solves this. One CLI, one output format, multiple content types.

The Solution

# Every content type → Same pattern → Same output format
gobbler youtube "https://youtube.com/watch?v=..." -o transcript.md
gobbler document report.pdf -o report.md
gobbler audio meeting.mp3 -o meeting.md
gobbler webpage "https://docs.example.com" -o docs.md

Every conversion produces markdown with YAML frontmatter:

---
source: https://youtube.com/watch?v=VIDEO_ID
type: youtube_transcript
title: "Video Title"
duration: 847
word_count: 2341
converted_at: 2025-01-03T10:30:00Z
---

# Video Title

Content here, ready for AI consumption...

Quick Start

# Install
git clone https://github.com/Enablement-Engineering/gobbler.git
cd gobbler && make install

# Start services (for web/document conversion)
make start-docker

# Convert content
gobbler youtube "https://youtube.com/watch?v=dQw4w9WgXcQ"
gobbler document paper.pdf --no-ocr -o paper.md
gobbler audio interview.mp3 --model small -o interview.md

📖 Full Documentation

Project Status

Gobbler is an active beta project focused on reliable, agent-friendly content conversion. The supported automation surface is intentionally CLI-first:

• Primary interface: gobbler CLI for humans, scripts, and AI agents.
• Agent experience: markdown Skills and setup docs teach agents the same commands a human can run and verify.
• Browser support: optional local extension for authenticated browser sessions and supported AI chat surfaces.

See the roadmap, security policy, and Hermes/OpenClaw/agent usage guide for current direction.

CLI-First, Skills-Ready

Gobbler's primary interface is the gobbler CLI. Hermes, OpenClaw, and other agents use Skills to learn those same commands, and the browser extension adds authenticated browser-session access through the CLI. For agent-specific workflows, start with the Hermes/OpenClaw/agent usage guide.

1. CLI

gobbler youtube URL              # YouTube transcripts
gobbler audio FILE               # Audio/video transcription
gobbler document FILE            # PDF, DOCX, PPTX, XLSX
gobbler webpage URL              # Web pages (JS-rendered)
gobbler batch youtube-playlist URL  # Batch processing

2. Skills (For AI Agents)

Skills are markdown instruction files (SKILL.md) that teach AI agents how to use the gobbler CLI. Compatible with:

• OpenClaw - Personal AI assistant platform
• Claude Code - Anthropic's coding agent
• Cursor / Windsurf - AI-powered IDEs
• Any agent that supports skill/tool discovery via markdown