Known Limitations

Trakt Imports

• When importing played states from Trakt, the days since played shown in the console output will not show the correct value.
  • This is an issue with the last played date not being populated when played states are imported from Trakt to Emby/Jellyfin.
  • MUMC is able to compensate for this using the _set_missing_last_played_date options.

Querying By Date Or Number Of Days Ago

• I am unable to find API methods to query media_items the following way:

  • Query for media_items last played before a certain date
  • Query for media_items last played a certain number of days ago
  • Query for media_items created before a certain date
  • Query for media_items create a certain number of days ago

• If someone does know how to do this, please open an issue with examples of the queries used.

• Based on what was said above; this is how MUMC queries for media_items:

  • media_items are queried per-user based on their:
    • matching whitetags/blacktags
    • favorite status
    • played/unplayed status
    • blacklisted/whitelisted library
  • each media_item is evaluated for played status, last played date, created date and/or played count

Per-User Delete/Keep vs True Delete/Keep

• During the querying of media_items for each user; a best guess delete or keep status is shown per-user.
  • The true delete or keep status of a media_item cannot be known during the querying of media_items for each user.
• During post-processing is when each media_items goes through behavioral_statements and the true delete or keep status is determined using data from all specified users.

Emby Library Sub-Folder Limitations

• Series, seasons, and episodes do not all share the same subfolder Id returned from Emby during setup
• This means a recursive query at the parent level will not return children
  • Example:
    • Series-A is favorited
    • The expectation is all children of Series-A (i.e. Seasons-A.x and Episodes-A.x.y) are also considered favorited
    • However, when querying the sub-folder for child media_items no Seasons or Episodes will be returned
    • This is due to the disconnect in sub-folder Ids returned from Emby for each media_type and/or media_item
      • For Series-A, one folder level up:
        • The sub-folder Id is 12345678
      • For Season-A.x, two folder levels up:
        • The sub-folder Id is 24680246
      • For Episode-A.x.y, three folder levels up:
        • The sub-folder Id is 97531975
    • The expectation is all children return the same parent library sub-folder Id; similar to the "regular" library Id
    • Until this is fixed in Emby, MUMC will continue to use library Ids
    • Per-subfolder blacklisting/whitelisting can still be achieved by using byPath or byNetworkPath as the library matching behavior

Jellyfin Library Sub-Folder Limitations

• Both Emby and Jellyfin allow multiple libraries
• Both Emby and Jellyfin allow libraries to include multiple sub-folders.
• Both Emby and Jellfyin allow assigning individual users access to individual libraries.
• Emby allows assigning individual users access to individual sub-folders within libraries.
  • Jellyfin does NOT allow assigning individual users access to individual sub-folders within libraries.

When setting up and editing the mumc_config.yaml, there are 4 options for how users and libraries will be selected. When option 0 - Select users and libraries or option 2 - Select libraries only are chosen for a Jellyfin server, MUMC automatically links sub-folders within the same library together. (i.e. Selecting one sub-folder will select all sub-folders with the same library Id.)

For Jellyfin, if the mumc_config.yaml is manually modified to have sub-folders from the same library, split across blacklist and whitelist user library sections; media_items from both sub-folders will be treated as blacklisted and whitelisted. As mentioned, this should not happen unless the mumc_config.yaml is manually modified.

For Emby/Jellyfin, sub-folders with the same path/network path can be used across multiple libraries. If the mumc_config.yaml is setup or manually modified to have a sub-folder with the same path/network path both blacklisted and whitelisted for a user; media_items from both sub-folders will be treated as blacklisted and whitelisted.

Per-subfolder blacklisting/whitelisting can still be achieved by using byPath or byNetworkPath as the library matching behavior

Issue #105

Example Library Structure

• Movie Library
  • /path/to/folder/movies1
  • /path/to/folder/movies2
• TV Library
  • /path/to/folder/tv_shows1
  • /path/to/folder/tv_shows2

Example Emby User Access Assignment

• User0
  • Movie Library
    • /path/to/folder/movies1
    • /path/to/folder/movies2
  • TV Library
    • /path/to/folder/tv_shows1
    • /path/to/folder/tv_shows2
• User1
  • Movie Library
    • /path/to/folder/movies1
    • /path/to/folder/movies2
  • TV Library
    • /path/to/folder/tv_shows1
    • /path/to/folder/tv_shows2
• User2
  • Movie Library
    • /path/to/folder/movies1
    • /path/to/folder/movies2
  • TV Library
    • /path/to/folder/tv_shows1
    • /path/to/folder/tv_shows2
• User3
  • Movie Library
    • /path/to/folder/movies1
    • /path/to/folder/movies2
  • TV Library
    • /path/to/folder/tv_shows1
    • /path/to/folder/tv_shows2

Example Jellyfin User Access Assignment

• User0
  • Movie Library
  • TV Library
• User1
  • Movie Library
  • TV Library
• User2
  • Movie Library
  • TV Library
• User3
  • Movie Library
  • TV Library