[38] Merge remote-tracking branch 'chazlarson/asset-clarity' into nightly

docs/pmm/guides/assets.md

@@ -95,87 +95,99 @@ Assets can be stored anywhere on the host system that PMM has visibility of (i.e
   `ASSET_NAME` is "crazy-punctuation-collection"
 
 * For **Movies** replace `ASSET_NAME` with the exact name of the folder the video file is stored in.
-  
+
+  That means the folder name exactly as it appears in the file system.
+  ```
+  /path/to/media/movies/THE NAME OF THE FOLDER HOWEVER LONG IT IS AND WHATEVER IT CONTAINS/MOVIE_NAME.mp4
+                        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -- THIS IS ASSET_NAME
+  ```
+
   For example, given this movie:
   ```
-  /path/to/media/movies/Star Wars (1977)/Star Wars (1977) [1080p].mp4
-                        ^^^^^^^^^^^^^^^^ -- THIS IS ASSET_NAME
+  /path/to/media/movies/Star Wars (1977) {imdb-tt0076759} {tmdb-11}/Star Wars (1977) [1080p].mp4
+                        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -- THIS IS ASSET_NAME
   ```
   The asset names that PMM will look for are:
 
   ASSET_FOLDERS=True:
   ```
-  config/assets/Star Wars (1977)/poster.ext
-  config/assets/Star Wars (1977)/background.ext
+  config/assets/Star Wars (1977) {imdb-tt0076759} {tmdb-11}/poster.ext
+  config/assets/Star Wars (1977) {imdb-tt0076759} {tmdb-11}/background.ext
   ```
   
   ASSET_FOLDERS=False:
   ```
-  config/assets/Star Wars (1977).ext
-  config/assets/Star Wars (1977)_background.ext
+  config/assets/Star Wars (1977) {imdb-tt0076759} {tmdb-11}.ext
+  config/assets/Star Wars (1977) {imdb-tt0076759} {tmdb-11}_background.ext
   ```
 
 * For **Shows**, **Seasons**, and **Episodes** replace `ASSET_NAME` with the exact name of the folder for the show as a whole.
 
+  That means the folder name exactly as it appears in the file system.
+  ```
+  /path/to/media/tv/THE NAME OF THE FOLDER HOWEVER LONG IT IS AND WHATEVER IT CONTAINS/Season 01/EPISODE_FILE.mkv
+                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -- THIS IS ASSET_NAME
+  ```
+
   For example, given this show:
   ```
-  /path/to/media/tv/The Expanse (2015)/Season 01/The Expanse (2015) - S01E01 - Dulcinea.mkv
-                    ^^^^^^^^^^^^^^^^^^ -- THIS IS ASSET_NAME
+  /path/to/media/tv/The Expanse (2015) {tvdb-280619}/Season 01/The Expanse (2015) - S01E01 - Dulcinea.mkv
+                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -- THIS IS ASSET_NAME
   ```
   The asset names that PMM will look for are:
 
   ASSET_FOLDERS=True:
   ```
-  config/assets/The Expanse (2015)/poster.ext
-  config/assets/The Expanse (2015)/background.ext
+  config/assets/The Expanse (2015) {tvdb-280619}/poster.ext
+  config/assets/The Expanse (2015) {tvdb-280619}/background.ext
   ```
   
   ASSET_FOLDERS=False:
   ```
-  config/assets/The Expanse (2015).ext
-  config/assets/The Expanse (2015)_background.ext
+  config/assets/The Expanse (2015) {tvdb-280619}.ext
+  config/assets/The Expanse (2015) {tvdb-280619}_background.ext
   ```
   
 * For **Seasons** replace `##` with the zero padded season number (00 for specials)
 
   For example, given this show:
   ```
-  /path/to/media/tv/The Expanse (2015)/Season 01/The Expanse (2015) - S01E01 - Dulcinea.mkv
+  /path/to/media/tv/The Expanse (2015) {tvdb-280619}/Season 01/The Expanse (2015) - S01E01 - Dulcinea.mkv
   ```
 
   The asset names that PMM will look for are:
 
   ASSET_FOLDERS=True:
   ```
-  config/assets/The Expanse (2015)/Season01.ext
-  config/assets/The Expanse (2015)/Season01_background.ext
+  config/assets/The Expanse (2015) {tvdb-280619}/Season01.ext
+  config/assets/The Expanse (2015) {tvdb-280619}/Season01_background.ext
   ```
   
   ASSET_FOLDERS=False:
   ```
-  config/assets/The Expanse (2015)_Season01.ext
-  config/assets/The Expanse (2015)_Season01_background.ext
+  config/assets/The Expanse (2015) {tvdb-280619}_Season01.ext
+  config/assets/The Expanse (2015) {tvdb-280619}_Season01_background.ext
   ```
 
 * For **Episodes** replacing the first `##` with the zero padded season number (00 for specials), the second `##` with the zero padded episode number
 
   For example, given this show:
   ```
-  /path/to/media/tv/The Expanse (2015)/Season 01/The Expanse (2015) - S01E01 - Dulcinea.mkv
+  /path/to/media/tv/The Expanse (2015) {tvdb-280619}/Season 01/The Expanse (2015) - S01E01 - Dulcinea.mkv
   ```
 
   The asset names that PMM will look for are:
 
   ASSET_FOLDERS=True:
   ```
-  config/assets/The Expanse (2015)/S01E01.ext
-  config/assets/The Expanse (2015)/S01E01_background.ext
+  config/assets/The Expanse (2015) {tvdb-280619}/S01E01.ext
+  config/assets/The Expanse (2015) {tvdb-280619}/S01E01_background.ext
   ```
   
   ASSET_FOLDERS=False:
   ```
-  config/assets/The Expanse (2015)_S01E01.ext
-  config/assets/The Expanse (2015)_S01E01_background.ext
+  config/assets/The Expanse (2015) {tvdb-280619}_S01E01.ext
+  config/assets/The Expanse (2015) {tvdb-280619}_S01E01_background.ext
   ```
 
 * Replace `.ext` with the image extension