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.
66 lines
3.6 KiB
66 lines
3.6 KiB
# Plex Attributes
|
|
|
|
Configuring [Plex](https://www.plex.tv/) is required in order to connect to your libraries.
|
|
|
|
A `plex` mapping can be either in the root of the config file as global mapping for all libraries, or you can specify the `plex` mapping individually per library.
|
|
|
|
Below is a `plex` mapping example and the full set of attributes:
|
|
```yaml
|
|
plex:
|
|
url: http://192.168.1.12:32400
|
|
token: ####################
|
|
timeout: 60
|
|
clean_bundles: true
|
|
empty_trash: true
|
|
optimize: false
|
|
```
|
|
|
|
| Attribute | Allowed Values | Default | Required |
|
|
|:----------------|:---------------------------------------------------------------------------------------------------------------------------------|:--------|:--------:|
|
|
| `url` | Plex Server URL or `ENV` (This will use the Environment/Runtime Plex URL)<br><strong>Example:</strong> http://192.168.1.12:32400 | N/A | ✅ |
|
|
| `token` | Plex Server Authentication Token or `ENV` (This will use the Environment/Runtime Plex URL) | N/A | ✅ |
|
|
| `timeout` | Plex Server Timeout | 60 | ❌ |
|
|
| `clean_bundles` | Runs Clean Bundles on the Server after all Metadata Files are run | false | ❌ |
|
|
| `empty_trash` | Runs Empty Trash on the Server after all Metadata Files are run | false | ❌ |
|
|
| `optimize` | Runs Optimize on the Server after all Metadata Files are run | false | ❌ |
|
|
|
|
* **Do Not Use the Plex Token found in Plex's Preferences.xml file**
|
|
|
|
* This script can be run on a remote Plex server, but be sure that the `url` provided is publicly addressable, and it's recommended to use `HTTPS`.
|
|
|
|
* If you need help finding your Plex authentication token, please see Plex's [support article](https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/).
|
|
|
|
# Multi-Plex Instance Setup:
|
|
|
|
The below config.yml extract details how to set up multiple Plex servers within the one PMM instance, in this example there are two plex servers which are receiving the same Metadata File:
|
|
|
|
```yaml
|
|
libraries:
|
|
Movies:
|
|
metadata_path:
|
|
- file: config/Movies.yml
|
|
Movies_on_Second_Plex:
|
|
library_name: Movies
|
|
metadata_path:
|
|
- file: config/Movies.yml
|
|
plex:
|
|
url: http://plex.boing.bong
|
|
token: SOME_TOKEN
|
|
timeout: 360
|
|
...
|
|
plex:
|
|
url: http://plex.bing.bang
|
|
token: SOME_TOKEN
|
|
timeout: 60
|
|
clean_bundles: false
|
|
empty_trash: false
|
|
optimize: false
|
|
...
|
|
```
|
|
|
|
The `plex` instance at the bottom is the "global" plex server. unless otherwise specified, any connection to plex is assumed to to using that plex server. The first "Movies" library entry is on the global `plex` server.
|
|
|
|
The "Movies_on_Second_Plex" library is found on the second plex server. Note that this library has its own plex section that lists the attributes that differ from the global plex instance, namely the `URL`, `token` and `timeout`. The library on the second server is also called "Movies", but since you can't have two keys (in this scenario, libraries) with the same name, it is named Movies_on_Second_Plex in the config.yml, and the `library_name:` attribute contains the name of the library on the actual plex server.
|
|
|
|
|