Skip to content

Blacktagging vs Whitetagging

terrelsa13 edited this page Aug 23, 2024 · 5 revisions

Tagging Options During Setup

  • During creation of the mumc_config.yaml, MUMC will give the option to enter a comma separated list of blacktags and/or whitetags.
    • blacktags entered during setup are global and apply to all media_types
    • whitetags entered during setup are global and apply to all media_types
    • The same tag cannot be used for both a blacktag and a whitetag
    • Backslash '\' is not an allowed character
basic_settings:
  filter_tags:
    media_type:
      whitetags: #yaml lists can also be over multiple lines like this
      - played:1:<:2
      - created:9999:<:8:true]
      blacktags:  [played:1:<:2,created:9999:<:8:true] #yaml lists can be on one line like this
advanced_settings:
  whitetags:
    global: [list,of,string(s)] #yaml lists can be on one line like this
    media_type: #yaml lists can also be over multiple lines like this
    - list
    - of
    - string(s)
  blacktags:
    global: #yaml lists can also be over multiple lines like this
    - list
    - of
    - string(s)
    media_type: [list,of,string(s)] #yaml lists can be on one line like this

Use Blacktagging When

  • In general, you want MUMC to delete media_items matching the tag.

Use Whitetagging When

  • In general, you want MUMC to keep media_items matching the tag.

Tagging

  • Is optional
  • Multiple tags can be used
  • Tags must be in yaml list format
  • Global tags apply to all media_types
  • Media specific tags apply only to the media_types they are specified under
  • Tags apply to all monitored_users
  • Whitetags have a higher priorty than Blacktags

Blacktag Examples

  • Examples of how Blacktagging usually works:
advanced_settings:
  blacktags:
    global:
    - deletetag
    - delete tag
    - delete-tag
.
.
.
admin_settings:
  users:
  - user_id: ...
    user_name: user0
    whitelist:
    - lib_id: ...
      collection_type: library0
      path: ...
      network_path: ...
      lib_enabled: true
    blacklist:
    - lib_id: ...
      collection_type: library1
      path: ...
      network_path: ...
      lib_enabled: ...
  • Media_itemA from library0 is Blacktagged
  • Media item A could be deleted

  • Media_itemB from library1 is Blacktagged
  • Media item B could be deleted

Whitetag Example

  • Examples of how Whitetagging usually works:
advanced_settings:
  whitetags:
    global:
    - keeptag
    - keep tag
    - keep-tag
.
.
.
admin_settings:
  users:
  - user_id: ...
    user_name: user0
    whitelist:
    - lib_id: ...
      collection_type: library0
      path: ...
      network_path: ...
      lib_enabled: true
    blacklist:
    - lib_id: ...
      collection_type: library1
      path: ...
      network_path: ...
      lib_enabled: ...
  • Media_itemA from library0 is Whitetagged
  • Media item A could be kept

  • Media_itemB from library1 is Whitetagged
  • Media item B could be kept

Additional Information - MUMC extras.

Clone this wiki locally