2022-03-08 08:06:22 +00:00
# Run Commands & Environment Variables
This table outlines the run commands and environment variables that can be utilized to customize the running of Plex Meta Manager to the user's requirements. Environment Variable values are used over Shell Command values.
If you run into a race condition where you have set an Environment Variable within your system and also use a Shell Command for the same attribute, then the Environment Variable will take priority.
2022-03-21 17:35:21 +00:00
These docs are assuming you have a basic understanding of Docker concepts. One place to get familiar with Docker would be the [official tutorial ](https://www.docker.com/101-tutorial/ ).
2022-03-08 08:06:22 +00:00
2022-12-22 17:02:00 +00:00
| Attribute | Shell Command | Environment Variable |
|:------------------------------------------------------|:----------------------------------------------|:-------------------------|
| [Config ](#config ) | `-c` or `--config` | `PMM_CONFIG` |
| [Time to Run ](#time-to-run ) | `-t` or `--time` | `PMM_TIME` |
2023-01-03 22:07:05 +00:00
| [Run Immediately ](#run-immediately ) | `-r` or `--run` | `PMM_RUN` |
2022-12-22 17:02:00 +00:00
| [Run Tests ](#run-tests ) | `-rt` , `--tests` , or `--run-tests` | `PMM_TEST` |
| [Debug ](#debug ) | `-db` or `--debug` | `PMM_DEBUG` |
| [Trace ](#trace ) | `-tr` or `--trace` | `PMM_TRACE` |
2023-01-29 00:07:04 +00:00
| [Log Requests ](#log-requests ) | `-lr` or `--log-requests` | `PMM_LOG_REQUESTS` |
2022-12-22 17:02:00 +00:00
| [Timeout ](#timeout ) | `-ti` or `--timeout` | `PMM_TIMEOUT` |
| [Collections Only ](#collections-only ) | `-co` or `--collections-only` | `PMM_COLLECTIONS_ONLY` |
| [Playlists Only ](#playlists-only ) | `-po` or `--playlists-only` | `PMM_PLAYLISTS_ONLY` |
| [Operations Only ](#operations-only ) | `-op` , `--operations` , or `--operations-only` | `PMM_OPERATIONS` |
| [Overlays Only ](#overlays-only ) | `-ov` , `--overlays` , or `--overlays-only` | `PMM_OVERLAYS` |
| [Run Collections ](#run-collections ) | `-rc` or `--run-collections` | `PMM_COLLECTIONS` |
| [Run Libraries ](#run-libraries ) | `-rl` or `--run-libraries` | `PMM_LIBRARIES` |
| [Run Metadata Files ](#run-metadata-files ) | `-rm` or `--run-metadata-files` | `PMM_METADATA_FILES` |
| [Libraries First ](#libraries-first ) | `-lf` or `--libraries-first` | `PMM_LIBRARIES_FIRST` |
| [Ignore Schedules ](#ignore-schedules ) | `-is` or `--ignore-schedules` | `PMM_IGNORE_SCHEDULES` |
| [Ignore Ghost ](#ignore-ghost ) | `-ig` or `--ignore-ghost` | `PMM_IGNORE_GHOST` |
| [Cache Libraries ](#cache-libraries ) | `-ca` or `--cache-libraries` | `PMM_CACHE_LIBRARIES` |
| [Delete Collections ](#delete-collections ) | `-dc` or `--delete-collections` | `PMM_DELETE_COLLECTIONS` |
| [Delete Labels ](#delete-labels ) | `-dl` or `--delete-labels` | `PMM_DELETE_LABELS` |
| [Resume Run ](#resume-run ) | `-re` or `--resume` | `PMM_RESUME` |
| [No Countdown ](#no-countdown ) | `-nc` or `--no-countdown` | `PMM_NO_COUNTDOWN` |
| [No Missing ](#no-missing ) | `-nm` or `--no-missing` | `PMM_NO_MISSING` |
| [No Report ](#no-report ) | `-nr` or `--no-report` | `PMM_NO_REPORT` |
| [Read Only Config ](#read-only-config ) | `-ro` or `--read-only-config` | `PMM_READ_ONLY_CONFIG` |
| [ENV Plex URL ](#env-plex-url--token ) | `-pu` or `--plex-url` | `PMM_PLEX_URL` |
| [ENV Plex Token ](#env-plex-url--token ) | `-pt` or `--plex-token` | `PMM_PLEX_TOKEN` |
| [Divider Character ](#divider-character--screen-width ) | `-d` or `--divider` | `PMM_DIVIDER` |
| [Screen Width ](#divider-character--screen-width ) | `-w` or `--width` | `PMM_WIDTH` |
2022-03-08 08:06:22 +00:00
Further explanation and examples of each command can be found below.
## Run Command Attribute Examples
2022-03-21 17:35:21 +00:00
Environment variables are expressed as `KEY=VALUE` Depending on the context where you are specifying them, you may enter those two things in two different fields, or some other way. The examples below show how you would specify the environment variable in a script or a `docker run` command. Things like Portainer or a NAS Docker UI will have different ways to specify these things.
2022-03-08 08:06:22 +00:00
### Config
Specify the location of the configuration YAML file.
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -c< / code > or < code > --config< / code > < / td >
< td > < code > PMM_CONFIG< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --config /data/config.yml< / code > < / td >
< td > < code > PMM_CONFIG=/data/config.yml< / code > < / td >
< / tr >
< tr >
< th > Default< / th >
< td colspan = "2" > < code > config/config.yml< / code > < / td >
< / tr >
< tr >
< th > Values< / th >
< td colspan = "2" > Path to YAML config file< / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-03-08 08:06:22 +00:00
python plex_meta_manager.py --config < path_to_config >
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-03-08 08:06:22 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --config < path_to_config >
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
### Time to Run
Specify the time of day that Plex Meta Manager will run.
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -t< / code > or < code > --time< / code > < / td >
< td > < code > PMM_TIME< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --time 06:00,18:00< / code > < / td >
< td > < code > PMM_TIME=06:00,18:00< / code > < / td >
< / tr >
< tr >
< th > Default Value< / th >
2022-06-07 20:42:17 +00:00
< td colspan = "2" > < code > 05:00< / code > < / td >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Available Values< / th >
< td colspan = "2" > comma-separated list in < code > HH:MM< / code > format< / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-03-08 08:06:22 +00:00
python plex_meta_manager.py --time 22:00,03:00
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-03-08 08:06:22 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --time 22:00,03:00
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
2023-01-03 22:07:05 +00:00
### Run Immediately
2022-03-08 08:06:22 +00:00
Perform a run immediately, bypassing the time to run flag.
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -r< / code > or < code > --run< / code > < / td >
< td > < code > PMM_RUN< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --run< / code > < / td >
< td > < code > PMM_RUN=true< / code > < / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
2022-03-08 08:06:22 +00:00
2022-12-09 16:52:51 +00:00
```
2022-03-08 08:06:22 +00:00
python plex_meta_manager.py --run
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-03-08 08:06:22 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --run
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
### Run Tests
2022-10-25 19:47:45 +00:00
Perform a debug test run immediately, bypassing the time to run flag. This will only run collections with `test: true` in the definition.
2022-03-08 08:06:22 +00:00
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -rt< / code > , < code > --tests< / code > , or < code > --run-tests< / code > < / td >
< td > < code > PMM_TEST< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --run-tests< / code > < / td >
< td > < code > PMM_TEST=true< / code > < / td >
< / tr >
< / table >
* Only collections with `test: true` enabled will be run
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-03-08 08:06:22 +00:00
python plex_meta_manager.py --run-tests
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-03-08 08:06:22 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --run-tests
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
2022-10-25 19:47:45 +00:00
### Debug
Run with Debug Logs Reporting to the Command Window.
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-10-25 19:47:45 +00:00
< th > Shell< / th >
< th > Environment< / th >
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -db< / code > or < code > --debug< / code > < / td >
< td > < code > PMM_DEBUG< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --debug< / code > < / td >
2023-01-03 22:07:05 +00:00
< td > < code > PMM_DEBUG=true< / code > < / td >
2022-10-25 19:47:45 +00:00
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-10-25 19:47:45 +00:00
python plex_meta_manager.py --debug
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-10-25 19:47:45 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --debug
```
2022-12-09 16:52:51 +00:00
````
2022-10-25 19:47:45 +00:00
### Trace
Run with extra Trace Debug Logs.
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-10-25 19:47:45 +00:00
< th > Shell< / th >
< th > Environment< / th >
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -tr< / code > or < code > --trace< / code > < / td >
2023-01-03 22:07:05 +00:00
< td > < code > PMM_TRACE< / code > < / td >
2022-10-25 19:47:45 +00:00
< / tr >
< tr >
< th > Example< / th >
< td > < code > --trace< / code > < / td >
< td > < code > PMM_TRACE=true< / code > < / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-10-25 19:47:45 +00:00
python plex_meta_manager.py --trace
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2023-01-29 00:07:04 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --trace
```
````
### Log Requests
Run with every network request printed to the Logs. **This can potentially have personal information in it.**
< table class = "dualTable colwidths-auto align-default table" >
< tr >
< th style = "background-color: #1d1d1d ;" ></ th >
< th > Shell< / th >
< th > Environment< / th >
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -lr< / code > or < code > --log-request< / code > or < code > --log-requests< / code > < / td >
< td > < code > PMM_LOG_REQUESTS< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --log-requests< / code > < / td >
< td > < code > PMM_NETWORK=true< / code > < / td >
< / tr >
< / table >
````{tab} Local Environment
```
python plex_meta_manager.py --log-requests
```
````
````{tab} Docker Environment
```
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --log-requests
2022-10-25 19:47:45 +00:00
```
2022-12-09 16:52:51 +00:00
````
2022-10-25 19:47:45 +00:00
2022-08-01 20:26:10 +00:00
### Timeout
2023-01-03 22:07:05 +00:00
Change the main Plex Meta Manager timeout. This timeout is overwritten by those in your config file for those services.
2022-08-01 20:26:10 +00:00
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-08-01 20:26:10 +00:00
< th > Shell< / th >
< th > Environment< / th >
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -ti< / code > or < code > --timeout< / code > < / td >
< td > < code > PMM_TIMEOUT< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --timeout 360< / code > < / td >
< td > < code > PMM_TIMEOUT=360< / code > < / td >
< / tr >
2023-01-03 22:07:05 +00:00
< tr >
< th > Values< / th >
< td colspan = "2" > Integer Number of Seconds< / td >
< / tr >
2022-08-01 20:26:10 +00:00
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-10-25 19:47:45 +00:00
python plex_meta_manager.py --timeout 360
2022-08-01 20:26:10 +00:00
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-10-25 19:47:45 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --timeout 360
2022-08-01 20:26:10 +00:00
```
2022-12-09 16:52:51 +00:00
````
2022-08-01 20:26:10 +00:00
2022-03-08 08:06:22 +00:00
### Collections Only
2022-12-22 16:38:09 +00:00
Only run collection metadata/YAML files, skip library operations, overlays, and playlists.
2022-03-08 08:06:22 +00:00
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
2022-08-01 20:26:10 +00:00
2022-03-08 08:06:22 +00:00
< tr >
< th > Flags< / th >
< td > < code > -co< / code > or < code > --collections-only< / code > < / td >
< td > < code > PMM_COLLECTIONS_ONLY< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --collections-only< / code > < / td >
< td > < code > PMM_COLLECTIONS_ONLY=true< / code > < / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-03-08 08:06:22 +00:00
python plex_meta_manager.py --collections-only
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-03-08 08:06:22 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --collections-only
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
2022-05-11 04:37:42 +00:00
### Playlists Only
Only run playlist metadata/YAML files, skip library operations, overlays, and collections/metadata.
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-05-11 04:37:42 +00:00
< th > Shell< / th >
< th > Environment< / th >
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -po< / code > or < code > --playlists-only< / code > < / td >
< td > < code > PMM_PLAYLISTS_ONLY< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --playlists-only< / code > < / td >
< td > < code > PMM_PLAYLISTS_ONLY=true< / code > < / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-05-11 04:37:42 +00:00
python plex_meta_manager.py --playlists-only
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-05-11 04:37:42 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --playlists-only
```
2022-12-09 16:52:51 +00:00
````
2022-05-11 04:37:42 +00:00
2023-01-03 22:07:05 +00:00
### Operations Only
2022-03-08 08:06:22 +00:00
2022-05-11 04:37:42 +00:00
Only run library operations skipping collections/metadata, playlists, and overlays.
2022-03-08 08:06:22 +00:00
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
2022-04-18 18:16:39 +00:00
< td > < code > -op< / code > or < code > --operations< / code > < / td >
< td > < code > PMM_OPERATIONS< / code > < / td >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Example< / th >
2022-04-18 18:16:39 +00:00
< td > < code > --operations< / code > < / td >
< td > < code > PMM_OPERATIONS=true< / code > < / td >
2022-03-08 08:06:22 +00:00
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-04-18 18:16:39 +00:00
python plex_meta_manager.py --operations
2022-03-08 08:06:22 +00:00
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-04-18 18:16:39 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --operations
```
2022-12-09 16:52:51 +00:00
````
2022-04-18 18:16:39 +00:00
2023-01-03 22:07:05 +00:00
### Overlays Only
2022-04-18 18:16:39 +00:00
2022-05-11 04:37:42 +00:00
Only run library overlays skipping collections/metadata, playlists, and operations.
2022-04-18 18:16:39 +00:00
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-04-18 18:16:39 +00:00
< th > Shell< / th >
< th > Environment< / th >
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -ov< / code > or < code > --overlays< / code > < / td >
< td > < code > PMM_OVERLAYS< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --overlays< / code > < / td >
< td > < code > PMM_OVERLAYS=true< / code > < / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-04-18 18:16:39 +00:00
python plex_meta_manager.py --overlays
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-04-18 18:16:39 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --overlays
2022-03-08 08:06:22 +00:00
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
### Run Collections
2022-10-25 19:47:45 +00:00
Perform a collections run immediately to run only the pre-defined collections, bypassing the time to run flag.
2022-03-08 08:06:22 +00:00
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -rc< / code > or < code > --run-collections< / code > < / td >
< td > < code > PMM_COLLECTIONS< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
2023-01-25 16:15:19 +00:00
< td > < code > --run-collections "Harry Potter|Star Wars"< / code > < / td >
< td > < code > PMM_COLLECTIONS=Harry Potter|Star Wars< / code > < / td >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Values< / th >
2023-01-25 16:15:19 +00:00
< td colspan = "2" > Pipe-separated list of Collection Names to run< / td >
2022-03-08 08:06:22 +00:00
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2023-01-25 16:15:19 +00:00
python plex_meta_manager.py --run-collections "Harry Potter|Star Wars"
2022-03-08 08:06:22 +00:00
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2023-01-25 16:15:19 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --run-collections "Harry Potter|Star Wars"
2022-03-08 08:06:22 +00:00
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
### Run Libraries
2022-10-25 19:47:45 +00:00
Perform a libraries run immediately to run only the pre-defined libraries, bypassing the time to run flag.
2022-03-08 08:06:22 +00:00
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -rl< / code > or < code > --run-libraries< / code > < / td >
< td > < code > PMM_LIBRARIES< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
2023-01-25 16:15:19 +00:00
< td > < code > --run-libraries "Movies - 4K|TV Shows - 4K"< / code > < / td >
< td > < code > PMM_LIBRARIES=Movies - 4K|TV Shows - 4K< / code > < / td >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Values< / th >
2023-01-25 16:15:19 +00:00
< td colspan = "2" > Pipe-separated list of Library Names to run< / td >
2022-03-08 08:06:22 +00:00
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-03-08 08:06:22 +00:00
python plex_meta_manager.py --run-libraries "TV Shows"
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-03-08 08:06:22 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --run-libraries "TV Shows"
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
### Run Metadata Files
2022-10-25 19:47:45 +00:00
Perform a metadata files run immediately to run only the pre-defined metadata files, bypassing the time to run flag.
2022-03-08 08:06:22 +00:00
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -rm< / code > or < code > --run-metadata-files< / code > < / td >
< td > < code > PMM_METADATA_FILES< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
2023-01-25 16:15:19 +00:00
< td > < code > --run-metadata-files "Movies.yml|MovieCharts"< / code > < / td >
< td > < code > PMM_METADATA_FILES=Movies.yml|MovieCharts< / code > < / td >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Available Values< / th >
2023-01-25 16:15:19 +00:00
< td colspan = "2" > Pipe-separated list of Metadata Filenames to run< / td >
2022-03-08 08:06:22 +00:00
< / tr >
< / table >
* This works for all different metadata paths i.e. `git` , `url` , `file` , or `repo` .
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-03-08 08:06:22 +00:00
python plex_meta_manager.py --run-metadata-files "Movies"
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-03-08 08:06:22 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --run-metadata-files "Movies"
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
### Libraries First
Run library operations prior to running collections.
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -lf< / code > or < code > --libraries-first< / code > < / td >
< td > < code > PMM_LIBRARIES_FIRST< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --libraries-first< / code > < / td >
< td > < code > PMM_LIBRARIES_FIRST=true< / code > < / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-03-08 08:06:22 +00:00
python plex_meta_manager.py --libraries-first
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-03-08 08:06:22 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --libraries-first
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
### Ignore Schedules
Ignore all schedules for the run.
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -is< / code > or < code > --ignore-schedules< / code > < / td >
< td > < code > PMM_IGNORE_SCHEDULES< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --ignore-schedules< / code > < / td >
< td > < code > PMM_IGNORE_SCHEDULES=true< / code > < / td >
< / tr >
< / table >
* Range Scheduled collections (such as Christmas movies) will still be ignored.
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-03-08 08:06:22 +00:00
python plex_meta_manager.py --ignore-schedules
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-03-08 08:06:22 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --ignore-schedules
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
### Ignore Ghost
Ignore all ghost logging for the run. A ghost log is what's printed to the console to show progress during steps.
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -ig< / code > or < code > --ignore-ghost< / code > < / td >
< td > < code > PMM_IGNORE_GHOST< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --ignore-ghost< / code > < / td >
< td > < code > PMM_IGNORE_GHOST=true< / code > < / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-03-08 08:06:22 +00:00
python plex_meta_manager.py --ignore-ghost
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-03-08 08:06:22 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --ignore-ghost
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
2022-05-10 15:47:13 +00:00
### Cache Libraries
Cache the library Load for 1 day.
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-05-10 15:47:13 +00:00
< th > Shell< / th >
< th > Environment< / th >
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -ca< / code > or < code > --cache-libraries< / code > < / td >
< td > < code > PMM_CACHE_LIBRARIES< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --cache-libraries< / code > < / td >
< td > < code > PMM_CACHE_LIBRARIES=true< / code > < / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-05-10 15:47:13 +00:00
python plex_meta_manager.py --cache-libraries
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-05-10 15:47:13 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --cache-libraries
```
2022-12-09 16:52:51 +00:00
````
2022-05-10 15:47:13 +00:00
2022-03-08 08:06:22 +00:00
### Delete Collections
Delete all collections in a Library prior to running collections/operations.
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -dc< / code > or < code > --delete-collections< / code > < / td >
< td > < code > PMM_DELETE_COLLECTIONS< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --delete-collections< / code > < / td >
< td > < code > PMM_DELETE_COLLECTIONS=true< / code > < / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-03-08 08:06:22 +00:00
python plex_meta_manager.py --delete-collections
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-03-08 08:06:22 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --delete-collections
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
2022-11-01 18:20:00 +00:00
### Delete Labels
Delete all labels on every item in a Library prior to running collections/operations.
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-11-01 18:20:00 +00:00
< th > Shell< / th >
< th > Environment< / th >
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -dl< / code > or < code > --delete-labels< / code > < / td >
< td > < code > PMM_DELETE_LABELS< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --delete-labels< / code > < / td >
< td > < code > PMM_DELETE_LABELS=true< / code > < / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-11-01 18:20:00 +00:00
python plex_meta_manager.py --delete-labels
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-11-01 18:20:00 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --delete-labels
```
2022-12-09 16:52:51 +00:00
````
2022-11-01 18:20:00 +00:00
2022-03-08 08:06:22 +00:00
### Resume Run
2022-10-25 19:47:45 +00:00
Perform a resume run immediately resuming from the first instance of the specified collection, bypassing the time to run flag.
2022-03-08 08:06:22 +00:00
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -re< / code > or < code > --resume< / code > < / td >
< td > < code > PMM_RESUME< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --resume "Star Wars"< / code > < / td >
< td > < code > PMM_RESUME=Star Wars< / code > < / td >
< / tr >
< tr >
< th > Available Values< / th >
< td colspan = "2" > Name of collection to resume from< / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-03-08 08:06:22 +00:00
python plex_meta_manager.py --resume "Star Wars"
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-03-08 08:06:22 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --resume "Star Wars"
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
### No Countdown
Run without displaying a countdown to the next scheduled run.
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -nc< / code > or < code > --no-countdown< / code > < / td >
< td > < code > PMM_NO_COUNTDOWN< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --no-countdown< / code > < / td >
< td > < code > PMM_NO_COUNTDOWN=true< / code > < / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-03-08 08:06:22 +00:00
python plex_meta_manager.py --no-countdown
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-03-08 08:06:22 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --no-countdown
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
### No Missing
Run without utilizing the missing movie/show functions.
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -nm< / code > or < code > --no-missing< / code > < / td >
< td > < code > PMM_NO_MISSING< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --no-missing< / code > < / td >
< td > < code > PMM_NO_MISSING=true< / code > < / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-03-08 08:06:22 +00:00
python plex_meta_manager.py --no-missing
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-03-08 08:06:22 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --no-missing
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
2022-10-21 21:09:36 +00:00
### No Report
2022-10-25 19:47:45 +00:00
Run without saving the report.
2022-10-21 21:09:36 +00:00
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-10-21 21:09:36 +00:00
< th > Shell< / th >
< th > Environment< / th >
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -nr< / code > or < code > --no-report< / code > < / td >
< td > < code > PMM_NO_REPORT< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --no-report< / code > < / td >
< td > < code > PMM_NO_REPORT=true< / code > < / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-10-21 21:09:36 +00:00
python plex_meta_manager.py --no-report
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-10-21 21:09:36 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --no-report
```
2022-12-09 16:52:51 +00:00
````
2022-10-21 21:09:36 +00:00
2022-03-08 08:06:22 +00:00
### Read Only Config
2022-10-25 19:47:45 +00:00
Run without writing to the configuration file.
2022-03-08 08:06:22 +00:00
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -ro< / code > or < code > --read-only-config< / code > < / td >
< td > < code > PMM_READ_ONLY_CONFIG< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --read-only-config< / code > < / td >
< td > < code > PMM_READ_ONLY_CONFIG=true< / code > < / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-03-08 08:06:22 +00:00
python plex_meta_manager.py --read-only-config
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-03-08 08:06:22 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --read-only-config
```
2022-12-09 16:52:51 +00:00
````
2022-03-08 08:06:22 +00:00
2022-12-20 01:04:14 +00:00
### ENV Plex URL & Token
Replaces `ENV` when it is used plex `url` or `token` .
#### Plex URL
< table class = "dualTable colwidths-auto align-default table" >
< tr >
< th style = "background-color: #1d1d1d ;" ></ th >
< th > Shell< / th >
< th > Environment< / th >
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -pu< / code > or < code > --plex-url< / code > < / td >
< td > < code > PMM_PLEX_URL< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --plex-url 192.168.1.12:32400< / code > < / td >
< td > < code > PMM_PLEX_URL=192.168.1.12:32400< / code > < / td >
< / tr >
< / table >
#### Plex Token
< table class = "dualTable colwidths-auto align-default table" >
< tr >
< th style = "background-color: #1d1d1d ;" ></ th >
< th > Shell< / th >
< th > Environment< / th >
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -pt< / code > or < code > --plex-token< / code > < / td >
< td > < code > PMM_PLEX_TOKEN< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --plex-token AB23HE4588< / code > < / td >
< td > < code > PMM_PLEX_TOKEN=AB23HE4588< / code > < / td >
< / tr >
< / table >
````{tab} Local Environment
```
python plex_meta_manager.py --plex-url 192.168.1.12:32400 --plex-token AB23HE4588
```
````
````{tab} Docker Environment
```
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --plex-url 192.168.1.12:32400 --plex-token AB23HE4588
```
````
2022-03-08 08:06:22 +00:00
### Divider Character & Screen Width
2022-10-25 19:47:45 +00:00
Change the terminal output divider character or width.
2022-03-08 08:06:22 +00:00
#### Divider Character
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -d< / code > or < code > --divider< / code > < / td >
< td > < code > PMM_DIVIDER< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --divider *< / code > < / td >
< td > < code > PMM_DIVIDER=*< / code > < / td >
< / tr >
< tr >
< th > Default< / th >
< td colspan = "2" > < code > =< / code > < / td >
< / tr >
< tr >
< th > Values< / th >
< td colspan = "2" > A character< / td >
< / tr >
< / table >
#### Screen Width
< table class = "dualTable colwidths-auto align-default table" >
< tr >
2022-12-09 16:52:51 +00:00
< th style = "background-color: #1d1d1d ;" ></ th >
2022-03-08 08:06:22 +00:00
< th > Shell< / th >
2022-03-21 17:35:21 +00:00
< th > Environment< / th >
2022-03-08 08:06:22 +00:00
< / tr >
< tr >
< th > Flags< / th >
< td > < code > -w< / code > or < code > --width< / code > < / td >
< td > < code > PMM_WIDTH< / code > < / td >
< / tr >
< tr >
< th > Example< / th >
< td > < code > --width 150< / code > < / td >
< td > < code > PMM_WIDTH=150< / code > < / td >
< / tr >
< tr >
< th > Default< / th >
< td colspan = "2" > Integer between 90 and 300< / td >
< / tr >
< tr >
< th > Values< / th >
< td colspan = "2" > A character< / td >
< / tr >
< / table >
2022-12-09 16:52:51 +00:00
````{tab} Local Environment
```
2022-03-08 08:06:22 +00:00
python plex_meta_manager.py --divider * --width 200
```
2022-12-09 16:52:51 +00:00
````
````{tab} Docker Environment
```
2022-03-08 08:06:22 +00:00
docker run -it -v "X:\Media\Plex Meta Manager\config:/config:rw" meisnate12/plex-meta-manager --divider * --width 200
```
2022-12-09 16:52:51 +00:00
````
