You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Plex-Meta-Manager/docs/defaults/overlays/flixpatrol.md

6.8 KiB

FlixPatrol Top Overlays

The flixpatrol Default Overlay File is used to create an overlay based on the Top Lists from FlixPatrol on items within your library.

Requirements & Recommendations

Supported Overlay Level: Movie, Show

Supported Services

Service Key Weight
Netflix netflix 60
Disney+ disney 50
MAX max 40
Hulu hulu 30
Paramount+ paramount 20
Prime Video prime 10
Apple+ apple 9

Config

The below YAML in your config.yml will create the overlays:

libraries:
  Movies:
    overlay_path:
      - pmm: flixpatrol
  TV Shows:
    overlay_path:
      - pmm: flixpatrol

Template Variables

Template Variables can be used to manipulate the file in various ways to slightly change how it works without having to make your own local copy.

Note that the template_variables: section only needs to be used if you do want to actually change how the defaults work. Any value not specified is its default value if it has one if not it's just ignored.

All Shared Overlay Variables except horizontal_offset, horizontal_align, vertical_offset, and vertical_align are available with the default values below as well as the additional Variables below which can be used to customize the file.

Variable Default
horizontal_offset 30
horizontal_align left/right
vertical_offset 465/670/875
vertical_align top
back_color #00000099
back_radius 30
back_width 160
back_height 160
back_padding 15
Variable Description & Values
position Description: Changes the position of the Overlays.
Default: right
Values: right, left, or List of Coordinates
style Description: Changes the style of the Logo Image.
Default: round
Values: round or square
pre_text Description: Changes the text before the number.
Default: TOP
Values: Any String
limit Description: Changes the Builder Limit for all overlays in a Defaults file.
Default: 10
Values: Any Number 1-10
limit_<<key>>1 Description: Changes the Builder Limit of the specified key's overlay.
Default: limit
Values: Any Number 1-10
location Description: Changes the Builder Location for all overlays in a Defaults file.
Default: world
Values: location Attribute Options
location_<<key>>1 Description: Changes the Builder Location of the specified key's overlay.
Default: location
Values: location Attribute Options
weight_<<key>>1 Description: Controls the weight of the Overlay. Higher numbers have priority.
Values: Any Number
font Description: Choose the font for the Overlay.
Default: fonts/Inter-Medium.ttf
Values: Path to font file
font_style Description: Font style for Variable Fonts.
Values: Variable Font Style
font_size Description: Choose the font size for the Overlay.
Default: 50
Values: Any Number greater then 0
font_color Description: Choose the font color for the Overlay.
Default: #FFFFFF
Values: Color Hex Code in format #RGB, #RGBA, #RRGGBB or #RRGGBBAA
stroke_width Description: Font Stroke Width for the Text Overlay.
Values: Any Number greater then 0
stroke_color Description: Font Stroke Color for the Text Overlay.
Values: Color Hex Code in format #RGB, #RGBA, #RRGGBB or #RRGGBBAA
addon_offset Description: Text Addon Image Offset from the text.
Default: 30
Values: Any Number greater then 0
addon_position Description: Text Addon Image Alignment in relation to the text.
Default: top
Values: left, right, top, bottom
  1. Each default overlay has a key that when calling to effect a specific overlay you must replace <<key>> with when calling.

The below is an example config.yml extract with some Template Variables added in to change how the file works.

libraries:
  Movies:
    overlay_path:
      - pmm: flixpatrol
        template_variables:
          location: united_states