explaingit

marcelpanse/youtube-guitar-tab-parser

Analysis updated 2026-05-18

157TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

A command line tool that downloads a YouTube guitar lesson, uses Claude's vision model to find and read the on-screen tab notation, and outputs it as a clean PDF.

Mindmap

mindmap
  root((tab parser))
    What it does
      Downloads YouTube video
      Finds tab region
      Dedupes by bar number
      Outputs PDF
    Tech stack
      TypeScript
      Node.js
      Claude vision
      ffmpeg and yt-dlp
    Use cases
      Archive guitar tabs
      Offline practice PDFs
      Lesson video conversion
    Requirements
      Node 20 plus
      yt-dlp and ffmpeg
      Anthropic API key

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Convert a YouTube guitar lesson video into a printable PDF of its guitar tab notation.

USE CASE 2

Automatically deduplicate scrolling tab footage down to one clean screenshot per line of music.

USE CASE 3

Batch-archive guitar tabs from favorite YouTube lesson videos for offline practice.

What is it built with?

TypeScriptNode.jsClaude APIffmpegyt-dlp

How does it compare?

marcelpanse/youtube-guitar-tab-parsersinotrade/shioaji-pro-appufuknode/noustiny
Stars157157157
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardmoderate
Complexity3/54/53/5
Audiencedeveloperdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs yt-dlp and ffmpeg on your PATH plus a paid Anthropic API key for the vision calls.

The readme does not state a specific license, so terms of use are unclear.

In plain English

This is a command line tool that takes a YouTube guitar lesson video and turns the guitar tab sheet music shown on screen into a downloadable PDF. Many guitar lesson videos display scrolling tab notation on screen while the instructor plays, and this tool automates the tedious process of manually screenshotting each new line of that notation as it appears. It works by downloading the video, taking screenshots at regular intervals, and using Claude's image understanding ability to figure out where on screen the tab notation actually appears. Once it knows that region, it crops every screenshot down to just that area. Because the video keeps showing the same line of tab for several seconds while it plays, the tool reads the small bar or measure number printed on each line and keeps only one screenshot per distinct number, throwing away the repeated near identical frames and anything that is not actually sheet music, like an intro or title card. The remaining unique lines are then stacked one after another into a single PDF, with the video's own title used as both the file name and the heading on the first page. Running it requires Node.js version 20 or newer, plus two external command line tools, yt-dlp for downloading YouTube videos and ffmpeg for extracting frames from them, both of which need to already be installed and available on the system. It also requires a paid Anthropic API key, since detecting the tab region and reading the bar numbers both rely on calls to Claude's vision model. Several options let you adjust things like how often frames are sampled, which Claude model is used, and how aggressively near duplicate frames are filtered out before they reach the more expensive vision step, though the defaults are meant to work without any tuning for most videos. The readme does not state a specific software license for the code.

Copy-paste prompts

Prompt 1
Help me install yt-dlp and ffmpeg and set up my Anthropic API key to run youtube-guitar-tab-parser.
Prompt 2
Show me the CLI command to run youtube-guitar-tab-parser on a specific YouTube lesson URL with a custom screenshot interval.
Prompt 3
Explain how youtube-guitar-tab-parser detects the tab region on screen and deduplicates frames by bar number.
Prompt 4
How do I adjust the dedup-threshold and max-height options in youtube-guitar-tab-parser to reduce API costs?

Frequently asked questions

What is youtube-guitar-tab-parser?

A command line tool that downloads a YouTube guitar lesson, uses Claude's vision model to find and read the on-screen tab notation, and outputs it as a clean PDF.

What language is youtube-guitar-tab-parser written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Claude API.

What license does youtube-guitar-tab-parser use?

The readme does not state a specific license, so terms of use are unclear.

How hard is youtube-guitar-tab-parser to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is youtube-guitar-tab-parser for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.