XBMC will be renamed to Kodi for v14. Read here for more details

ITunes (DAAP), Adding videos to the library

From Kodi
(Difference between pages)
Jump to: navigation, search
m (Enabled TOC again)
 
m (typo)
 
Line 1: Line 1:
{{XBMC wiki toc Inline}}
+
[[Scraper.xml|Scrapers]] are used by XBMC to retrieve data from a webpage which is used in the [[Video Library]]. To be able to utilize them you first have to "Set Content" to the source you plan to add information on.<br>
__NOEDITSECTION__
+
__TOC__
+
The Digital Audio Access Protocol (DAAP) is the protocol introduced by Apple in its iTunes software to share media across a local network.
+
  
==iTunes Introduction==
+
==Setting Contents==
[http://en.wikipedia.org/wiki/Itunes iTunes] (from Apple) is a digital media-player application for Windows/Mac-OSX. It is also used for organizing digital music and video files. iTunes is also an interface to manage the music on Apple's popular [http://en.wikipedia.org/wiki/IPOD iPod] portable digital audio-player. Additionally, iTunes can connect to the [http://en.wikipedia.org/wiki/ITunes_Music_Store iTunes Music Store] (sometimes referred to as "iTMS") which allows users to purchase digital music and movie files that can be played by iPods and iTunes, the files downloaded from iTunes Music Store are however protected/encrypted by Apple's proprietary [http://en.wikipedia.org/wiki/Digital_rights_management DRM (Digital Rights Management)] (called FairPlay) which makes them impossible to play in anything other than iTunes or iPods, (thus XBMC can not play any files purchases on iTunes Music Store).  
+
In the [[Videos#Files View|Files View]] of the 'Videos' section of XBMC, bring up the [[Videos Navigation and Control#The Context Menu|Context Menu]]. By selecting "Set Content" one can set the type of content for the chosen directory.
  
==iTunes and XBMC==
+
The Context menu can be brought up by the 'Windows' '''Menu''' button on the Keyboard or by pressing right mouse button on the appropriate item.
Creating a network share using iTunes is a simple solution if all that you want to stream from your PC to XBMC is music. However, XBMC is only able to connect to libraries shared by iTunes 6 or earlier. In order to use this method, you first need to download and install [http://www.apple.com/itunes/download/ iTunes software] on your Windows PC or Apple Mac-OS X computers.
+
On Xbox it's the '''White''' button or '''Title''' on the remote.
 
+
On the Mac version of XBMC, the context menu can be displayed by holding the '''Menu''' button on the Apple Remote or by pressing '''C''' on the keyboard.
==Configuring iTunes on your computer==
+
 
{|
 
{|
 +
|
 +
[[image:Set_content0.jpg|180px]]
 
| valign="top" |
 
| valign="top" |
===Step 1===
+
Different types of scrapers can be assigned to different directories, but be aware that 'TV Shows' scrapers must be assigned to a folder containing multiple TV shows ( or at least be one directory above the TV show folder itself) unless you select the ''Folder contains a single TV Show Option'', e.g.
When you launch iTunes for the first time, it will prompt you to scan your computer for music files. Follow the onscreen prompts to scan your music library into iTunes.
+
<pre>
===Step 2===
+
TV Shows
After scanning your music library, open the preferences diaglog in iTunes and click on the Sharing tab. Then, check the "'''Share My Music'''"" option, ensure that the "'''Share Entire Library'''" option is selected, and name the share. In this case, we called it Music.  
+
    |----TV Show 1
 +
    |      |___ TV Show 1 Media files
 +
    |
 +
      ----TV Show 2
 +
            |___ TV Show 2 Media files
 +
</pre>
 +
In the above example you would assign the chosen TV Shows scraper to the ''TV Shows'' folder. Note that each TV show needs to be in its own folder for XBMC to be able to scan it into the library.
 +
|}
  
 +
After choosing a content type ([[IMDB|Movies]], [[TV Shows|TV shows]] or [[Music Videos]]), one can decide on a scraper to use. There are currently several scrapers available of each type. For movies, the [[IMDb|IMDb scraper]] will give the best results for most users. The other available scrapers are for example scrapers for different languages and adult movies, ie. porn.
 +
{|
 +
| valign="top" |
 +
[[image:Set_content2.jpg|360px]]
 +
|
 +
[[image:Set.content.movies.jpg|360px]]
 +
|
 +
[[image:Set.content.tv.jpg|360px]]
 +
|}
  
Your configuration should look like this:
+
===Options After Selecting Scraper===
 +
;Exclude folder from scans
 +
:Excludes the selected folder from scans, even if it's a subfolder of a folder that has contents set.
 +
;Run Automatic Scan
 +
:Runs a scan against the selected information source (scraper) on all video files contained in the selected folder after selecting 'OK'
 +
;Use Foldername for Lookups
 +
:Uses foldernames as basis for the search when scraping (instead of filenames). If folder contains IFO and VOB files, this is needed for any matching to take place.
 +
;Folder contains a single Video
 +
:The standard assumption is that the source contains multiple video files, this option dictates that the selected source or folder only contains one video.
 +
;Folder contains a single TV Show
 +
:The standard assumption is that the source contains multiple TV shows, this option dictates that the selected source or folder only contains one TV show.
 +
;Scan Recursively
 +
:Scans subfolders two levels down or more for video files. Note that TV Show scrapers always scan recursively.
  
[[image:itunes.png|360px]]
+
===Scraper settings===
 +
Some scrapers like the IMDb scraper allow the user to change options related to that scraper, see more:<br>
 +
* [[IMDb (Video Library)#IMDb scraper settings|IMDb scraper settings]]<br>
 +
* [[TheTVDB.com (Video Library)#TTheTVDB.com Scraper Settings|TheTVDB.com scraper settings]]
  
 +
===Switching Scrapers / Removing Folder Contents from Library===
 +
Setting the content back to '''<None>''' after previously having selected a scraper for a source, will prompt users if they want to remove the contents from the Library.<br>
 +
This is recommended if you wish to switch scrapers (first set content to '''<None>''' and then choose the new scraper).<br>
 +
Setting content to '''<None>''' also removes the contents of the selected folder from the Library altogether. This is useful if you want to remove the contents of an entire folder from the Library as [[Video_Library#Video_Context_Menu_in_Library_Mode|The Context Menu]] will only remove single items.
  
 +
==Additional information==
 +
On movie naming conventions for the IMDb, see the [[IMDB#Additional information|IMDB documentation page]].
  
==How to Configure iTunes Sharing in XBMC==
+
On TV show naming conventions for TV shows scraper, see the [[TV Shows|TV Shows documentation page]].
===Adding iTunes share via GUI===
+
Just bring up the context menu from the root listing of your sources in My Music Files and select Add Source. Then select Browse to browse for your path, and "Add Network Location...". You want to add an iTunes (DAAP) share, and you'll need to input the IP address of the PC where iTunes is being shared from. Click OK to return to the filebrowser, and then select the newly added iTunes source. You can then name the source in the box below and optionally select a thumbnail that will be used for that source.  
+
  
 +
After adding new video files, if you find that the information is incorrect then you can simply remove that lookup information from the database by switching the view to "Title" and pressing the black-button on the controller.
  
===Adding iTunes share via XML===
+
[[Import_-_Export_Library#Video_nfo_Files|Nfo files]] can be used to provide data for a movie or influence the search behavior of scrapers.
You can add or change the iTunes source in Sources.xml like all [[Media Sources]], your iTunes source needs to contain two pieces of information:
+
  
#'''The <name> tag -''' This indicates what XBMC will display as the name of the source
+
If you would like to remove the entire video database (for example after a bad scan, or you have problems with the library, or for whatever reason), then you can simply use the [[Filemanager]] or [[HOW-TO:_FTP_into_your_Xbox | FTP]], and either rename the MyVideos*.db, in directory Q:\UserData\Database, to something else (i.e. MyVideos*.db.backup) or delete it. Then restart, and the movie & TV show information gathering can be redone.  
#'''The <path> tag -'''  This indicates where the information is actually located
+
+
For the purpose of these examples, I will use 192.168.1.100 as the IP address of the PC where the shares are located. For your configuration, simply substitute the IP-address of your computer.
+
<xml>  <source>
+
    <name>iTunes Network Share (DAAP)</name>
+
    <path>daap://192.168.1.100</path>
+
  </source></xml>
+
  
Note! General information and advanced configuration of shares/sources regarding, see [[Media Sources]].
+
'''*TIP!:''' If you like to use lookup to catalog off-line DVD-Video library (or other movies stored on DVD/CD media) see
 +
*[[HOW-TO: Catalog and use lookups on your offline DVD/CD movie library (via fake files)]]
  
[[category:File Sharing]]
+
[[category:How To|Scraper]]
 +
[[category:Scraper]]
 +
[[category:Usage]]
 +
[[category:Library]]
 +
[[category:Video Library]]

Revision as of 18:53, 22 February 2009

Scrapers are used by XBMC to retrieve data from a webpage which is used in the Video Library. To be able to utilize them you first have to "Set Content" to the source you plan to add information on.

Contents

1 Setting Contents

In the Files View of the 'Videos' section of XBMC, bring up the Context Menu. By selecting "Set Content" one can set the type of content for the chosen directory.

The Context menu can be brought up by the 'Windows' Menu button on the Keyboard or by pressing right mouse button on the appropriate item. On Xbox it's the White button or Title on the remote. On the Mac version of XBMC, the context menu can be displayed by holding the Menu button on the Apple Remote or by pressing C on the keyboard.

Set content0.jpg

Different types of scrapers can be assigned to different directories, but be aware that 'TV Shows' scrapers must be assigned to a folder containing multiple TV shows ( or at least be one directory above the TV show folder itself) unless you select the Folder contains a single TV Show Option, e.g.

TV Shows
     |----TV Show 1
     |       |___ TV Show 1 Media files
     |
      ----TV Show 2
             |___ TV Show 2 Media files

In the above example you would assign the chosen TV Shows scraper to the TV Shows folder. Note that each TV show needs to be in its own folder for XBMC to be able to scan it into the library.

After choosing a content type (Movies, TV shows or Music Videos), one can decide on a scraper to use. There are currently several scrapers available of each type. For movies, the IMDb scraper will give the best results for most users. The other available scrapers are for example scrapers for different languages and adult movies, ie. porn.

Set content2.jpg

Set.content.movies.jpg

Set.content.tv.jpg

1.1 Options After Selecting Scraper

Exclude folder from scans
Excludes the selected folder from scans, even if it's a subfolder of a folder that has contents set.
Run Automatic Scan
Runs a scan against the selected information source (scraper) on all video files contained in the selected folder after selecting 'OK'
Use Foldername for Lookups
Uses foldernames as basis for the search when scraping (instead of filenames). If folder contains IFO and VOB files, this is needed for any matching to take place.
Folder contains a single Video
The standard assumption is that the source contains multiple video files, this option dictates that the selected source or folder only contains one video.
Folder contains a single TV Show
The standard assumption is that the source contains multiple TV shows, this option dictates that the selected source or folder only contains one TV show.
Scan Recursively
Scans subfolders two levels down or more for video files. Note that TV Show scrapers always scan recursively.

1.2 Scraper settings

Some scrapers like the IMDb scraper allow the user to change options related to that scraper, see more:

1.3 Switching Scrapers / Removing Folder Contents from Library

Setting the content back to <None> after previously having selected a scraper for a source, will prompt users if they want to remove the contents from the Library.
This is recommended if you wish to switch scrapers (first set content to <None> and then choose the new scraper).
Setting content to <None> also removes the contents of the selected folder from the Library altogether. This is useful if you want to remove the contents of an entire folder from the Library as The Context Menu will only remove single items.

2 Additional information

On movie naming conventions for the IMDb, see the IMDB documentation page.

On TV show naming conventions for TV shows scraper, see the TV Shows documentation page.

After adding new video files, if you find that the information is incorrect then you can simply remove that lookup information from the database by switching the view to "Title" and pressing the black-button on the controller.

Nfo files can be used to provide data for a movie or influence the search behavior of scrapers.

If you would like to remove the entire video database (for example after a bad scan, or you have problems with the library, or for whatever reason), then you can simply use the Filemanager or FTP, and either rename the MyVideos*.db, in directory Q:\UserData\Database, to something else (i.e. MyVideos*.db.backup) or delete it. Then restart, and the movie & TV show information gathering can be redone.

*TIP!: If you like to use lookup to catalog off-line DVD-Video library (or other movies stored on DVD/CD media) see

Personal tools
Namespaces

Variants
Actions
Navigation
Wiki help
Toolbox