Difference between revisions of "Quick start guide"

From Official Kodi Wiki
Jump to: navigation, search
(newer template. Others are just redirects to this one.)
(Important note about the Context Menu)
Line 71: Line 71:
 
As you read this wiki and experiment on your own, you will quickly learn about the value of the '''''[[context menu]]'''''.
 
As you read this wiki and experiment on your own, you will quickly learn about the value of the '''''[[context menu]]'''''.
  
To use it, while highlighting an item, press the {{keypress|'''C'''}} key on the keyboard. If you are using a mouse, you can right click while hovering over an item.  With remote controls, this is normally the {{button|guide}} button.
+
To use it, while highlighting an item, long press the {{keypress|'''OK'''}} key on a IR remote, long press {{keypress|'''return'''}}  on a keyboard. if you are using a mouse, you can right click while hovering over an item or long left click.
  
 
== Alternative guides ==
 
== Alternative guides ==

Revision as of 19:02, 16 September 2017

Home icon grey.png   ▶ General topics ▶ First time user ▶ Quick start guide

Congratulations, new user, in your choice of media center software: Kodi!


This guide is designed to get you up and running with Kodi in the shortest time possible, and was written with the most typical use cases in mind. For more in depth information please refer to the Kodi online wiki manual

The Kodi interface is designed with the 'Home Theater' in mind. This means it is best viewed on a large-screen TV while you sit on your couch 10-feet away from that TV, rather than on a small monitor while you sit at your desk. Because everything is designed with the home theater experience in mind, the best way to interact with Kodi is with a remote control, rather than a computer mouse. If it helps, think of Kodi as the ultimate DVD-player/set-top-box.

1 Installing Kodi

Kodi can be installed on a wide range of supported hardware, from normal desktop computers, ARM powered tablets and phones, to tiny set-top-boxes, and more.

If you haven't already done so, download Kodi from http://kodi.tv/download/ or see the installation guides here:

icon
Windows
icon
Universal Windows Platform
icon
Android
icon
Linux
icon
Raspberry Pi
icon
Mac OS X
icon
iOS

See the Installing page for additional guides.

2 Adding files

While you can just use Kodi with plain file views, adding/scanning files to the library will add rich features such as cover art, summaries, thumbnails, trailers, and more.

To just quickly add files see Adding videos to the library/Adding media sources.

2.1 Adding videos to the library

3 Adding Sources

4 Set Content


The left image is the Set Content screen for Movies. The right image is the Set Content screen for TV Shows. Continue these steps using the appropriate one, not both.


Movies- Content scanning options
Movies are in separate folders that match the movie title
  • If Enabled Kodi will use the folder name to scrape the movie
  • Kodi will load NFO files from NFO files named movie.nfo, but will fallback to <videofilename>.nfo as required
  • Kodi will load artwork files using the short format <artworktype>.jpg/png filenames, but will fallback to the longer <NameOfVideoFile>-<artworktype>.jpg/png format as required.
  • If Disabled Kodi will use the filename to scrape the movie
  • NFO files must be named the long format <MovieFileName>.nfo filename.
  • Artwork files must be named using the long format <NameOfVideoFile>-<artworktype>.jpg/png filenames.
Scan Recursively
Used for deep folder structures such as when additional Genre or Movie Set folders are used. Will allow the video scanner to search deeper to find the playable file
Selected folder contains a single video
Normally greyed out unless you have selected a single movie folder within an existing source. Disabled when a Source is selected. Becomes Enabled when a Movie folder is selected.
Exclude path from library updates
Prevents the Source from being scanned when an Update Library is running. When Enabled it will speed up the Update Library process in large libraries if the Source no longer has content added to it.


TV Show- Content scanning options
Selected folder contains a single TV show
Allows you to change the Content settings for a particular TV Show without affecting the entire Source. Disabled when a Source is selected. Becomes Enabled when a TV Show folder is selected.
Exclude path from library updates
Prevents the Source from being scanned when an Update Library is running. When Enabled it will speed up the Update Library process in large libraries if the Source no longer has content added to it.


Alternate scrapers are available, and can be installed using the Get More button from the Choose information provider option shown in Step 9. Only change the default scraper if you have a particular reason to.


4.1 Movie Scraper


From Step 9a above select Settings to access the settings page for the scraper

Keep original title
Use the original (untranslated) title when downloading info for a foreign film.
For example the movie Crouching Tiger, Hidden Dragon (2000) is the English translated title of the movie. The Original Name of the movie is 卧虎藏龙. If you prefer the English translated title, then disable the setting. If you prefer the original Chinese title then enable the setting.
Enable fanart
Enable this setting to download Fanart.
Enable trailer (YouTube)
Downloads the link to a movie trailer at YouTube. If you have local trailers, ensure this setting is disabled.
Preferred language
Language to use for summaries and other metadata.
Preferred Certification Country
Country/Nation preference for Content Advisory Ratings- eg M, MA, PG
Default Rating from
Choose site to download movie ratings from. Choices are TMDB and IMDB. If IMDB is selected, it becomes the default rating. TheMovieDB rating is still scraped.
Add also IMDB ratings
Only visible if the previous setting is set to TMDB. Allows scraping of ratings from both sources, but keeps TheMovieDB rating as the default rating.

Press OK to accept the changes. The screen in Step 10 will be offered


4.2 TV Show Scraper


From Step 9b above select Settings to access the settings page for the scraper

Keep original title
Use the original (untranslated) title when downloading info for a TV Show
For example the movie Crouching Tiger, Hidden Dragon (2000) is the English translated title of the movie. The Original Name of the movie is 卧虎藏龙. If you want the English translated title, then disable the setting. If you want the original Chinese title then enable the setting.
Get Artwork from themoviedb.org
Enable this setting to download Poster, Fanart and episode Thumbs Artwork
Get Extra Artwork from fanart.tv
Enable this setting to download other Artwork types such as Banner, Clearart, Clearlogo, Discart, Landscape for the TV Show and Seasons
Preferred language
Language to use for summaries and other metadata.


Press OK to accept the changes. The screen in Step 10 will be offered

5 Add to Library


5.1 Adding music to the library

See also: Adding music to the library and Music library

In order to be able to include information on your music collection in the library, Kodi needs your music to be tagged. When your collection is scanned, Kodi stores all the tagging information (artist, album, year, genre, etc) in the database which allows you to efficiently search and manage your music collection. Today most media applications and players (e.g. iTunes / iPod) organize music by this ID tag information.

Note: Your audio files must have a valid ID tag for them to work properly in the Kodi music library.

This process achieves the following:

  • Sets your music source(s) in Kodi. Simply explained, this points Kodi to your music files
  • Allows Kodi to scan the tags in the music files and import that data into the library



5.2 Adding pictures

Adding sources for your pictures follows the same method as adding other media sources. From the Home Page navigate to Pictures, select Add Source and browse to the location of your picture files.

5.3 Using a remote control

In Kodi the primary environment was designed for the living room (10-foot interface) and controlling it only with a remote control. While Kodi does support mouse, keyboard, and even touch controls, the main method of controlling Kodi is designed around is the typical remote. This further enhances the appliance feel of the Kodi and fits next to (or replaces) the other remotes that are likely to be in your entertainment room.

5.4 Kodi add-ons

An Add-on is another piece of software that can be added to a program to further expand and enhance the features of that program. Imagine a smart phone and all the additional Apps that can be installed to enhance its functionality. Kodi has the same ability and these apps are referred to as Add-ons. Kodi has a growing list of community driven add-ons which can be installed from a common official repository, while still enabling third-party developers to also host their own unofficial repositories for add-ons that any user can choose to add themselves.


For this example a skin is being installed, the same method is used for other add-ons.

Select Install from repository -> Select the repository (if no other repositories are installed it will automatically open the Kodi Add-on repository) -> Select the add-on category -> Select the add-on -> Select Install

To access the Add-on browser see: How to access the Add-on browser

When the add-on has finished downloading Kodi will enable it and depending on the add-on ask if you want to start using it. Add-ons will then appear in their appropriate section (e.g. skins in the appearance section of settings, movie scrapers in the options of scrapers when adding a new movie source)


5.5 Changing the look and feel of Kodi

Kodi is unlike many contemporary media and gaming centers, in that it can be easily customized to look completely different using skins while still remaining equally as useable and providing access to all your videos, music, and more.

To get new skins, go to: Settings → Interface settings → Skin → Skin - Estuary

You will be provided a list of currently installed skins and an option to "Get More..." where you can download additional skins.

To change skins, see: How To: Change Skins

5.6 Important note about the Context Menu

As you read this wiki and experiment on your own, you will quickly learn about the value of the context menu.

To use it, while highlighting an item, long press the OK key on a IR remote, long press return on a keyboard. if you are using a mouse, you can right click while hovering over an item or long left click.

5.7 Alternative guides


5.8 See also