SMB: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
mNo edit summary
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{mininav| [[Media sources]] | [[File sharing]] }}
{{mininav| [[File sharing]] }}
<section begin="intro"/>Windows File Sharing, (also known as Common Internet File System [CIFS] or Server Message Block [SMB]), is probably the most common of all of the options for sharing media between your computer or a [[NAS|NAS (Network Attached Storage)]] device and Kodi.<section end="intro"/>


* On Mac OS X it's called '''Windows Sharing'''.
__TOC__
* On [[samba|Linux/UNIX/BSD]] its counterpart is [http://www.samba.org SAMBA].


== Setting up an SMB Server ==
<big>
* '''[[SMB/Windows]] -'''</big> Setting up SMB on Windows


= Introduction =
<section begin="intro"/>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.<section end="intro"/>


<big>
'''Note:''' SMB v1 is not supported in {{kodi}}. SMB v2 or higher must be used.
* '''[[SMB/Mac]] -'''</big> Setting up SMB on Mac OS X


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.


<big>
* Android : [https://www.howtogeek.com/191378/how-to-access-shared-windows-folders-on-android-ipad-and-iphone/ How-To Geek]
* '''[[Samba]] -'''</big> Setting up SMB in Linux
* Linux : [http://www.samba.org SAMBA].
* Mac : [https://support.apple.com/en-au/guide/mac-help/mh17131/10.15 macOS User Guide site]
* Windows : [https://forum.kodi.tv/showthread.php?tid=362113 Forum step-by-step guide]


== Adding an SMB media source ==


<big>
= Methods =
* '''[[Adding video sources#Adding Remote sources|Adding remote video sources]] -'''</big> Adding an SMB share as a source
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, the first method being the simplest.


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


== External links ==
* [http://www.mini-itx.com/projects/xbmc-ion/module/7 How to enable Windows File-Sharing on your Kodi Live system (mini-itx.com)]


{{Isengard updated}}


== 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 '''[[w:WS-Discovery|WS-Discovery protocol]]''' was implemented to allow browsing SMB shares again. <ref>https://github.com/xbmc/xbmc/pull/19499</ref> <ref>https://github.com/xbmc/xbmc/pull/19532</ref>
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)''' from the '''Browse for new shares''' list, then browse to the required '''[[Source_folder|Source folder]]'''.
<gallery mode="packed" widths="500px" heights="283px">
File:Add-Network-Location.png |Image 1- Select '''Windows network (SMB)''' from the '''Browse for new shares''' list.
File:Add-Network-Location_7.jpg|Image 2- Continue to drill down until the required Source folder is located, then select '''OK'''.
</gallery>
== 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 4 (IP Address) or Step 5 (Device Name), not both
<gallery mode="packed" widths="500px" heights="283px">
File:Add-Network-Location.png |Image 1- Select '''Add network location...''' from the '''Browse for new shares''' list.
File:Add-Network-Location_2.png|Image 2- Select '''Windows network (SMB)''' for '''Protocol'''.<br>Then select '''Server Name'''.
File:Add-Network-Location_3.png|Image 3- Type in either the '''IP Address''' or the '''Device name''' of your server.
File:Add-Network-Location_4.png|Image 4- Using '''IP Address'''<br> '''4.1''' Browse is not supported. <br> '''4.2''' In the '''Shared folder''' section, type in the name of the folder to add.<br> Add the drive letter ''eg f/Movies''.<br>'''4.3''' If your share requires a '''Username''' and '''Password''' enter them in the appropriate sections.<br>'''4.4''' Select '''OK'''
File:Add-Network-Location_5.jpg|Image 5- Using '''Device Name'''<br>'''5.1''' Browse is not supported. <br> '''5.2''' In the '''Shared folder''' section, type in the name of the folder to add <br>The drive letter is not required.<br>'''5.3''' If your share requires a '''Username''' and '''Password''' enter them in the appropriate sections.<br>'''5.4''' Select '''OK'''
File:Add-Network-Location_6.jpg|Image 6- Your share should appear in the '''Browse for new share''' list. <br>The share will show either the IP Address or Device Name depending on which method you used.
</gallery>
= References =
<references />
{{top}}
{{updated|19}}
[[Category:Karellen]]
[[Category:File sharing]]
[[Category:File sharing]]
[[Category:Manual]]
[[Category:Index]]

Revision as of 07:27, 20 October 2021

Home icon grey.png   ▶ File sharing ▶ SMB


Introduction

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.


Methods

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, the first 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) from the Browse for new shares list, 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 4 (IP Address) or Step 5 (Device Name), not both


References



Return to top