Georgi Yanev

Making a youtube timestamp screenshot app

July 14, 2018 ⌛ 5 min read

I recently wanted to extract a screenshot from a YouTube video of one of my racing drone flights. Sounds easy enough, doesn’t it? Turned out much harder than I thought, so I decided to make an app to solve it for me.

Defining the problem

You see, YouTube generates up to 4 different sizes of the video thumbnail and does not expose any API for timestamped thumbnails. And so at this point the ‘easy’ solution to get this done and move on with my life, would have been to download a copy of the video and extract the screenshot with some video editting software.

But that does not scale well and does not support me in the future. I don’t want to have to do THAT every time.

Searching for available solutions

First I had a look at the YouTube API. From having previously written this video component I knew I could access video thumbnails straight from the API. I hoped there would be a way to get a screenshot at any time of the video in the same fashion. For example by using the time query parameter: t=23m19s. But that was not the case.

Then I thought it would be quite possible someone had already solved that problem. I was wrong (unless I missed it in which case feel free to let me know how bad I am at googling at @jumpalottahigh).

I found a few YouTube thumbnail extractor sites, which didn’t really solve the issue.

Making my own

So finally I started thinking how I could do that and since for a while now I wished I had a good idea for a Puppeteer project, things just clicked.

I had one last idea to solve this easier. I knew in the chrome dev tools you could press CMD + SHIFT + P to get the command palette, type in screenshot and select to take a screenshot of a DOM node (entire page was not needed for me and a specific node would be the perfect shot). Unfortunately there was no way (to the extent of my knowledge) to call that programatically. Oh, well, Puppeteer it is then.

Puppeteer is a Node library which provides a high-level API to control Chrome or Chromium over the DevTools Protocol. Read more.

The initial algorithm was the following:

  1. Go to${videoID}&t=${time}

Where videoID is what is the unique YouTube video id and time is a string that looks like 11m29s that moves the video player to that point

  1. Reverse engineer a unique identifier for video player

Using Chrome dev tools, find an id or a class, unique to the page to use to grab a screenshot of that node.

I came across .html5-video-player for the video player as the node I wanted to take a screenshot of.

  class="video-stream html5-main-video"
  style="width: 640px; height: 360px; left: 0px; top: 0px;"

I also noticed that to get a clean screenshot I’d probably have to hide the video player controls. And so I looked for an appropriate identifier for that too. Turns out .ytp-chrome-bottom is one.

  1. Write a test with Puppeteer locally to verify hypothesis

So I started playing around with what could be done and after half an hour ended up with something along the lines of:

const page = await browser.newPage()
await page.goto(urlToScreenshot + '&t=' + req.query.t)
await page.setViewport({ width: 1920, height: 1080 })

const video = await page.$('.html5-video-player')
await page.evaluate(() => {
  // Hide youtube player controls.
  let dom = document.querySelector('.ytp-chrome-bottom') = 'none'

The interesting part here is the page.evaluate() function that allows us to actually grab the video controls element and hide it, before taking the screenshot.

The complete source code is here, in case you are interested.

And here’s an example of what could be scraped.

Full YouTube page for the sake of illustration, Full page YouTube Puppeteer screenshot

and no video player controls DOM node screenshot: No video player controls DOM node screenshot using Puppeteer

Pretty neat!

  1. Deploy project

You see, I hadn’t previously deployed Node or Puppeteer apps so ideally I wanted to first deploy the project as a lambda / cloud function. I had worked with Firebase before, but it turns out that the Firebase images do not support the bundled version of Chromium that comes with Puppeteer and therefor was a no go. AWS lambdas I had no experience with and felt like too much of an investment in learning at this point in time (want to learn it later, but not a priority right now). Netlify, I didn’t know much about their cloud functions either.

Somewhere in the middle of this I also stumbled upon this gem. I actually ended up using this project as a starting point and just implemented the logic I needed for my use case. So thank you, Tim Leland for this write up 👌

I used that example to deploy to Heroku. Perfect.

The heroku ‘backend’ of the project is live at: To use it you need to append a youtube URL including a timestamp to the url parameter after the app’s url.

For example:

Should return to you the screenshot of the video at 13 minutes and 37 seconds in.

Additionally, you can access the service here:

This is hosted on Netlify and deployed from the /docs directory in the master branch, on commit.

Wrap up

How useful is this solution to the problem is somewhat arguable, however, it did solve an issue for me and enables me to get screenshots much faster in the future, so I’d call it a success. I also had fun building it and connecting a bunch of different technologies together.

Did I miss something?

Ask a question and see it updated in the article, alongside with credit for you.


Thanks for your suggestion!

Reader questions:

“This is a great little project! Thank you so much for putting it together! Quick question— when I use your app to fetch a screenshot of a YouTube video at a specific timestamp, I’m unfortunately getting a banner ad at the bottom of the video (bc Puppeteer is running on Heroku w/o an adblocker, clearly). How did you get around this?” - Robert

Thank you! If I recall correctly I haven’t done anything special about this, the implementation is pretty simple and using things out of the box, check the code here - - Georgi


“Please also accept the short form YouTube links with time for example: Because when you right click on a video to get the time stamped link that’s what you get.” - Dashakol

Hi, Dashakol and thanks for your suggestion! The project is open source and I would gladly accept PRs if you are willing to put one together. I loved building and learning from this project, but I haven’t had more time to fully develop it further and there surely are a lot of missing features. However, the project is open source and available on GitHub so anyone can add more functionality to it, or just fork it and create their own. - Georgi

Need even more FPV in your life? Check out my YouTube channels:


📰 Monthly Newsletter

I hate spam, and so I don't spam. Unsubscribe at any time.