Library Matching byId vs byPath vs byNetworkPath

Library Matching Options During Setup

• During creation of the mumc_config.yaml, MUMC will ask which library matching method to use when determining a media_item's parent library.
  • byId
  • byPath
  • byNetworkPath

admin_settings:
  behavior:
    matching: string

Use byId When

• In general, you want to match media_items to their parent library by the library's Id.
• Child folders of a library will share the same library Id.

Use byPath When

• In general, you want to match media_items to the parent library by the library's child folder path(s).
• Child folders of a library will be treated individually.
  • Unless they share the same path.
• Libraries that do not have an option to add path or have no path will never match.
  • This technically should not be possible

Use byNetworkPath When

• In general, you want to match media_items to the parent library by the library's child folder network path(s).
• Child folders of a library will be treated individually.
  • Unless they share the same network path.
• Libraries that do not have an option to add network path or have no network path will never match.

Matching byId

admin_settings:
  behavior:
    matching: byId

• Each library (i.e. Movies, TV Shows, Music, etc...) has an associated identification number.
  • It is usually represented as a locally unique 8 to 32-character hexadecimal value.
  • The Id will look similiar to this abcdef0123456789abcdef0123456789.
• The library's Id is used to query Emby/Jellyfin for media_items.
• Because media_items are retrieved using their library's Id, the media_items returned can be considered matching to the library.
• The library Id can also be compared to other monitored_user's library Ids associated to them in the configuration file.

Matching byPath

admin_settings:
  behavior:
    matching: byPath

• Each library (i.e. TV, Movie, Music, etc...) and media_item (episodes, movies, audio tracks, etc..) has an associated path location.
  • It is usually represented as the local path.
  • The path will look like this /path/to/some/folder or c:\path\to\some\folder, or etc....
• It is important to note: The library's Id is still used to query Emby/Jellyfin for media_items.
• The library's child folder path(s) and the media_item's path are used for comparison.
• The path(s) can also be compared to other monitored_user's library child folder path(s) associated to them in the configuration file.

Matching byNetworkPath

admin_settings:
  behavior:
    matching: byNetworkPath

• Each library (i.e. TV, Movie, Music, etc...) and media_item` (episodes, movies, audio tracks, etc..) can be configured to have an associated network path location in Emby/Jellyfin
  • The network path will look like this smb://path/to/some/folder, nfs://path/to/some/folder, \\path\to\some\folder, or etc....
• It is important to note: The library's Id is still used to query Emby/Jellyfin for media_items.
• The library's child folder(s) network path(s) and media_item's network path(s) are used for comparison.
• The network path(s) can also be compared to other monitored_user's library network path(s) associated to them in the configuration file.
• Collections and possibly similar libraries may not have an option to add a network path.

Additional Information - MUMC extras.