SMB: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{mininav| [[File sharing]] }}
{{mininav| [[File sharing]] }}
{|class="infobox" style="width:210px"
 
|-
|
Return to:
* '''[[HOW-TO:Create_Music_Library|Music Library Guide]]'''
* '''[[HOW-TO:Create_Video_Library|Video Library Guide]]'''
|}
__TOC__
__TOC__


= Introduction =
= 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 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"/>
<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"/>


'''Note:''' SMB v1 is not supported in {{kodi}}. SMB v2 or higher must be used.
'''Note:''' SMB v1 is not supported in {{kodi}}. SMB v2 or higher must be used.
Line 19: Line 14:
* Linux : [http://www.samba.org SAMBA].
* Linux : [http://www.samba.org SAMBA].
* Mac : [https://support.apple.com/en-au/guide/mac-help/mh17131/10.15 macOS User Guide site]
* Mac : [https://support.apple.com/en-au/guide/mac-help/mh17131/10.15 macOS User Guide site]
* Windows : Multiple guides available via Google.
* Windows : [https://forum.kodi.tv/showthread.php?tid=362113 Forum step-by-step guide]
 
 
= 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 '''[[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.


= Method =
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]]'''.
SMB (remote or network) server locations can be accessed with either of the following methods:
 
<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
; IP address
Line 34: Line 53:
: If using Windows PC's you can use the Device Name of the PC.
: If using Windows PC's you can use the Device Name of the PC.


: The Device Name can be found in ''Settings > System > About'' on your Windows PC.
: The Device Name can be found in your Windows PC under ''Settings > System > About''.
 




= Adding Remote Sources =
'''Note: '''Choose either Step 4 (IP Address) or Step 5 (Device Name), not both
The images will guide you through the process of adding an SMB Source to {{kodi}}.
 
'''Note''': SMB v2 and later does not support Browse. You must type the folder name in steps 4.2 and 5.2 below.
 


<gallery mode="packed" widths="500px" heights="283px">
<gallery mode="packed" widths="500px" heights="283px">
Line 49: Line 63:
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_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_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.5''' 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_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.
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>
</gallery>
= References =
<references />




Line 57: Line 77:


{{top}}
{{top}}
{{updated|19}}


{{updated|18}}
[[Category:Karellen]]
[[Category:Karellen]]
[[Category:File sharing]]
[[Category:File sharing]]

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.

  • Image 1- Select Windows network (SMB) from the Browse for new shares list.

    Image 1- Select Windows network (SMB) from the Browse for new shares list.

  • Image 2- Continue to drill down until the required Source folder is located, then select OK.

    Image 2- Continue to drill down until the required Source folder is located, then select OK.


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

  • Image 1- Select Add network location... from the Browse for new shares list.

    Image 1- Select Add network location... from the Browse for new shares list.

  • Image 2- Select Windows network (SMB) for Protocol. Then select Server Name.

    Image 2- Select Windows network (SMB) for Protocol.
    Then select Server Name.

  • Image 3- Type in either the IP Address or the Device name of your server.

    Image 3- Type in either the IP Address or the Device name of your server.

  • Image 4- Using IP Address 4.1 Browse is not supported. 4.2 In the Shared folder section, type in the name of the folder to add. Add the drive letter eg f/Movies. 4.3 If your share requires a Username and Password enter them in the appropriate sections. 4.4 Select OK

    Image 4- Using IP Address
    4.1 Browse is not supported.
    4.2 In the Shared folder section, type in the name of the folder to add.
    Add the drive letter eg f/Movies.
    4.3 If your share requires a Username and Password enter them in the appropriate sections.
    4.4 Select OK

  • Image 5- Using Device Name 5.1 Browse is not supported. 5.2 In the Shared folder section, type in the name of the folder to add The drive letter is not required. 5.3 If your share requires a Username and Password enter them in the appropriate sections. 5.4 Select OK

    Image 5- Using Device Name
    5.1 Browse is not supported.
    5.2 In the Shared folder section, type in the name of the folder to add
    The drive letter is not required.
    5.3 If your share requires a Username and Password enter them in the appropriate sections.
    5.4 Select OK

  • Image 6- Your share should appear in the Browse for new share list. The share will show either the IP Address or Device Name depending on which method you used.

    Image 6- Your share should appear in the Browse for new share list.
    The share will show either the IP Address or Device Name depending on which method you used.


References

  1. ↑ https://github.com/xbmc/xbmc/pull/19499
  2. ↑ https://github.com/xbmc/xbmc/pull/19532



Return to top
Retrieved from "https://kodi.wiki/index.php?title=SMB&oldid=236434"