add local libraries doc [no docker]

docs/user-guide/local-libraries.md

@@ -0,0 +1,109 @@
+## Movies
+
+### Folder Layout
+
+The `Movies` library requires movie subfolders. The following is a (non-exhaustive) list of valid locations for movies:
+
+- `Movie (1999)\Movie (1999).mkv`
+- `Movie\Movie.mkv`
+
+### NFO Metadata
+
+Each movie folder may contain a `movie.nfo` file, or an NFO file with exactly the same name as the movie, except for the `.nfo` extension. See [Kodi Wiki](https://kodi.wiki/view/NFO_files/Movies) for more information.
+ErsatzTV will read the following fields from the movie NFO:
+
+- Title
+- Year
+- Premiered
+- Plot
+- Genre(s)
+- Tag(s)
+- Studio(s)
+
+### Movie Fallback Metadata
+
+When no movie NFO is found, the movie metadata will only contain a title and a year, both parsed from the movie file name. Example:
+
+- `Movie (1999).mkv`
+
+## Shows
+
+### Folder Layout
+
+The `Shows` library requires show and season subfolders. The following is a (non-exhaustive) list of valid locations for episodes:
+
+- `Show (1999)\Season 01\Show - S01E01.mp4`
+- `Show\Season 1\Show - s1e1.mp4`
+
+### Show NFO Metadata
+
+Each show folder may contain a `tvshow.nfo` file. See [Kodi Wiki](https://kodi.wiki/view/NFO_files/TV_shows#TV_Show) for more information.
+ErsatzTV will read the following fields from the show NFO:
+
+- Title
+- Year
+- Premiered
+- Plot
+- Genre(s)
+- Tag(s)
+- Studio(s)
+
+### Show Fallback Metadata
+
+When no show NFO is found, the show metadata will only contain the title and an optional year, both parsed from the episode file name.
+Examples:
+
+- `Title`
+- `Title (1999)`
+
+### Season Metadata
+
+The season number is parsed from the season subfolder.
+Examples:
+
+- `Season 01`
+- `Season 1`
+
+### Episode NFO Metadata
+
+Each episode may have a corresponding NFO file with exactly the same name, except for the `.nfo` extension. See [Kodi Wiki](https://kodi.wiki/view/NFO_files/TV_shows#Episodes) for more information.
+ErsatzTV will read the following fields from the episode NFO:
+
+- Title
+- Episode
+- Aired
+- Plot
+
+### Episode Fallback Metadata
+
+When no episode NFO is found, the episode metadata will only contain the title and the episode number, both parsed from the episode file name.
+Examples:
+
+- `Title - s01e04.mkv`
+- `Title - S1E4.mkv`
+
+## Music Videos
+
+### Folder Layout
+
+The `Music Videos` library requires artist subfolders. The following is a (non-exhaustive) list of valid locations for music videos:
+
+- `Artist\Album\Track.mp4`
+- `Artist\Track\Track.mp4`
+- `Artist\Track.mp4`
+
+### Artist NFO Metadata
+
+Each artist subfolder may contain an `artist.nfo` file. See [Kodi Wiki](https://kodi.wiki/view/NFO_files/Music#Artists) for more information.
+ErsatzTV will read the following fields from the artist NFO:
+
+- Name
+- Disambiguation
+- Biography
+- Genre(s)
+- Style(s)
+- Mood(s)
+
+### Artist Fallback Metadata
+
+When no artist NFO is found, the artist metadata will only contain a name, which will be the exact name of the artist subfolder.

mkdocs.yml

@@ -5,6 +5,8 @@ nav:
     - 'Add Media Items': 'user-guide/add-media-items.md'
     - 'Create Channels': 'user-guide/create-channels.md'
     - 'Configure Clients': 'user-guide/configure-clients.md'
+  - 'Advanced':
+    - 'Local Libraries': 'user-guide/local-libraries.md'
 theme:
   name: material
   palette: