-
Notifications
You must be signed in to change notification settings - Fork 11
LibraryXML Info
One of the most useful features of !MovieJukebox is the ability to specify multiple locations that contain your video files.
This concept allows you to create a single index that might point to files on the internal media player drive, multiple shares on server or NAS, and a HTTP streaming source.
For information on how to run !MovieJukebox with a library file, see this page: CommandSyntax
library.xml is a plain text file and can be edited with any text editor.
Note: library.xml is the name of the example library file included with !MovieJukebox. You may edit this file or create your own. Just remember if you choose a different file name you must remember to modify any example commands that reference this file.
When you open your xml file you will notice a nested set of library tags inside the libraries tag.
Each library represents one location where you have your movies stored.
<libraries>
<library>
<path>Z:\</path>
<playerpath>file:///opt/sybhttpd/localhost.drives/NETWORK_SHARE/?????/?????/</playerpath>
<exclude name="sample,tmp/,temp/,RECYCLE.BIN/,/._"/>
<description></description>
<prebuf></prebuf>
<scrapeLibrary>true</scrapeLibrary>
</library>
</libraries>
This tag denotes a wrapper around subsequent sub-libraries. It should always be present even if there is a single library for compatibility reasons.
This tag denotes a grouping of tags into a single library entry. If you want to index multiple directories, shares, etc. then create multiple library entries. There is no limit to the number of library blocks you can have.
The <path> is the location of the video files relative to where you're running the !MovieJukebox application.
In the example above the videos are stored in the root directory of the "Z:" drive of the machine where !MovieJukebox is running. This may be a local drive, or a mapped drive.
Note: This path may also reference a UNC location, however there is a bit of trick to doing so. In order to use a UNC the backslashes before the server name (but not folder names) need to be dereferenced.
<path>\\\\tower\dvd</path>
The <playerpath> is the location of the video files relative to your media player.
Setting the <playerpath> correctly seems to be the most common problem encountered by the novice !MovieJukebox user. For the Networked Media Tank, here is a list of NMTPath examples.
The <exclude name=""/> tag contains a comma separated list of strings. If !MovieJukebox finds one of these strings anywhere in a file or folder name it will exclude that file from the jukebox index.
For instance:
"sample" excludes any file/folder that includes the word sample anywhere
"sample/" excludes those ending with the word sample
"/sample" excludes those that begin with the word sample
"/sample/" excludes an exact match of the word sample.
This tag may be used to exclude the indexing of test or sample files.
Additionally, it may be used to allow files in a single location to be shared via different protocols. This can be useful for instance if you want to store Hi-Def content and DVD ISO files or folders in the same location.
This field can also take regular expressions for more powerful exclusion matching.
For more information on regular expressions see here: http://www.regular-expressions.info/reference.html
The <description> is a free form text field used to identify the library.
This can be used to sort the jukebox index by source or display a human friendly name for the library location.
If this behaviour is not desired, then simply leave this field blank.
The <prebuf> element is for specifying the prebuffer size (in bytes).
If this is undesired, then leave the prebuf blank and it will use the default of 16777216 (16MB)
The <scrapeLibrary> element enables (default) or disables scraping the internet for information on the video files for an entire library element.
<libraries>
<library>
<path>T:\TV Shows\</path>
<playerpath>Media Player Path</playerpath>
<exclude name="sample,/tmp/,extras/" />
<description>TV Shows Library</description>
</library>
<library>
<path>S:\Movies\</path>
<playerpath>Media Player Path</playerpath>
<description>Movie Library<description>
</library>
<library>
<path>M:\Home Movies\</path>
<playerpath>Media Player Path</playerpath>
<description>Home Movies</description>
</library>
</libraries>