Hacking Netflix subtitles


I love learning foreign languages, and consider watching movies one of the best way to do that. On the post-intermediate level especially, when you are able to actually enjoy the movie (笑). Subtitles can be a great help in the beginning (though they also may be the greatest obstacle later on). If you pair subtitles with the ability to seek to a specific phrase in the video, they become a powerful instrument.

Some time ago, I built Videobook. You give it a video file and a subtitles file, and it displays a navigation toolbar that lists all the subtitle phrases. You can click on a phrase and listen it over and over. It looks like this:

Videobook screenshot

Videobook works great for downloaded content, but what about streaming video (Netflix, Hulu etc)?

Hacking Netflix's JavaScript app

Netflix loads it's subtitles via XHR as a single XML file in W3C's TTML format. After Netflix parses the file into an array of objects with start and end time + the text blocks, its React application displays the subtitles one-by-one is a div placed over the video.

I was able to hi-jack the parsed subtitles array from the Netflix app by monkey-patching the Array#push method. You need to evaluate this code in the console as soon as the page starts loading:

var subs = (function () {
    var subs = [];
    var push = Array.prototype.push;
    Array.prototype.push = function () {
        if (arguments[0] && arguments[0].blocks) {
            subs[subs.length] = arguments[0];
        return push.apply(this, arguments);
    return subs;
I learned where to insert the patch by setting a break-point on DOM sub-tree modification in Chrome DevTools.

DevTools screenshot

The subtitles are objects like this:

    "startTime": 14000,
    "endTime": 27000,
    "blocks": [
        "textNodes": [
            "text": "Wer seid ihr?"

Next I created a simple UI to list the subs:

var overlay = document.createElement('div');
overlay.style.position = 'fixed';
overlay.style.zIndex = 1000;
overlay.style.right = 0;
overlay.style.top = 0;
overlay.style.bottom = 0;
overlay.style.width = '300px';
overlay.style.backgroundColor = 'white';
overlay.style.overflow = 'auto';
overlay.style.color = '#000';

var video = document.querySelector('video');

subs.forEach(function (sub) {
    var item = document.createElement('div');
    item.textContent = sub.blocks[0].textNodes.map(function (t) { return t.text; }).join('\n');
    item.style.whiteSpace = 'nowrap';
    item.style.padding = '10px 5px';

    item.onclick = function () { video.currentTime = sub.startTime / 1000 };



The result looks like this:

Netflix screenshot

However, the Netflix app is designed in such way that when you attempt to set the position of the video via its DOM element, an error is displayed and the whole application stops.

Fork me on GitHub