Official Kodi Wiki - User contributions [en]

Naming video files/Movies

2019-09-17T22:47:12Z

Ntgdeveloper: /* Movie Folder */

{{VideoLibraryCreate}}
{{mininav|[[Video library]]|[[Naming video files]]}}

= Introduction =
<section begin="intro" />This page will describe the '''{{Kodi}} best practice''' to name Movie files and create the folder structure to save them in. Your movie folder and files will be placed within your Source folder.<section end="intro" />

The default scraper used by {{kodi}} for '''Movies''' is the TheMovieDB (TMDB). Other scrapers are available and can be found by searching the {{kodi}} site '''''[https://kodi.tv/addons/browse?keyword=&category=1185&author=&sort=title+ASC here]'''''
:'''''See: [https://www.themoviedb.org/ TheMovieDB]'''''
:'''''See: [[Add-on:The_Movie_Database|TheMovieDB Add-on]]'''''
:'''''See: [[Add-on:Universal_Movie_Scraper|Universal Movie Scraper Add-on]]'''''
{{-}}

= Folder & Naming Conventions =
Once the Source has been created on your drive, there are are two options on how to store your movies.

== Movie Folder ==
This is the '''{{Kodi}} best practice''' method for naming and storing movie media. See the two images below.

*Placing movies in their own folder allows saving of local artwork and info files alongside the movie file.
*You have the choice of using the Short or Long name format for the artwork
*Using this method will provide the safest and most accurate scrape of your media collection.
*If using VIDEO_TS or BDMV folder structure you must enable '''Recursive''' lookup when adding the source directory.

<gallery mode="packed-overlay" widths="600px" heights="350px">
File:Video-Movie Folder File Structure.png|Image 1- Folder structure
File:MovieNaming02.jpg|Image 2- Movie Names
</gallery>

'''Notes:'''
*There is some limited flexibility to correct naming, but not all methods are 100% guaranteed to work.
*Some skins use modified file-naming to display '''''[[Media_flags|Media Flags]]'''''. These apply to the filename, not the folder name. Check the forum of your skin for correct use.

'''Naming'''
*The name used for the folder and video file is the movie name as displayed at TheMovieDB (we are using default TheMovieDB scraper).
*The second image above is a screenshot of the ''Blade Runner 2049'' movie entry at TheMovieDatabase site. The name of the movie folder and video file should match the name displayed at the scraper site, as shown in the two images above.

'''Folder'''
*Inside the Source folder, create a folder named with the movie title
*Movie '''Folder''' names must contain the '''Title''' and should contain the '''Year'''. Although not a strict requirement, the year should be in open/close parenthesis (the '''(''' and ''')''' characters, respectively).

'''File'''
*Within the new movie folder, save the video file
*The setting '''Movies are in separate folders that match the movie title''' which is located in the Set Content settings page of the Source has the following effect:
**If '''Enabled''' {{Kodi}} will use the '''folder''' name to scrape the movie
**If '''Disabled''' {{kodi}} will use the '''filename''' to scrape the movie
*In light of the above, and because many users are unaware or forget this setting, {{Kodi}} recommends naming the movie file the same as the folder name as shown in the example image above
*The '''filename''' can be modified to include '''''[[Media_flags|Media Flags]]'''''

== Filename Only ==
[[File:Video-Movie File Structure.png|400px|right]]

An alternate method of storing your movies is to save all the movie files inside the Source folder and omit the Movie folder. Also known as a '''flat folder''' structure. See image to right.

This method requires that the movie file is named correctly as Kodi is forced to use the movie '''filename''' to match the entry at the scraper site.

The movie filename must contain the '''Title''' and should contain the '''Year'''. Although not a strict requirement, the year should be in parenthesis. It should match the entry at the scraper site as shown in the above images.

There are disadvantages using this method:
*With larger libraries, this method can become untidy and cumbersome to maintain
*If you use nfo files and save local artwork, the folder will become even more cluttered
*Some Artwork add-ons will not work with this method as they require a Movie Folder
*Saving locally stored Artwork will be problematic.
*The option '''Movies are in separate folders that match the movie title''' in the Set Content settings page of the Source does not apply to this method.
{{-}}

== Extra Video Files ==
It is not uncommon to have extra video files that are somehow related to the main movie. Clips such as bloopers, interviews with cast and crew, production methods, behind the scenes, etc.

{{Kodi}} will see all these additional video files saved inside the movie folder and attempt to scrape them, which will cause incorrect and unwanted multiple entries in the library. How {{kodi}} actually treats these will depend upon which settings are enabled and which folder structure and naming convention is in use.

To safely store extra video files along with your movie, and have them accessible within {{kodi}}, you will need to install the '''Extras''' add-on. Follow the instructions in the link below to create the correct folder structure. This add-on will only work with Movie Folders.

'''Requires the use of Movie Folders'''
:{{see|Extras}}

----
'''{{big|{{red|The remainder of this page deals with Special Use cases and can be safely ignored. Most libraries will not require implementing the following additional name extensions.}}}}'''
----

<div style="{{linear-gradient|left|#a1f5e4, #f5f5a1}}">{{next|[[Naming_video_files/TV_shows|'''Naming TV Shows''']]}} </div>

= Stub and Stream Files =
{{main|Media_stubs}}
{{#lst:Media_stubs|intro}}

{{main|Internet_video_and_audio_streams}}
{{#lst:Internet_video_and_audio_streams|intro}}

= Media Tags / Flags =
{{main|Media flags}}

[[File:480.png|50px]] [[File:1080.png|50px]] [[File:720.png|50px]] [[File:1080 n.png|50px]] [[File:480-1.png|50px]]
[[File:Divx.png|80px]] [[File:Xvid.png|80px]] [[File:H264.png|80px]] [[File:Bluray.png|80px]] [[File:Dvd.png|80px]] [[File:Avc1.png|80px]]
[[File:1.33.png|50px]] [[File:1.66.png|50px]] [[File:2.20.png|50px]] [[File:2.35.png|50px]]

Media flags are icons in Kodi that displays the meta-information from the media file of a movie, TV show or music title. They are skin specific, and what works in one skin, may not work in another skin. It is always best to check with the skin sub-forum which flags and tags are used.

'''It is important to note that the skin will display these flags even when these extensions are not used.''' The only difference being that without the extensions, the movie must be played first in order for {{kodi}} to read the audio and video codec data.

'''The actual audio and video codec data will override any extension used.''' This means that if you set the extension of, say, '''.ATMOS''' but the video file only has a stereo track, then the '''.ATMOS''' flag will be removed.

Example- note that movie folders are used, and the folder is simply named while the filename has been modified with extensions.
{| class="prettytable"
|-
! scope="row" ! style="width:400px; background-color:#ffffcc; text-align:left;"| ...\Paul (2011)\Paul (2011).4K.HDR.Atmos.mkv
|}

== 3D movies ==
{{Main|3D}}
Some 3D movies might need an additional file name extension to be identified by Kodi as a 3D movie. See '''[[3D]]''' for details on that additional extension, and when it is needed.

= Split Video Files =
{{Notice|File Stacking for ISO files, Bluray and DVD folders is currently broken and cannot be used. See report [https://github.com/xbmc/xbmc/issues/16109 Issue: 16109]}}

Also known as File Stacking, allows you to combine multiple movie files so they appear and play as the one movie. No longer a common requirement, but still available in {{kodi}} should it be needed.

An example of this use is the Special Extended DVD Edition of ''The Lord of the Rings- The Fellowship of the Ring''. Due to the length of the movie, the movie was split and released on two DVD's requiring a DVD change half way through the movie. This means that when storing this movie, the rip creates two separate movie files. When watching the movie, there will be an interruption when the first part ends and the second part needs to be selected to play.

Two options to overcome this issue:
#Combine both movie files into a single movie file.
#Leave them as Split Video Files, but allow Kodi to combine them into the one library entry (kodi does not combine the actual movie files)

To use this function the following steps are required:
#The setting '''Combine split video items''' must be enabled in the Settings menu. '''''See: [[Settings/Media/Videos#Files|Settings>Media>Files]]'''''
#Modify the movie file names, as described below, so that Kodi recognises them as Split Video Files
#Can only be used with the '''Movie Folder & Filename''' method described above

The default expressions will NOT stack files which use only a number without the extensions stated below (eg movie1.avi, movie2.avi). This is intentional due to false positives which can occur with sequels, eg Die Hard 1, Die Hard 2, Die Hard 3, etc.

== Movie Files ==
'''These are for multi-part video files in the same Movie folder.''' eg *.mkv, *.mp4, *.avi etc

The following are default stacking extensions that can be added to file names.
[[File:Video-Movie FolderStacking.png|600px|right]]

{| class="prettytable"
|-
! colspan="7" style="background-color:#ffffcc;" | # = 1 thru 9 OR A thru D. No space.
|-
! scope="row" ! style="width:100px; text-align:left;"| Default Stacking Extensions
|style="width:50px; text-align:left;"|part#
|style="width:50px; text-align:left;"|cd#
|style="width:50px; text-align:left;"|dvd#
|style="width:50px; text-align:left;"|pt#
|style="width:50px; text-align:left;"|disk#
|style="width:50px; text-align:left;"|disc#
|-
! colspan="7" style="background-color:#ffffcc;" | # = A thru D. No space.
|-
! scope="row" ! style="width:100px; text-align:left;"| Default Stacking Extensions
| colspan="7" |moviename'''#'''.ext<br />
eg.<br />
e:\Movies 1\Lucy (2014)A.mkv<br />
e:\Movies 1\Lucy (2014)B.mkv
|}

== DVD & BluRay Folders ==
If you have preserved the DVD or Bluray folder structure, then use this method for folder stacking.

{| class="prettytable"
|-
! colspan="5" style="background-color:#ffffcc;" | # = 1 thru 9. No space.
|-
! scope="row" ! style="width:100px; text-align:left;"| Default Stacking Extensions
|style="width:50px; text-align:left;"|cd#
|style="width:50px; text-align:left;"|dvd#
|style="width:50px; text-align:left;"|disk#
|style="width:50px; text-align:left;"|disc#
|}

== Advanced Stacking Options ==
File stacking can be fine-tuned by the user to match obscure cases using the '''[[Advancedsettings.xml#moviestacking|<moviestacking>]]''' and '''[[Advancedsettings.xml#folderstacking|<folderstacking>]]''' advancedsettings.xml settings.

{{top}}

<div style="{{linear-gradient|left|#a1f5e4, #f5f5a1}}">{{next|[[Naming_video_files/TV_shows|'''Naming TV Shows''']]}} </div>

{{updated|18}}
[[Category:FAQ]]
[[Category:Index]]
[[Category:How-to]]
[[Category:Guides]]
[[Category:Manual]]
[[Category:Karellen]]
[[Category:Video library]]
[[Category:General topics]]
[[Category:First time user]]
[[Category:Quick Start Guide]]

HOW-TO:Install Kodi for Windows

2019-05-16T15:14:36Z

Ntgdeveloper: /* Windows Store */

{{mininav| [[Windows]] }}
[[File:Windows_10_Logo_svg.png|300px|right]]
[[File:windows-8-logo.png|150px|right]]
[[File:Windows_7_logo.png|150px|right]]

__TOC__

= Installing Kodi =

The installation of Kodi for Windows is performed in the same manner as most other windows applications.

The Download page is located here... [http://kodi.tv/download/849 http://kodi.tv/download/]

A number of download options are available, each detailed as follows:

== Release or Stable ==
The Release version is the most current and stable version of Kodi available for Windows. If you are a general user wanting hassle free installation and operation, the Release version is the one for you.

== Nightly ==
Kodi is in a constant state of upgrade and improvement. The Nightly version is the forward progression of the Release version. The nightly does not include new features. It's purpose is to fix bugs that have been discovered in the official Release version of Kodi.

The nightly is available for download and installation. If you have been affected by a bug that is fixed in the nightly version, then it is safe to use a nightly version.

== Development Builds ==
<section begin="Development Builds" />The development builds, often called “pre-release” builds, are what will eventually lead to the final product of the next version. '''THESE BUILDS COULD BE UNSTABLE''' and they may have functions and features missing or broken. They are for users that do not fear bugs or possibly crashes and data loss. The Development Builds are made available with the intention that users are willing to help diagnose and improve the product by testing and providing feedback on any issues that are discovered, which helps bring the release of the next version closer.

'''Do not treat the Development Build as a Stable Release! There will be bugs, missing features and experimental changes.''' Complaints made on the forum about missing or broken features will be met with silence at best.

If you want a stable and stress free Kodi experience, then please install the stable build instead. '''Always backup before using a development build.'''<section end="Development Builds" />

== Which Install Method ==
There are a number of methods available to install Kodi. Choose an installation method you understand and are comfortable with.

== Installer ==
This is the most commonly used method and is similar to installing any other MS Windows software.

# On the download page, click '''Installer (32BIT)'''
# You will be offered the standard '''Run''', '''Save''', '''Cancel''' options.
# Once downloaded, installation will commence automatically if the '''Run''' option was selected, or you will need to double click the downloaded file if the '''Save''' option was selected. Once installation commences, simply follow the steps as shown on screen. For most users the offered default settings are sufficient, if not, change them accordingly if you are sure you have to.

The following video guide may help you with this install process.

{{#widget:YouTube|id=pfV9Z691n40}}

{{divbox|green||'''Note:''' Please note that Kodi v15 is shown in the video. v17 will show a different menu system}}

== Windows Store ==
Kodi may be downloaded from the Windows Store as an App. It is still the same Kodi version as the “Installer” version. There are no changes or limitations using this version. The store version brings a few benefits, such as automatic updating and the ability to run on Windows 10 S.

Selecting this option will take you to the Kodi page at the MS Windows Store. Click the large Kodi icon to commence the install process.

To read more about the introduction of the Windows Store version click here... [https://kodi.tv/article/kodi-goes-windows-store Windows Store Blog]

== Chocolatey ==
If you have Chocolatey installed, you may run the command line installer. For instructions, visit the Kodi Package page at [https://chocolatey.org/packages/kodi Chocolately].

== Portable Mode ==
[[File:Portable01.jpg|300px|right]]
<section begin="PortableMode" />If you have a requirement to run a different version of Kodi, or run a basic install for the purpose of fault finding and testing, without removing your current installation, Kodi has the ability to run in portable mode. This is a Windows only feature. It gives the user the flexibility to install multiples of the same version or multiple different versions of {{kodi}}.

Follow these steps to install additional Kodi setups on the same computer.

# Download required version of Kodi and run the Installation
# During the installation process you will be prompted to specify the install location. This must be changed from the default location offered. Install to...
## A removable USB device, or
## Another folder or hard drive on your computer. If installed to another folder or hard drive...
##* It must be in a location where standard users have write permission (e.g. ''not'' under Program Files) or
##* Run the shortcut as admin (even though you're logged in with an admin account). Otherwise {{kodi}} will be unable to start and will display the message "ERROR: Unable to create application. Exiting."
# '''Once the Install has finished do not run Kodi''' until the remainder of these steps have been completed.
# Navigate to where you just installed Kodi and look for the file '''''kodi.exe'''''
# Create a shortcut to kodi.exe. Usually by right clicking on the kodi.exe file and selecting ''Send to'' then ''desktop (create shortcut)''
# Right click on the newly created shortcut and select ''Properties''. There will be a box called ''Target:'', add the switch ''-p'' after kodi.exe i.e. P:\Kodi\kodi.exe -p and save the change (see image)
# Start Kodi. This will then use the Kodi folder itself as the Home folder, which means scripts, plugins, skins and userdata will be located in the '''portable_data''' folder within the Kodi folder.
# You will, however, have to be careful when upgrading to make sure that the [[userdata]] folder you use is not overwritten.

'''Note''': It is this shortcut that enables Portable Mode. If you create another shortcut and fail to add the '''-p''' switch, or start this portable version of {{kodi}} in another manner, then the standard userdata folder will be created which may overwrite your existing installation of {{Kodi}}.<section end="PortableMode" />
{{-}}

= Upgrading Kodi =
The dedicated team of Kodi volunteers are always working to improve and enhance your Kodi experience. At various times throughout the year, new stable versions of Kodi are released.

Upgrading is a simple task. Following the “How To Install” guide above will allow you to upgrade Kodi to the latest version. Be aware of the following though

* It is not necessary to uninstall the previous version. If you are happy with your current setup, installing “over the top” is ok.
* Make a backup of your '''%appdata%\Kodi''' directory. Do not upgrade without backing up first. {{See|Backup}}
* Ensure your hardware meets the minimum requirements before upgrading. {{See|Hardware_requirement}}
* If you have a favourite add-on or skin, ensure they have also been upgraded to work in the new version of Kodi. If the upgrade is a decimal upgrade (eg v17 to v17.1) then all skins and add-ons should still be compatible.
*It is currently possible to upgrade from v14 to v17 in one jump

{{#widget:YouTube|id=V0eLSeuN0Gs}}
{{divbox|green||'''Note:''' Please note that Kodi v15 is shown in the video. v17 will show a different menu system}}

== Upgrading XBMC ==
{{See| Migration_from_XBMC_to_Kodi}}

If you are one of the few people still using a version of XBMC, you must follow the instructions in the above mentioned guide to upgrade to the latest stable release. Be aware of the following

* Ensure your hardware meets the minimum requirements before upgrading. {{See|Hardware_requirement}}
* If you have a favourite add-on or skin, ensure they have also been upgraded to work in the new version of Kodi.

= Older Kodi Versions =
Looking for an older version of Kodi? They can be found here...
[http://mirrors.kodi.tv/releases/win32/old/ http://mirrors.kodi.tv/releases/win32/old/]

= Uninstalling Kodi =
Kodi is installed in two locations. Which parts of Kodi you uninstall depends on the reason for your requirement. The two locations are as follows:

== Program ==
This is the install location for the core program of Kodi. There should be no user interaction with this folder, same as any other program installed in the ''Program files'' folder of your computer.

The Kodi program is installed by default here...
C:\Program Files (x86)\Kodi

To uninstall the data from here, you should run Windows Add or Remove Programs. You will also have the option to remove the ''\Kodi\userdata'' folder.

== Userdata ==
The userdata folder (aka %AppData% folder or Kodi Roaming folder) is the location where all subsequent changes are made, like creating libraries, new skins or add-ons etc. This is a different ''Kodi'' folder to where the Kodi program is installed. All modifications to Kodi are saved in the ''Userdata'' folder.

Be aware that when using the term '''Userdata''' we are referencing the '''Kodi''' folder located in the '''\Roaming\''' folder. By co-incidence there is a ''userdata'' subfolder located within the Kodi folder.

You would use this procedure in the following circumstances..
*You are performing a '''Fresh Install''' of Kodi.
*You removed the Kodi program from your system, but failed to tick the option to remove ''\Kodi\Userdata''
*You removed the Kodi program from your system, but the Windows Uninstaller failed to remove the ''\Kodi\Userdata'' folder
*You are creating a backup

The location of the '''\Roaming\Kodi\''' folder depends on the installation method used:

If you downloaded Kodi from this site and manually ran the installer, you will find the ''Kodi'' folder in here...
C:\Users\Your User Name\AppData\Roaming\

If you downloaded Kodi from the Microsoft Store, you will find the ''Kodi'' folder in here...
C:\Users\Your User Name\AppData\Local\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\

Data in these locations must be manually removed. Options to remove are as follows...
* If you want to retain the userdata folder for backup purposes, simply rename the ''Kodi'' folder to something like ''Kodi-Old''.
* If you have no requirement to keep the Userdata folder, then simply Delete the folder and all its subfolders and files

Once renamed or deleted, Kodi will re-create the Userdata folders on next start of the program.

== Complete Uninstall ==
To completely uninstall Kodi, leaving no remnants behind, you must remove the data from both locations- Program and Userdata.

= Windows Defender =
Windows Defender SmartScreen is a feature of Windows, Internet Explorer, and Microsoft Edge. It is designed to help protect you from websites Microsoft believes are fraudulent that try to steal your personal information. In Internet Explorer 8 and later, SmartScreen also helps protect you from downloading malicious software. {{small|Courtesy Microsoft}}

SmartScreen works in two ways:
*If the downloaded file has been seen before and is known to be dangerous malware, SmartScreen blocks it.

*If the downloaded file has not been seen before and Windows isn’t sure whether it’s safe, Windows prevents the app from starting and warns you it may be dangerous, but lets you bypass this warning.

If you are one of the many users keen on updating to the latest release as soon as it becomes available, you may encounter a problem with Windows Defender Smartscreen blocking the install process. You should only be affected by the second category mentioned above. To override the warning, follow these steps:

<gallery widths="400" heights="400">
File:WinDefender01.JPG|When confronted with the following dialogue box, click on the words '''More Info'''
File:WinDefender02.JPG|The text will then expand to show the following. Simply click '''Run anyway. '''
File:WinDefender03.jpg|If the previous steps do not work, it may mean that you have your Windows Defender set to '''Block''' instead of''' Warn'''. To change this in Windows 10, go to '''settings -> security -> defender -> open defender security settings''' and change the first setting to '''Warn''' as shown in the image.
</gallery>

= What Next? =
[[File:Quick-start-0.png|400px|right]]

After the installation you can immediately start using Kodi. To start Kodi, find it under the Windows '''Start''' button in a '''Program Group''' called '''Kodi'''. You can also use the desktop icon if you enabled this option during setup.

When starting Kodi for the first time, this screen is displayed.

Now that Kodi is installed and running you will want to add your media to the Library.
{{See|First_time_user}}

{{top}}

{{updated|18}}

[[Category:Guides]]
[[Category:Manual]]
[[Category:How-to]]
[[Category:Windows]]
[[Category:Karellen]]
[[Category:General topics]]
[[Category:First time user]]
[[Category:Quick Start Guide]]
[[Category:Installation|Windows]]