get-youtube-chapters

parse chapters from a youtube video description

Install - Usage - License: Apache-2.0

YouTube now parses "chapters" from video descriptions like this:

This package aims to implement more-or-less similar parsing so you can figure out which chapters a video has on your own.

Install

npm install get-youtube-chapters

Usage

Pass in a description string:

var youtubeChapters = require('get-youtube-chapters')
var chapters = youtubeChapters(`
This is a sample description for a video with a track listing!

0:00 Intro
1:36 BOCA
4:44 Break the wall
8:29 Can't get you out of my mind
12:09 Dear
15:55 BOCA (Inst.)
`)

assert.deepStrictEqual(chapters, [
  { start: 0, title: 'Intro' },
  { start: 96, title: 'BOCA' },
  { start: 284, title: 'Break the wall' },
  { start: 509, title: "Can't get you out of my mind" },
  { start: 729, title: 'Dear' },
  { start: 955, title: 'BOCA (Inst.)' }
])

The return value is an array of { start, title } objects. start is the start time in seconds. Chapters run until the start of the next chapter, or the end of the video.

License

Apache-2.0

get-youtube-chapters change log

All notable changes to this project will be documented in this file.

This project adheres to Semantic Versioning.

2.0.0

• Support zero-prefixed style: 00:00 Chapter Title. Thanks @Kacper-Lubisz!
• Support bracketed styles: [0:00] Chapter Title / (0:00) Chapter Title. Thanks @unreleased!
• Remove extended: true option. YouTube now supports the formats that the option enabled, so the library has also accepts those formats by default.
• The library now uses some ES6 syntax like const. If you are targeting pre-modern browsers, you may need to configure a transpiler.

1.1.0

• Add typescript types.

1.0.0

• Initial release.