From Official Kodi Wiki
Jump to navigation Jump to search
Home icon grey.png   ▶ File sharing ▶ SMB


Windows File Sharing, aka Server Message Block (SMB), is the standard client-server protocol used by Windows to share resources over a local network. SMB is available on all Windows computers and can be easily setup by the home user. SMB can also be accessed by other operating systems, which makes SMB the most commonly used network protocol to access content on a NAS or other remote hardware.

Note: SMB v1 is not supported in Kodi. SMB v2 or higher must be used.

This page will detail how to add a network source to Kodi using SMB. It assumes you have already correctly set up your SMB network.|If you have not set up your SMB network, a Google search will return numerous online guides. The following links may help also.


Check Settings ► Services ► SMB Client page for SMB related settings in Kodi.


Once SMB is implemented and the Source folders containing your media have been given Read/Write permission the Source folder(s) can be added to Kodi

Two methods are available- Windows Network (SMB) and Add Network Location detailed below. Windows Network (SMB) method being the simplest.

From the Browse for new share window (image 1 in both sections), select one of the following methods:

Windows Network (SMB)

When SMB v1 was deprecated by Microsoft due to security reasons, it was no longer possible to browse SMB shares. Instead it required you to add the specific IP Address or Device Name followed by the path to access shares. (detailed in the next section)

As of Kodi v19.1, the WS-Discovery protocol was implemented to allow browsing SMB shares again. [1] [2]

WS-Discovery is enabled by default on all Windows 10 installations and is well supported from Windows 7.

To add a share using this method, select Windows network (SMB) (image 1) from the Browse for new shares page, then browse to the required Source folder.

Add Network Location

If the previous method is not available to you, then Shares can still be manually added using either the IP Address or Device Name method.

IP address
If using the IP Address method, ensure you reserve a DHCP address (static IP) for your NAS or other hardware. This ensures that your router will always allocate the same IP address to the server. If you choose not to do this, then you may find that the router has allocated a different address to your NAS and Kodi will no longer be able to access the media files.
To reserve a static IP address, log into your router and add the MAC address of the hardware to the Reservation list in your Router. If you do not know the MAC address, you should see it in the list of connected clients.
Device Name
If using Windows PC's you can use the Device Name of the PC.
The Device Name can be found in your Windows PC under Settings > System > About.

Note: Choose either Step 4a (IP Address) or Step 4b (Device Name), not both


Return to top