Auto-Import

From wiki.jriver.com
Revision as of 05:16, 25 March 2014 by Glynor (talk | contribs)
Jump to navigation Jump to search
Showing MC's Auto-Import configuration with a number of watched folders added.

Media Center has a full-featured Auto-Import system. With this system you can:

  • Create a set of folders that contain media, each of which have separate options defined.
  • Manually scan all of your pre-defined folders on demand.
  • Make use of the powerful Carnac (file name parsing) and Automatic Metadata Lookup features of Media Center
  • Automatically apply tags to the files imported using powerful Tag on Import rules.
  • Watch the folders for new and modified files, automatically in the background, without bogging down disk or network access.

In most cases, using Auto-Import to automatically watch your media locations on disk is the preferred means of Importing new content. Media Center turns this feature on by default, and automatically sets itself to to watch the locations found when it completed the automatic First-Use Scan. If you did not allow it to run this automated scan, then you will need to configure Auto-Import yourself.

You can configure Media Center's Auto-Import functionality via either:

  • In MC's Options dialog at Tools > Options > Libraries & Folders > Auto-Import.
  • The Media Import wizard at Tools > Import.

Configuring Auto-Import

You can configure Media Center's Auto-Import functionality via either:

  • In MC's Options dialog at Tools > Options > Libraries & Folders > Auto-Import.
  • The Media Import wizard at Tools > Import.

You can enable or disable Background Auto-Import Scanning at Tools > Options > Libraries & Folders > Auto-Import > Run auto-import in background.

MC19-AutoImport-Configuration.png

There are two major sections of the Auto-Import configuration dialog:

  • Folders - these are the folders that Auto-Import will watch for changes.
  • Tasks - these are post-processing tasks that can be applied to newly imported files

Watched Folders

In the watched Folders section of the Auto-Import dialog, you can define a set of folders on disk that will be watched for changes. You can add as many folders as you'd like to this list. When you add a directory to the watched Folders list, Media Center will automatically monitor this directory, and any of its subdirectories, for new files and modifications to existing files. You can also specify folders to be excluded from monitoring.

We don't need that user's stuff in our Library!

Media Center can watch any folder you can mount natively on the filesystem. For Windows, this includes full support for:

  • Local disks
  • Mounted Network Drives (with a drive letter)
  • UNC Paths (eg. \\server\share\path\to\folder\)

For OSX (and Linux), this includes any volume you can access from the Finder or Teminal (which includes all local and network volumes).

From the Folders section of the Auto-Import configuration dialog, you can:

  • Add new folders to watch (or exclude from watching)
  • Remove existing folder entries
  • Edit existing folder entries

Folder Settings

When you Add or Modify a folder, you are taken to the Folder Settings dialog.

This dialog has the following configuration items:

  • Folder: the path to the folder that you'd like to monitor (or exclude) on disk. You can click the Browse button to choose from a standard OS folder picker dialog box.
  • Mode: choose whether to include the specified directory (and all subdirectories) or exclude the specified directory and all subdirectories.
  • Import these file types: Use the file-type picker to choose what file types will be monitored in this particular directory. Separate watched folders can have their own lists of watched/ignored file types.
  • Apply these tags: this section of the dialog will let you apply Tags to your files automatically upon Import. For more information on this powerful feature, refer to the Tag on Import page of the Wiki.
  • Ignore special files: if enabled, Media Center will ignore a variety of common "sidecar" format metadata files, such as folder.jpg.
MC19-Auto-Import-Folder Settings.png

Auto-Import Tasks

When Auto-Import has finished analyzing and importing new files, you can choose to have it perform a number of convenient post-processing steps to further automate your use of Media Center. From this section, you can choose to:

  • Analyze audio: automatically runs the files (both audio and video files) though MC's audio analysis engine.
  • Build thumbnails for the files: this speeds browsing of the media, particularly in Theater View and other image-heavy views.
  • Get cover art: tries to look up and download any missing cover art from the Internet.
  • Get movie & TV info: looks up metadata for video files automatically from a variety of Internet metadata sources.
  • Ignore files previously removed from library: this prevents files from being automatically re-imported if you manually remove them from your Library.
  • Update for external changes: if file characteristics, including embedded tags, change externally, Media Center will update the Library to match.
  • Fix broken links: activates one of Media Center's Fix Broken Links modes.
  • Write file tags: when enabled (defaults OFF), Media Center will write out changes to the file tags when additional metadata is gathered during the Import. This includes metadata gathered by Carnac, Tag On Import rules, Automatic Metadata Lookup, audio analysis, and any other tag-generating functions of Auto-Import.

Background Scanning

Media Center's Auto-Import system runs by default in the background, and will automatically pick up changes in any of your defined Auto-Import Directories (detailed below). If needed, this feature can be disabled here: Tools > Options > Libraries & Folders > Auto-Import

With the background scanning feature disabled, you can still manually initiate a scan of your defined Auto-Import Directories with the Import Media wizard: Tools > Import

Media Center's Background Auto-Import works by:

  • Monitoring File System Events for changes and responding instantly to only those files that changed in a watched directory.
  • Running a background full-scan of the defined watched directories, and checking for changes, once every two hours. This is run with a low thread priority to prevent it from impacting foreground tasks.

Unlike the folder watching systems provided by many other applications, Media Center's background Auto-Import system relies, in part, upon a system called File System Events that is provided by your Operating System to allow it to respond to any changes made in a watched directory. This allows Media Center to react instantaneously when any changes are committed to a watched directory (you don't have to wait for the next "pass" on a timer), and prevents performance bottlenecks associated with regularly scanning the directories for all changes. Instead, when a single file is added or modified in a watched directory, Media Center is notified immediately by the underlying OS, and can react to only that file.

This system requires support from the Operating System and filesystem. Currently, this feature requires:

  • Windows or OSX versions of Media Center
  • Watched folders on a watchable filesystem (NTFS or network drive for Windows, any supported filesystem on OSX)
  • If using a network volume, the server or NAS device must properly support File System Events.

This allows Media Center to instantly respond to changes in the file system without having to bog your disk (or, worse, network interface) down with constant checks for changes in your media storage locations, most of which will not have changed. Therefore, this allows Media Center to schedule its periodic full scans of your media locations far less often than would be needed otherwise. If your storage device does not support File System events, it will still pick up new files automatically once every two hours. You can schedule additional checks yourself using MC's Automation capabilities (see below for details).