Download Japanese subtitles as TEXT from Netflix using a Kodi plugin

Updated 1/7/19: I no longer recommend using the method below, and I may not provide any further updates. I now recommend Subadub for studying Japanese from Netflix subtitles. If you want to batch-download subtitles in any language, I recommend Netflix Subtitle Downloader.

I just want the subs!

I have already downloaded Japanese subtitles from over 100 shows and movies, including many native Japanese Netflix originals, and you can grab them all here.

I want to do it myself!

This process involves installing a home theater application called Kodi, and then installing a plugin for it that will allow you to sign into Netflix and then automatically save SRT subtitles for any files videos that you try to play.

The NetflixSubs plugin and installation instructions have been moved to a GitHub page here:

Just click through to that page and scroll down for instructions on how to download and install the plugin.

Here is a video tutorial by Matt VS Japan, which shows how to install Kodi and the NetflixSubs plugin, and download subtitles. This uses an older version of the plugin, and some things have changed, but this still gives you a basic overview of how to get things set up.

357 thoughts to “Download Japanese subtitles as TEXT from Netflix using a Kodi plugin”

  1. Just wanted to say that plug-in is still working fine for me. I live in Japan and have had no issues; just downloaded a season’s worth of episode subtitles five minutes ago. I think people who are having problems should uninstall and re-install completely. Then if that doesn’t work try an older version of the plug-in and Kodi itself. Good luck!

  2. Thanks for providing the awesome tool.
    I’m native Japanese so I want to download Japanese subtitles to watch English Movie.
    But I cant log in my Netflix account through the plugin.
    Do U have any solution or Is it the same problem as 6/5 updated post?

    1. I’m sorry, I have a life (as unlikely as it may sound), I can’t check this thread every day.

      Yes, that’s the debug log, thanks. Though it seems to end before a successful login. Can you try to upload a log after you try to select an episode to download subtitles? Or is the problem occurring before you can even select an episode?

    1. Have you set the Download folder? In the add-on’s settings.
      Are you sure the video you’re trying to extract from, actually has subtitles?

      1. Yes i have set my Download Subs folder in settings and i try a lot videos!
        Maybe the fault is i have VPN enable?

        1. Seriously, please post the debug log, it will likely point out specifically what kind of error you’re encountering. It’s easy to make

          VPN is usually not the issue, although sometimes, perhaps for account security reasons (logging in from many different places is considered suspicious account activity), an existing session will stop giving you access to videos and subtitles (despite being able to browse the library), at which point a re-login – and sometimes also changing your netflix password – tends to solve it.

          If that’s not the problem, then without a debug log I’m out of ideas.

  3. On attempting to open the add-on (after clicking the NetflixSubs icon):
    “NetflixSubs Error
    Check the log for more information.”

    KodiSetup-20180603-dba439f5-master-x64.exe (May 28th, ANONYNEKO)

    I have tried uninstalling the add-on and re-installing it, changing password, opening the add-on multiple times. I tried initially with a kodi version from around 4/10, but it didn’t work either. That version worked with ALAN’s version of the plugin (before it broke).

      1. Honestly it’s a question better asked of as I haven’t touched anything even remotely near this and have had similar problems with it. When this happens I usually just try opening the plugin several times and then at some point it starts working. If that doesn’t help I’m out of ideas, this “target machine actively refused connection” error usually means the problem is with the plugin’s internal proxy, and unfortunately that thing either doesn’t seem to log anything useful, or does it somewhere I’m not aware of.

        Try installing and see if it has the same issue, if it doesn’t then at least the scope will be much narrower.

        Original plugin authors have also suggested to turn off “scanners”, whatever that is, but I don’t think I have any scanner-looking plugins installed in the first place so I dunno.

          1. Replacing\resources\lib\
            with\resources\lib\ from 0.13.7 release

            fixes my issue.

        1. Make a debug log:

          Also, what often helps me is changing Netflix password and sometimes clearing out plugin settings (I just remove email and password in %appdata%/Kodi/userdata/ – a fresh reinstall of the plugin should do the trick as well)

          That, or just trying to open the plugin several times until it suddenly works. Same behavior with the original plugin, too…

  4. I saw the update 13.6 in the comments and installed it and now I’m able to log in, but when I go to download a subtitle, it acts like it is playing in the top right, and then just doesn’t download it.. this happens if I put the subtitle code to ja or leave it blank. 🙁

    It sucks cause you don’t have the big bang theory subtitles already downloaded so now i have a bunch of episodes downloaded without the subtitles

  5. Love this so much!! Everything was working, but I had to change my password recently, and now I am unable to log into the plugin. I have tried reinstalling it, etc. Even have the email and password copy and pasted from a notepad, and when pasting into the browser it works, but not when putting it into the plugin. Any help would be greatly appreciated!

  6. Hi. With May 29 version and the plugin that ANONYNEKO put above, error occurs when launching. Checking Dependencies, it says script.module.pycryptodome is unavailable. I think this is the problem?
    As someone seems to had the same problem, I looked for March 29 or April 9 version, couldn’t find.
    Any suggestion??

    1. Try different builds of Kodi 18 (this won’t work with 17), I had this issue but I genuinely don’t remember what fixed it, but either way I’ve reinstalled Kodi a gazillion times already since then and I didn’t get this error again.

      You can try installing the plugin itself and see if it installs the requirements, if you get the same error – it’s likely your Kodi version.

      1. waaa thank you so much for this, i was trying to furiously type in my login credentials like 10 times before I found your fix. Thank you ANONYNEKO, you’re a life saver <3333

    1. Thank you for assistance updating the plugin while I have been away for a while. I have moved the plugin to Github to make things simpler if you would like to assist again in the future.
      I’ve released a new version based on the latest release of Kodi. If you dont mind, please review and make sure I didn’t undo any enhancements or fixes that you made!

  7. Sorry for the triple post… But also wanted to mention it fails if you try to logout or switch accounts in the settings as well. Maybe there is some issue with fetching the data from the original Netflix plugin?

  8. Oh, I think it’s worth mentioning I now get the failed credentials error with the old Ahmed Bafkir script as well. So it’s probably broken due to some update.

  9. Getting a very similar error to Paul. I also get the credential failure issue despite typing it correctly. Here is the log with the line before the first error as well.

    NOTICE: ADDON: skin.estuary v2.0.9 installed
    10:58:25.926 T:2480 ERROR: XFILE::CDirectory::GetDirectory – Error getting
    10:58:54.836 T:8276 ERROR: Previous line repeats 6 times.
    10:58:54.836 T:8276 ERROR: XFILE::CDirectory::GetDirectory – Error getting plugin://
    10:58:54.847 T:8352 ERROR: CGUIMediaWindow::GetDirectory(plugin:// failed
    10:59:02.336 T:8352 WARNING: CGUIWindowManager – CGUIWindowManager::HandleAction – ignoring action 107, because topmost modal dialog closing animation is running
    10:59:17.127 T:6396 WARNING: Previous line repeats 4 times.
    10:59:17.127 T:6396 ERROR: EXCEPTION Thrown (PythonToCppException) : –>Python callback/script returned the following error<–
    Error Type:
    Error Contents: ”
    Traceback (most recent call last):
    File “C:\Users\Xavier\AppData\Roaming\Kodi\addons\\”, line 42, in
    File “C:\Users\Xavier\AppData\Roaming\Kodi\addons\\resources\lib\”, line 45, in wrapped
    result = func(*args, **kwargs)
    File “C:\Users\Xavier\AppData\Roaming\Kodi\addons\\resources\lib\”, line 81, in router
    return self.switch_account()
    File “C:\Users\Xavier\AppData\Roaming\Kodi\addons\\resources\lib\”, line 642, in switch_account
    self._check_response(self.call_netflix_service({‘method’: ‘logout’}))
    File “C:\Users\Xavier\AppData\Roaming\Kodi\addons\\resources\lib\”, line 883, in call_netflix_service
    data = urllib2.urlopen(full_url).read(opener)
    File “C:\Program Files\Kodi\system\python\Lib\”, line 154, in urlopen
    return, data, timeout)
    File “C:\Program Files\Kodi\system\python\Lib\”, line 429, in open
    response = self._open(req, data)
    File “C:\Program Files\Kodi\system\python\Lib\”, line 447, in _open
    ‘_open’, req)
    File “C:\Program Files\Kodi\system\python\Lib\”, line 407, in _call_chain
    result = func(*args)
    File “C:\Program Files\Kodi\system\python\Lib\”, line 1228, in http_open
    return self.do_open(httplib.HTTPConnection, req)
    File “C:\Program Files\Kodi\system\python\Lib\”, line 1201, in do_open
    r = h.getresponse(buffering=True)
    File “C:\Program Files\Kodi\system\python\Lib\”, line 1121, in getresponse
    File “C:\Program Files\Kodi\system\python\Lib\”, line 438, in begin
    version, status, reason = self._read_status()
    File “C:\Program Files\Kodi\system\python\Lib\”, line 402, in _read_status
    raise BadStatusLine(line)
    BadStatusLine: ”
    –>End of Python script error report<–

  10. Hi, I am a Korean who is trying to use this program. Plugin has been installed, but it generates error in the loging in process. I correctly typed in my e-mail and password, but it says that it has failed to login due to credential issues.

    Here is the log for error parts:
    18:40:44.851 T:8984 ERROR: XFILE::CDirectory::GetDirectory – Error getting
    18:40:46.306 T:6768 ERROR: Previous line repeats 6 times.
    18:40:46.306 T:6768 ERROR: EXCEPTION Thrown (PythonToCppException) : –>Python callback/script returned the following error<–
    Error Type:
    Error Contents:
    Traceback (most recent call last):
    File “C:\Users\paulk\AppData\Roaming\Kodi\addons\\”, line 42, in
    File “C:\Users\paulk\AppData\Roaming\Kodi\addons\\resources\lib\”, line 45, in wrapped
    result = func(*args, **kwargs)
    File “C:\Users\paulk\AppData\Roaming\Kodi\addons\\resources\lib\”, line 85, in router
    options = self.before_routing_action(params=params)
    File “C:\Users\paulk\AppData\Roaming\Kodi\addons\\resources\lib\”, line 45, in wrapped
    result = func(*args, **kwargs)
    File “C:\Users\paulk\AppData\Roaming\Kodi\addons\\resources\lib\”, line 708, in before_routing_action
    ‘method’: ‘is_logged_in’}))
    File “C:\Users\paulk\AppData\Roaming\Kodi\addons\\resources\lib\”, line 883, in call_netflix_service
    data = urllib2.urlopen(full_url).read(opener)
    File “C:\Program Files\Kodi\system\python\Lib\”, line 154, in urlopen
    return, data, timeout)
    File “C:\Program Files\Kodi\system\python\Lib\”, line 429, in open
    response = self._open(req, data)
    File “C:\Program Files\Kodi\system\python\Lib\”, line 447, in _open
    ‘_open’, req)
    File “C:\Program Files\Kodi\system\python\Lib\”, line 407, in _call_chain
    result = func(*args)
    File “C:\Program Files\Kodi\system\python\Lib\”, line 1228, in http_open
    return self.do_open(httplib.HTTPConnection, req)
    File “C:\Program Files\Kodi\system\python\Lib\”, line 1198, in do_open
    raise URLError(err)
    –>End of Python script error report<–
    18:40:46.329 T:12020 ERROR: XFILE::CDirectory::GetDirectory – Error getting plugin://
    18:40:46.332 T:10708 ERROR: CGUIMediaWindow::GetDirectory(plugin:// failed

  11. Hi,

    I am on a Mac and when I try to install the zip file, it comes up with a message saying installation failed. Do you know how to resolve this?


  12. Hello,

    Thanks for all your hard work. Unfortunately it doesnt seem to be downloading the japanese subtitles for me. I have used a VPN, but it doesnt download irrespective of whether the VPN is being used or not. Any Ideas?

  13. Hi, Alan. I wanted to download only Japanese subtitles but I’ve found that writing “JA” in the settings doesn’t work (it doesn’t download anything), BUT writing “ja” (lowercase) works.
    So, it seems that this option is case sensitive. I used the all caps “JA” because that’s the way it’s written in the name of the .srt file, but it’s lowercase in the Subtitle_urls.txt file, and that’s the one that counts.
    If you can’t modify the script to make it case insensitive, maybe you could just write something like “(lowercase)” near that option. It’s a stupid problem, I know, but it took me a while to solve it, and maybe this could be useful to other people.

      1. Just want to mention that JONATHAN is right. I did the same for Greek subs and just wrote “el” (el not gr) in the settings instead of capital “EL”. The first worked, the second not. Nice try for this plugin though. Just my thoughts:

        1) Plugin crashes when you “download” the sub you want. This should be fixed. Any eta for this?
        2) We must have the chance to download the WHOLE serie (e.g S01) and not only one sub at the time.
        3) I think the dev of this plugin should talk with this dev here I have open an issue for his for the image-based sub support. I think the NetflixSub plug in may be a possible solution to his problem (if those 2 plugins can be united into one).

        1. 1) The crashing seems to be related to newer builds of Kodi. Somone mentioned that the build from April 9 was working for them. I know I’m using a build that is a month or two old and its working fine. When I get some time, I’ll try to dive a bit deeper into what is causing that problem.

          2) Good idea, but I think that might be a little difficult to implement. I’ll check into it.

          3) This plugin is just a simple hack of that Netflix plugin, I can’t do anything to help add support for image subtitles.

          1. I ve downgraded to a build from 9 April and kodi does not crash. It stores the files (subs) as expected. It even PLAYS the video file normally (you can see that the greek subtitles do exist in subs settings as Greek Modern 1453 file) but – as it is not its purpose – subtitles are not superimposed in video.
            I know it s a different plugin from this ( but in your plugin’s subs settings i can see the greek subs (which they supposed to be image subs like japanese) while in asciidisco’s NOT!. That means that you may have the answer for the lack of greek/hebrew/japanese subs for his plugin…

    1. Wait! Now i found the way how this working! First i change my download folder! Then i just click to a video and of curse no need to play! If you click to the video then automaticaly download your correct language for subtitlte!

        1. If you selected a specific language in the settings, then its possible that language is not available for you, and nothing will be downloaded. If you don’t select any language in the settings, then it will get every language that is available to you.

          Since you said it was working before, I suspect that you are just trying to get a language that you can’t get for a certain show.

  14. I’m getting an error with the dependency script.module.pyrcryptodrome version.

    I cant get a capture of the full version but i tried ti pip install pycryptodrome and it still didnt work. Any suggestions?

      1. CAddonInstaller: installing from zip ‘/Users/ybfe1853/Downloads/’
        00:37:51.237 T:123145303453696 DEBUG: CAddonInstallJob[]: requires script.module.pycryptodome version 3.4.3 which is not available
        00:37:51.237 T:123145303453696 ERROR: CAddonInstallJob[]: The dependency on script.module.pycryptodome version 3.4.3 could not be satisfied.

        1. I reviewed the list of dependencies for netflix, and I do see there is a dependency for pycryptodomex which appears to be a modified version of pycryptodome. So you can try pip install pycryptodomex

          I’m curious why the dependencies wouldn’t automatically be fullfilled, as I have never had to manually install anything like that. Did you make sure you are using kodi 18 rather than 17? And what OS are you on?

          1. It works now, turns out I was using the wrong version… silly me. However Now I am having another problem. The subtittles downloaded properly a few nights ago, but now clicking a video won’t download anything.

            I found this snippet in the log:
            19:02:47.044 T:10608 NOTICE: VideoPlayer::OpenFile: [url removed due to causing formating issues]
            19:02:47.044 T:12788 NOTICE: Creating InputStream
            19:02:47.678 T:12788 ERROR: AddOnLog: InputStream Adaptive: Could not open / parse mpdURL (http://localhost:61990/manifest?id=80174933)
            19:02:47.678 T:12788 ERROR: CVideoPlayer::OpenInputStream - error opening [url removed due to causing formating issues]
            19:02:47.678 T:12788 NOTICE: CVideoPlayer::OnExit()

          2. After taking a look at the code i noticed that the mpdURL that the play_item function in is trying to put together:

            returns a page with a status error code of 400 stating that the document is empty….
            not sure if you’ve seen that before or know what it means.

          3. Ended up uninstalling Kodi and going with an earlier build (March-24th), works like a charm now. Awesome plugin!

          4. Thanks for all of your feedback. I’ll do some further testing to try and isolate where the problem was introduced, so that it can either be fixed, or at least to let people know what versions they can to use.

  15. One thing I care about more. I don’t know if it’s a kodi client’s problem. Long-term works only show up to 42 episodes.

        1. Thanks, I checked into it and it looks like this is a known problem in the Netflix plugin for Kodi. Once the bug is fixed by them, I will release a fixed version of my plugin. It has been posted on their issue tracker since february, so I don’t know when it will be fixed.

  16. Can we carry the Arabic translation by adding a Netflix to the Cody program?

    If the answer is no.

    Can you modify the addition to download the Arabic language translation

    1. I’m having some difficulty to understand your question. You are asking about a translation for the interface of this plugin? Or about how to download arabic subtitles? Or how to play back video with arabic subtitles?

        1. Netflix decides what subtitles you can download based on your location.
          If you are inside a country that uses Arabic, then you should be able to download the Arabic subtitles. But if you live in a country where the primary writing is not Arabic, then the arabic subtitles will not be available.
          If you can’t see arabic subtitles, you might be able to use a VPN from an arabic location, and the subtitles will become available.

    1. Fixed my own problem. The bug—which may be Mac-specific if this didn’t happen for you on Windows; I’m on macOS Sierra—is in, on Lines 50 and 52. (/Users/$USER/Library/Application Support/Kodi/addons/

      With `os.makedirs(‘Subtitles’)`, Kodi was trying to create a “Subtitles” directory where it didn’t have permission to do so. So that, and the corresponding `os.path.isdir(‘Subtitles’)` had to be changed to a different location. In my case I changed them to point to `’/Users/$USER/Downloads/Subtitles’` (replace $USER with your username). Saved, restarted Kodi, the error went away and I was finally able to log in.

      1. Thanks for your feedback, its a big help!
        I’ll see if I can’t learn how to implement the file handling in a more cross-platform manner.

      2. I’ve released a new version of the plugin that lets you properly select where you want to save the files from within the plugin settings menu. This should make it work across all systems. Thanks for letting me know about this issue!

  17. When I tried this on March 22, it worked perfectly. However, when I tried to do it today, I could not download any of the subtitles. Nothing was appearing in the Subtitles folder anymore. Has this happened to anyone else? I tried over 15 different series and nothing.

    1. It’s still working for me. Is the file “Subtitle_urls.txt” in your Kodi folder getting updated when you try to download anything? Did you try to modify the file to change any settings?
      You may need to try completely uninstalling Kodi (or maybe just the netflix plugin) and set it back up again.

      Are you trying to get a specific language, and what are a couple of the show titles you were trying?

      1. I actually reinstalled kodi after doing a permanent uninstall (kodi 18) and re-followed the instructions to install the netflix plugin. It still didn’t work lol. One thing I noticed was that the “Subtitle_urls.txt” is no longer there after the reinstall.
        I did not modify the file.
        For the language I’m do Japanese (set skin font to Arial based because my Netflix language is in Japanese). Some titles I’ve been trying to download are: Attack on Titan, Ghost in the Shell, B: The Beginning, Erased (live action).
        I’m also using a VPN to get Japanese Netflix, though I don’t think that’s the problem as I had no issues a week ago.

        1. One other thing you can test out. Browse to your userdata folder:

          From there, go into the addon_data folder, then the service.msl folder, and locate a file called manifest.json.

          This file gets replaced each time you try to load a video in the netflix plugin. Open it up in a text editor to view the contents.

          Whenever I try using an unsupported proxy server, this file will end up containing an error message saying that I can’t access netflix through that proxy. But when things are working normally, I find a really long line of text containing some key words such as “viewables”, “videoenctrypted”, “texttracks”, “downloadables”, and so on, as well as some really long URLs.

          Perhaps this can give some insight into whats going on.

          1. I took a look but there weren’t any errors in that file. It was like you said with the long line of text. Thanks for helping me troubleshoot, hopefully I can figure it out sometime.

    1. Hmmm, this is interesting. I’m not really sure why the arabic subtitles aren’t coming up now. I didn’t really change anything from the original AhmedBakfir code that should cause them to NOT show up. In fact I even tried reverting to that original code now, and I still don’t see them, even if I set my netflix to arabic.

      1. I already downloaded arabic subs with your script , but there is a a wierd thing
        the download only work in first time after installing kodi+script, closing kodi and opening it
        it won’t start downloading

        1. Looking at your log, it appears that it is failing before it even gets to any of my modified code, so I think it might be an issue in the netflix plugin itself. It’s really strange that it works at first, but then wont work any more when you restart kodi.

          After you exit kodi, have you checked the task manager to make sure that the kodi process is completely stopped? What happens if you reboot your pc and then try again?

          1. I installed the latest build of kodi 18 ,It works very well and twaeking the setting works also
            thank you

  18. This is amazing!
    I gave up on the OCR method and was thinking there no hopes of extracting netflix subs anymore. Then bam! This page popped up, I was blind not seeing this page first LOL This method is so fast to get subs on netflix~
    Thank you so much for your hard work ^^

  19. Great news!!!
    The whole process it’s not too cumbersome for me using the original tool, except when using a VPN to watch Japanese Netflix (it can take ages depending of how many episodes there are). So I would be eagerly waiting for the VPN workaround 🙂

    1. Just to let you know, it is working with VPNs. Turns out the one I was originally testing it on didn’t actually work with Netflix. Once I found one that actually works, there were no problems.

Leave a Reply

Your email address will not be published. Required fields are marked *