The Netflix Kodi add-on offers a convenient way to access Netflix’s extensive catalog of movies and TV shows directly on Kodi. Please note that this add-on requires a Netflix account.
Netflix add-on is not officially developed by Netflix itself, but it offers a lot of great features like access to multiple profiles, recommendations, library integration, watched status synchronization, high-resolution playback (on supported devices), Up Next add-on integration to play episodes continuously, and more.
In this guide, we’re going to install the unofficial Netflix add-on on Kodi. Let’s begin.
If this is the first time you install add-ons on Kodi, you’ll have to allow the installation of unofficial add-ons. Please read How to allow 3rd-party add-ons on Kodi and come back here when you’re ready.
Installing CastagnaIT repository
Let’s add a link to the add-on’s official source on CastagnaIT’s GitHub page. This allows us to download and install the repository zip file directly on Kodi.
1. Press the cog icon near the top left corner of the Home Screen.
2. Select File Manager.
3. Press Add Source.
4. Enter https://castagnait.github.io/repository.castagnait/ on the top box and repository.castagnait on the bottom one. Press OK to add the source.
Now that we’ve added the link to the source, let’s use it to install the repository.
5. Go back to the Settings menu and select Add-ons.
6. Press Install from zip file.
On Kodi 19, you’ll see a message about the auto-update feature. Press Yes to proceed.
7. Select repository.castagnait.
8. Click the file repository.castagnait-x.x.x.zip to download and install the repository.
Installing Netflix add-on on Kodi
Now that the repository is installed, let’s use it to install Netflix and its dependencies.
9. Select Install from repository.
10. Click on CastagnaIT Repository to open the repository.
11. Select Video add-ons.
12. Now Select Netflix.
13. Press the Install button.
14. Press OK and to install the add-on and its dependencies.
Wait a couple of seconds while the add-on is being downloaded, you’ll see a notification when the installation process is done.
15. Go back to the Home Screen, highlight the Add-ons tab, and select Netflix to open the add-on.
On some Linux distributions, you must install a couple of additional libraries. On the other hand, if you’re using Windows, macOS, Android, LibreElec, CoreElec, or Ubuntu, those libraries are already installed.
We have installed Netflix on Kodi, but we still need to set up a user account.
Setting up your Netflix account
Opening the add-on for the first time will launch the setup wizard.
16. Netflix requires the InputStream Adaptive add-on, you’ll be prompted to install it now. Press Yes to continue.
17. You must enter your Netflix credentials, select E-Mail/Password.
18. Type your email.
19. Now enter your password.
Log in problems and Authentication Key method
Sometimes, Netflix’s anti-bot feature can cause log-in errors when using the addon. If you get the “Incorrect Password” message, even after you entered the right credentials, you’ll have to use the Authentication Key method.
To use this method, you must download and run a small script on your computer. The script will open a web browser and it’ll ask you to log into Netflix so it can capture the authentication key on a file and also a 4-digit PIN.
You’ll have to use the generated file, 4-digit PIN, and password to log into Netflix. Don’t worry, you only need to do this once. Go to the add-on’s wiki on GitHub to download the script and follow the instructions.
Some antivirus may falsely identify the script as malware, you can read more about it here.
Using the Netflix add-on with Kodi
Now we are ready to use the add-on.
20. Select a profile.
21. Use the addon’s main menu to navigate the categories and choose a movie or show.
Netflix uses a special encryption protocol to play 1080p and 4K videos, if your device supports this protocol you’ll be prompted to install the Widevine CDM add-on and you’ll be able to watch high-resolution videos. Some Android boxes are not Widevine certified and will only play 540p videos.
Playing HD videos on Netflix
Netflix requires a Widevine L3 certified device to play 4K videos, if your device is certified, you can already play videos on the highest quality. Check the List of known Android devices for 1080p and 4K playback to see if your device is compatible.
Devices without a Widevine L3 certification are either restricted to 540p videos or no video will play at all, returning the message “Sorry, your account can’t be used on this device”.
Some Android devices are Widevine L1 certified and can play up to 1080p video from Netflix, but they are still restricted to 540p. If your device is marked as “Google Certified”, chances are you’ll be able to play Netflix on HD. It seems like Widevine L1 devices can no longer play 1080p videos due to Netflix’s new restrictions.
Editing your device’s serial number (ESN) might unlock video playback at 540p on some devices. Follow these steps to edit your ESN:
I. Highlight the add-on (do not press it), open the Context Menu, and select Settings. (Long-press or use the C key to open the Context Menu)
II. Go to the Expert tab, scroll down to the Advanced Add-on Configuration section and press ESN / Widevine settings.
III. Press Change ESN and edit it following the instructions below, then press Apply changes now to save the new ESN.
– Devices with Widevine L1 certification
Edit your ESN according to these instructions:
An ESN has the following structure:
Prefix – Group – Device Model – System ID –
The ESN on your device may look like these examples:
Change the prefix to NFANDROID1 and the group to PRV-0, our examples will end up looking like this:
After editing your ESN, press the Apply changes now button and try to play a video. This used to unlock 1080p playback on most Widevine L1 certified devices, video quality seems to be restricted to 540p now.
– Devices without Widevine certification
Enable either the Force L3 or Force L3 (ID 4445), press the Apply changes now and try to play a video. This method might help to get rid of error messages like “Your account can’t be used on this device”, “The title is not available to watch instantly” or “Request blacklisted by exchange service”.
Keep in mind that playing videos on unsupported devices is getting increasingly difficult, forcing L3 may enable playback, but it is not guaranteed to work on every device.
Alternatives to Netflix add-on
Looking for more add-ons? These are some of our favorite Kodi add-ons for June 2023.
Please visit our list of the best Kodi add-ons for more information.
|Fen: This add-on is very fast and offers many features. (Premium sources)|
|Umbrella: Great add-on based on Venom. (Premium sources)|
|Seren: Excellent add-on with great user interface and many innovative functions. (Premium sources)|
|Elementum: An exceptional add-on that offers high-quality streams using torrents. (Free sources)|
|Scrubs v2: Great add-on specialized in free sources. (Free sources)|
|The Crew: Great all-in-one add-on with many extra features for kids, sports, live TV, and more. (Free and premium sources)|
22 thoughts on “How to install Netflix Kodi add-on ”
There is a repository not found error. How do I fix this?
How to use subtitles
Apparently this only works with 32-bit?
I wish I had known that before I went through all those steps.
Thanks for your help.
I have andriod 7 box with kodi 19.3 running. Unfortunately I get this message on opening
… The add on encountered the following error the background service cannot be started due to this problem. It was not possible to get the data from wildevine cryptosession
Your system is not widevine certified or you have wrong kodi version installed.
I really appreciate your help.
Anyone else recently find that their Netflix is no longer 1080p, just reverted to 540p? Any solution for how to get HD back? Not sure what’s caused the change. I’ve tried a total uninstall and reinstall. Am on a Xgimi Mogo Pro Android projector. Had been perfect until now. Thanks
Hi. I’ve noticed the image is grainy. Are there any settings to make the picture clear?
i hawe a problem with playback. I’ll sign in. I will select a profile. Then I want to choose a movie and then it will write you a mistake when starting.
How can I fix this, please?
THANK YOU ver much, it worked flawlwessly
Hello, thanks for your supports.
I have a problem with vu ultra 4k enigma2 arm basis receiver. I established netflix but I can not received any sound. I thing we need codecs for sounds.
How can I do for sounds-voice?
I got an error. Something about a background service needed some module.
“Error details: No module named Crypto”
So I guess you folks are advertising crypto mining add-ons… Well done…
Can you share your log file? Keep in mind that crypto doesn’t necessarily means cryptocurrency. Apparently the addon uses the https://pypi.org/project/pycrypto/ library and pycriptodomex as a dependency. Both are not related to cryptocurrency.
Also, you’re not gonna get too far with that attitude…
hello, I have same problem,.
this is part of log
File “/home/hoobs/.kodi/addons/plugin.video.netflix/resources/lib/services/msl/msl_request_builder.py”, line 32, in __init__
from .default_crypto import DefaultMSLCrypto as MSLCrypto
File “”, line 25, in
from Crypto.Random import get_random_bytes
ImportError: No module named Crypto.Random
this line makes problem
from .default_crypto import DefaultMSLCrypto as MSLCrypto
(selection for other than android OS)
Are you by any chance running Kodi on a Raspberry Pi? You need to manually install a couple of python libraries on some Linux distros for the addon to work.
First, install pip, the python package manager.
sudo apt install build-essential python-pip python-dev libffi-dev libssl-dev libnss3
Then, use pip to install the required libraries.
sudo pip install setuptools wheel pycryptodomex
Hi everybody, I got a problem on my Zidoo Z9X.
Everything is ok but when I try to watch something I have an error message:
“MSLERROR: this title is not available to watch instantly. Please try another title.
To try to solve this problem you can force “Widevine L3″ from the add-on Expert Settings”
Me 2, pls help, thanks
Hi! I’ve updated the article. Please check the Troubleshooting section to solve the title not available problem.
I for the life nitflilex
This feels like a christmas present. Thank you very much.
Worked perfectly – Thanks!
Perfect how-to, thanks a lot for this tutorial!