tinyMediaManager

https://www.tinymediamanager.org/docs/
Admin
tinyMediaManager is a Java-based media management tool that searches for media on local disks,...
Tokens:35,963
Snippets:402
Trust Score:8.9
Update:6 months ago
Show doc for...
Tokens:
Raw
### Configure template.conf

Source: https://www.tinymediamanager.org/docs/exporttemplates

Example configuration file for a movie template. Ensure all paths match the filenames used in your template directory.

```text
    name=Jelly is Delicious
    type=movie
    list=list.jmte
    detail=detail.jmte
    extension=html
    description=Created by William Shatner\n\nThis template has jelly in its gears.
    url=https://github.com/TheShatner/jelly_template
```

--------------------------------

### MediaInfo Executable Example

Source: https://www.tinymediamanager.org/docs/post-processing

Execute an external application like MediaInfo.exe. Ensure the path is correctly quoted, especially if it contains spaces.

```json
    "name" : "MediaInfo",
    "path" : "C:\\Program Files\\MediaInfo\\MediaInfo.exe",
    "command" : "'${movie.mainVideoFile.path}/${movie.mainVideoFile.filename}'"

```

--------------------------------

### Execute TV Show Module Tasks

Source: https://www.tinymediamanager.org/docs/commandline

Examples of common TV show management workflows using the tvshow subcommand.

```bash
tinyMediaManager tvshow -u -n -r
```

```bash
tinyMediaManager tvshow -t -s
```

```bash
tinyMediaManager tvshow -e -eT=TvShowDetailExampleXml -eP=/user/export/tv
```

--------------------------------

### Run TinyMediaManager with Docker

Source: https://www.tinymediamanager.org/docs/docker

Use this command to start a TinyMediaManager container. Ensure local ports are mapped to the container's ports (4000 for web, 5900 for VNC) and local directories are mapped to container volumes for data persistence and media access.

```bash
docker run \
    --name=tinymediamanager \
    -p 4000:4000 \
    -p 5900:5900 \
    -e "LC_ALL=en_US.UTF-8" \
    -e "LANG=en_US.UTF-8" \
    -e "ALLOW_DIRECT_VNC=true" \
    -v </path/to/local/data/>:/data \
    -v </path/to/movies>:/media/movies \
    -v </path/to/tvshows>:/media/tvshows \
    -v </path/to/addons/>:/app/addons \
    --log-driver json-file \
    --log-opt max-size=20m \
    --log-opt max-file=5 \
    tinymediamanager/tinymediamanager:latest

```

--------------------------------

### Execute Movie Module Tasks

Source: https://www.tinymediamanager.org/docs/commandline

Examples of common movie management workflows using the movie subcommand.

```bash
tinyMediaManager movie -u -n -r
```

```bash
tinyMediaManager movie -t -s
```

```bash
tinyMediaManager movie -e -eT=ExcelXml -eP=/user/export/movies
```

--------------------------------

### Example Movie Data Source Directory Structure

Source: https://www.tinymediamanager.org/docs/movies/settings

Recommended folder structure for organizing movie files within a data source directory to ensure optimal detection by tinyMediaManager.

```text
H:\movies
    Aladdin
        Aladdin.avi
        movie.nfo
        sample
            sample.avi
    Alice in Wonderland
        Alice.in.Wonderland.mkv
        movie.nfo
        fanart.jpg
        poster.jpg
    Cars
        Cars.avi
    ...
```

--------------------------------

### Inline Scripting Example

Source: https://www.tinymediamanager.org/docs/post-processing

Use inline scripting to print directory and movie title, and redirect plot to a text file. Commands must be delimited by ';'.

```json
    "name" : "plot",
    "path" : "",
    "command" : "dir;\necho '${movie.title}';\necho '${movie.plot}' >plot.txt;"

```

--------------------------------

### PowerShell PS1 Scripting Example

Source: https://www.tinymediamanager.org/docs/post-processing

Execute a PowerShell PS1 scripting file with parameters. Each line in the command is treated as a single parameter, suitable for paths or complex arguments.

```json
    "name" : "ps1 space",
    "path" : "C:\\do something.ps1",
    "command" : "param1\nparam2_1 param2_2\nparam3\nparam with space"

```

--------------------------------

### Configure tinyMediaManager Data Folders

Source: https://www.tinymediamanager.org/docs/installation

Set system environment variables to specify custom locations for tinyMediaManager's data, cache, logs, and backup folders. These can be set statically via an 'extra.txt' file or dynamically via the starting shell script.

```java
-Dtmm.contentfolder=

```

```java
-Dtmm.datafolder=

```

```java
-Dtmm.cachefolder=

```

```java
-Dtmm.logfolder=

```

```java
-Dtmm.backupfolder=

```

--------------------------------

### Access actor data

Source: https://www.tinymediamanager.org/docs/jmte

Examples for retrieving, formatting, and limiting actor lists using JMTE syntax.

```text
${actors[0].name}

```

```text
${actors;array}

```

```text
${actors;array(=^..^=)}

```

```text
${actors[0,3];array}

```

```text
${actors[1,3];array}

```

```text
${actors[0,3];chain(array(, );upper;replace(umlauts.csv))}

```

--------------------------------

### Get Host User ID and Group ID

Source: https://www.tinymediamanager.org/docs/docker

Execute this command on the host system to find the UID and GID of the user that owns the data volumes. These IDs are necessary to set the `USER_ID` and `GROUP_ID` environment variables in the Docker container to avoid permission issues.

```bash
id <username>

```

--------------------------------

### Split Renderer

Source: https://www.tinymediamanager.org/docs/movies/renamer

Extracts specific elements or ranges from a list. Use a single index to get an item, or a start and end index for a sub-list.

```text
${movie.genres;split(1)}
```

```text
${movie.genres;split(1,3)}
```

--------------------------------

### Configure launcher-extra.yml structure

Source: https://www.tinymediamanager.org/docs/start-parameters

The base structure for the launcher-extra.yml configuration file.

```yaml
javaHome: "custom Java home"
jvmOpts:
  - "JVM - parameter"
env: 
  - "environment option"
```

--------------------------------

### Configure JVM options

Source: https://www.tinymediamanager.org/docs/start-parameters

Define runtime parameters for the JVM or tinyMediaManager, such as heap size or buffer settings.

```yaml
jvmOpts:
  - "-Xmx1024m"
  - "-Dtmm.mvstore.buffersize=8"
  - "-Djava.io.tmpdir=/tmp"
```

--------------------------------

### Create Linux Desktop Shortcut

Source: https://www.tinymediamanager.org/docs/installation

Use this script to create a desktop shortcut for tinyMediaManager on Linux systems. Ensure you run this command from within your tinyMediaManager instance folder.

```bash
cat <<EOM >~/.local/share/applications/tinyMediaManager.desktop
[Desktop Entry]
Type=Application
Terminal=false
Name=tinyMediaManager
Icon=$PWD/tmm.png
Exec=$PWD/tinyMediaManager
EOM

```

--------------------------------

### Custom Launcher Extra Configuration

Source: https://www.tinymediamanager.org/docs/docker

This YAML configuration is used with `/app/launcher-extra.yml` to customize TinyMediaManager's startup parameters within the Docker container. It specifies content folder and disables automatic updates.

```yaml
---
javaHome: ""
jvmOpts:
  - "-Dtmm.contentfolder=/data"
  - "-Dtmm.noupdate=true"
env: [ ]


```

--------------------------------

### Multi-Movie Folder Structure

Source: https://www.tinymediamanager.org/docs/movies/multi-version

Store all versions in one folder using specific naming conventions. Avoid using folder patterns with this approach to prevent renaming conflicts.

```text
H:\movies
 300 (2006)
     300 (2006) - 1080p.mkv
     300 (2006) - 1080p.nfo
     300 (2006) - 1080p-fanart.jpg
     300 (2006) - 1080p-poster.jpg
     300 (2006) - 4k.mkv
     300 (2006) - 4k.nfo
     300 (2006) - 4k-fanart.jpg
     300 (2006) - 4k-poster.jpg
     300 (2006) - extended cut.mkv
     300 (2006) - extended cut.nfo
     300 (2006) - extended cut-fanart.jpg
     300 (2006) - extended cut-poster.jpg
 ...
```

--------------------------------

### Chaining Renderers

Source: https://www.tinymediamanager.org/docs/exporttemplates

Allows output to be passed through multiple renderers sequentially. Useful for complex formatting tasks.

```text
${movie.title;chain(replace(umlauts.csv);lower)}
```

```text
${episode.title;chain(replace(umlauts.csv);lower)}
```

--------------------------------

### Apply conditional shortcuts

Source: https://www.tinymediamanager.org/docs/jmte

Use shorthand syntax for default values or wrapping defined variables with prefixes and suffixes.

```text
${movie.title(unknown)}
```

```text
${if movie.title}
  ${movie.title}
${else}
  unknown
${end}
```

```text
${<h1>,movie.title,</h1>}
```

```text
${if movie.title}
  <h1>${movie.title}</h1>
${end}
```

--------------------------------

### Apply format renderers

Source: https://www.tinymediamanager.org/docs/tvshows/renamer

Format dates, numbers, file sizes, and bitrates using specific units or patterns.

```text
${episode.firstAired;date(yyyy-MM-dd)}
```

```text
${tvShow.ratings.imdb.rating;number(%.0f)}
```

```text
${episode.videofilesize;filesize(G)}
```

```text
${episode.mediaInfoVideoBitrate;bitrate(Mbps)}
```

--------------------------------

### Chain multiple renderers

Source: https://www.tinymediamanager.org/docs/tvshows/renamer

Combine multiple renderers to process output sequentially.

```text
${episode.title;chain(replace(umlauts.csv);lower)}
```

--------------------------------

### Set custom Java home

Source: https://www.tinymediamanager.org/docs/start-parameters

Specify a custom Java runtime location if the default or bundled version is not desired.

```yaml
javaHome: "/usr/lib/jvm/adoptopenjdk-14-hotspot-amd64/"
```

--------------------------------

### Update Data Sources Action

Source: https://www.tinymediamanager.org/docs/http-api

Triggers a scan of data sources for new movies.

```json
{
  "action": "update",
  "scope": { "name": "all" }
}
```

--------------------------------

### Download Trailers for Movies

Source: https://www.tinymediamanager.org/docs/http-api

Initiates the download of trailers for movies. The 'onlyMissing' argument in 'args' can be set to true to only download trailers that are not already present.

```json
{
  "action": "downloadTrailer",
  "scope": { "name": "all" },
  "args": { "onlyMissing": true }
}
```

--------------------------------

### POST /api/tvshow/detectAspectRatio

Source: https://www.tinymediamanager.org/docs/http-api

Run the aspect ratio detector for episodes.

```APIDOC
## POST /api/tvshow/detectAspectRatio

### Description
This command will run the aspect ratio detector (using FFmpeg) for your episodes.

### Method
POST

### Endpoint
/api/tvshow/detectAspectRatio

### Request Body
- **action** (string) - Required - Must be "detectAspectRatio"
- **scope** (object) - Required - Defines the scope (name: "new", "path", "dataSource", "unscraped", or "all")

### Request Example
{
  "action": "detectAspectRatio",
  "scope": { "name": "all" }
}
```

--------------------------------

### Detect Aspect Ratio Action

Source: https://www.tinymediamanager.org/docs/http-api

Runs the FFmpeg-based aspect ratio detector on movies.

```json
{
  "action": "detectAspectRatio",
  "scope": { "name": "all" }
}
```

--------------------------------

### Bitrate Formatting Renderer

Source: https://www.tinymediamanager.org/docs/movies/renamer

Formats bitrate values into specified units like k, kbps, M, or Mbps. 'Mbps' is the default unit if none is specified.

```text
${movie.mediaInfoVideoBitrate;bitrate(Mbps)}
```

--------------------------------

### File Size Renderer

Source: https://www.tinymediamanager.org/docs/exporttemplates

Formats file sizes into human-readable units like K, M, or G. Supports various byte and unit notations.

```text
${movie;filesize(G)}
```

```text
${episode;filesize(G)}
```

--------------------------------

### Implement conditional expansion

Source: https://www.tinymediamanager.org/docs/jmte

Use if-else blocks to control text output based on model conditions, terminated by an end-expression.

```text
${if condition}
  text displayed if condition holds
${else}
  text displayed if condition does not hold
${end}
```

```text
${if !media.type="VIDEO"}
  text displayed if media.type is NOT "VIDEO"
${else}
  text displayed if media.type is "VIDEO"
${end}
```

--------------------------------

### TvShowEpisode Data Model

Source: https://www.tinymediamanager.org/docs/jmte

A comprehensive list of fields available for the TvShowEpisode entity and their associated access shortcuts.

```APIDOC
## TvShowEpisode Entity

### Description
This entity represents a TV show episode within TinyMediaManager, containing metadata, media information, and file-related attributes.

### Fields
| Type | Full Access | Shortcut |
|---|---|---|
| String | ${episode.CRC32} | ${crc32} |
| int | ${episode.absoluteNumber} | |
| List<Person> | ${episode.actors} | |
| String | ${episode.actorsAsString} | |
| int | ${episode.airedEpisode} | ${episodeNrAired} |
| int | ${episode.airedSeason} | |
| Map<String,MediaFile> | ${episode.artworkMap} | |
| Map<String,String> | ${episode.artworkUrls} | |
| String | ${episode.certification} | |
| List<Person> | ${episode.crew} | |
| String | ${episode.dataSource} | |
| Date | ${episode.dateAdded} | |
| String | ${episode.dateAddedAsString} | |
| Date | ${episode.dateAddedForUi} | |
| UUID | ${episode.dbId} | |
| String | ${episode.decadeLong} | |
| String | ${episode.decadeShort} | |
| List<Person> | ${episode.directors} | |
| String | ${episode.directorsAsString} | |
| boolean | ${episode.disc} | |
| int | ${episode.displayEpisode} | |
| int | ${episode.displaySeason} | |
| boolean | ${episode.dummy} | |
| boolean | ${episode.duplicate} | |
| int | ${episode.dvdEpisode} | ${episodeNrDvd} |
| int | ${episode.dvdSeason} | |
| String | ${episode.edition} | |
| String | ${episode.editionAsString} | |
| String | ${episode.englishTitle} | ${englishTitle} |
| int | ${episode.episode} | ${episodeNr} |
| MediaEpisodeGroup | ${episode.episodeGroup} | |
| MediaEpisodeNumber | ${episode.episodeNumber} | |
| List<MediaEpisodeNumber> | ${episode.episodeNumbers} | |
| Date | ${episode.firstAired} | |
| String | ${episode.firstAiredAsString} | |
| String | ${episode.firstAiredFormatted} | |
| String | ${episode.foldername} | |
| boolean | ${episode.hasNote} | |
| boolean | ${episode.hasSubtitles} | |
| Map<String,Object> | ${episode.ids} | |
| List<MediaFile> | ${episode.imagesToCache} | |
| String | ${episode.imdbId} | ${episodeImdb} |
| String | ${episode.lastScrapeLanguage} | |
| String | ${episode.lastScraperId} | |
| Date | ${episode.lastWatched} | |
| boolean | ${episode.locked} | |
| MediaFile | ${episode.mainFile} | |
| MediaFile | ${episode.mainVideoFile} | |
| List<MediaFile> | ${episode.mediaFiles} | |
| List<MediaFile> | ${episode.mediaFilesContainingAudioStreams} | |
| List<MediaFile> | ${episode.mediaFilesContainingSubtitles} | |
| List<MediaFile> | ${episode.mediaFilesRecursive} | |
| float | ${episode.mediaInfoAspectRatio} | |
| Float | ${episode.mediaInfoAspectRatio2} | |
| String | ${episode.mediaInfoAspectRatio2AsString} | ${aspectRatio2} |
| String | ${episode.mediaInfoAspectRatioAsString} | ${aspectRatio} |
| List<String> | ${episode.mediaInfoAudioChannelDotList} | ${audioChannelDotList} |
| List<String> | ${episode.mediaInfoAudioChannelList} | ${audioChannelList} |
| String | ${episode.mediaInfoAudioChannels} | ${audioChannels} |
| String | ${episode.mediaInfoAudioChannelsDot} | ${audioChannelsDot} |
| String | ${episode.mediaInfoAudioCodec} | ${audioCodec} |
| String | ${episode.mediaInfoAudioCodecAndChannels} | |
| List<String> | ${episode.mediaInfoAudioCodecList} | ${audioCodecList} |
| String | ${episode.mediaInfoAudioLanguage} | ${audioLanguage} |
| List<String> | ${episode.mediaInfoAudioLanguageList} | ${audioLanguageList} |
| String | ${episode.mediaInfoContainerFormat} | |
| double | ${episode.mediaInfoFrameRate} | |
| String | ${episode.mediaInfoSource} | |
| List<String> | ${episode.mediaInfoSubtitleCodecList} | |
| List<String> | ${episode.mediaInfoSubtitleLanguageList} | ${subtitleLanguageList} |
| int | ${episode.mediaInfoVideoBitDepth} | ${videoBitDepth} |
| int | ${episode.mediaInfoVideoBitrate} | |
| String | ${episode.mediaInfoVideoCodec} | ${videoCodec} |
| String | ${episode.mediaInfoVideoFormat} | ${videoFormat} |
| String | ${episode.mediaInfoVideoResolution} | ${videoResolution} |
| String | ${episode.mediaSource} | ${mediaSource} |
| boolean | ${episode.multiEpisode} | |
| boolean | ${episode.newlyAdded} | |
| String | ${episode.note} | ${note} |
| String | ${episode.originalBasename} | ${originalBasename} |
| String | ${episode.originalFilename} | ${originalFilename} |
| String | ${episode.originalTitle} | ${originalTitle} |
| String | ${episode.parent} | |
| String | ${episode.path} | |
| Path | ${episode.pathNIO} | |
| int | ${episode.playcount} | |
| String | ${episode.plot} | |
| String | ${episode.productionCompany} | |
| List<String> | ${episode.productionCompanyAsArray} | |
| MediaRating | ${episode.rating} | |
| Map<String,MediaRating> | ${episode.ratings} | |
| Date | ${episode.releaseDate} | |
| MediaEntityFilenameHistory | ${episode.renameHistory} | |
| int | ${episode.runtime} | |
| int | ${episode.runtimeFromMediaFiles} | |
| int | ${episode.runtimeFromMediaFilesInMinutes} | |
| boolean | ${episode.scraped} | |
| int | ${episode.season} | |
| boolean | ${episode.stacked} | |
| List<String> | ${episode.tags} | ${episodeTags} |
| String | ${episode.tagsAsString} | |
| String | ${episode.title} | ${title} |
| String | ${episode.titleForUi} | |
| String | ${episode.titleSortable} | ${titleSortable} |
| String | ${episode.tmdbId} | ${episodeTmdb} |
| long | ${episode.totalFilesize} | |
```

--------------------------------

### TV Show Fields and Shortcuts

Source: https://www.tinymediamanager.org/docs/jmte

This section lists the available fields for a TV Show entity and their corresponding shortcuts for quick access.

```APIDOC
## TV Show Entity

This documentation outlines the various fields and their access methods for TV Show entities.

### Fields and Shortcuts

- **actors** (List<Person>) - Full access: `${tvShow.actors}`
- **actorsAsString** (String) - Full access: `${tvShow.actorsAsString}`
- **artworkMap** (Map<String,MediaFile>) - Full access: `${tvShow.artworkMap}`
- **artworkUrls** (Map<String,String>) - Full access: `${tvShow.artworkUrls}`
- **certification** (String) - Full access: `${tvShow.certification}`, Shortcut: `${showCertification}`
- **country** (String) - Full access: `${tvShow.country}`
- **crew** (List<Person>) - Full access: `${tvShow.crew}`
- **dataSource** (String) - Full access: `${tvShow.dataSource}`
- **dateAdded** (Date) - Full access: `${tvShow.dateAdded}`
- **dateAddedAsString** (String) - Full access: `${tvShow.dateAddedAsString}`
- **dateAddedForUi** (Date) - Full access: `${tvShow.dateAddedForUi}`
- **dbId** (UUID) - Full access: `${tvShow.dbId}`
- **decadeLong** (String) - Full access: `${tvShow.decadeLong}`
- **decadeShort** (String) - Full access: `${tvShow.decadeShort}`
- **dummyEpisodeCount** (int) - Full access: `${tvShow.dummyEpisodeCount}`
- **dummyEpisodes** (List<TvShowEpisode>) - Full access: `${tvShow.dummyEpisodes}`
- **duplicate** (boolean) - Full access: `${tvShow.duplicate}`
- **duplicateEpisodes** (List<int[]>) - Full access: `${tvShow.duplicateEpisodes}`
- **englishTitle** (String) - Full access: `${tvShow.englishTitle}`, Shortcut: `${showEnglishTitle}`
- **episodeCount** (int) - Full access: `${tvShow.episodeCount}`
- **episodeGroup** (MediaEpisodeGroup) - Full access: `${tvShow.episodeGroup}`
- **episodeGroups** (List<MediaEpisodeGroup>) - Full access: `${tvShow.episodeGroups}`
- **episodes** (List<TvShowEpisode>) - Full access: `${tvShow.episodes}`
- **episodesForDisplay** (List<TvShowEpisode>) - Full access: `${tvShow.episodesForDisplay}`
- **episodesMediaFiles** (List<MediaFile>) - Full access: `${tvShow.episodesMediaFiles}`
- **episodesToScrape** (List<TvShowEpisode>) - Full access: `${tvShow.episodesToScrape}`
- **extraFanartUrls** (List<String>) - Full access: `${tvShow.extraFanartUrls}`
- **firstAired** (Date) - Full access: `${tvShow.firstAired}`
- **firstAiredAsString** (String) - Full access: `${tvShow.firstAiredAsString}`
- **firstAiredFormatted** (String) - Full access: `${tvShow.firstAiredFormatted}`
- **foldername** (String) - Full access: `${tvShow.foldername}`
- **genres** (List<String>) - Full access: `${tvShow.genres}`, Shortcut: `${showGenres}`
- **genresAsString** (String) - Full access: `${tvShow.genresAsString}`, Shortcut: `${showGenresAsString}`
- **hasEpisodeMetadata** (Boolean) - Full access: `${tvShow.hasEpisodeMetadata}`
- **hasMusicTheme** (Boolean) - Full access: `${tvShow.hasMusicTheme}`
- **hasNfoFile** (Boolean) - Full access: `${tvShow.hasNfoFile}`
- **hasNote** (Boolean) - Full access: `${tvShow.hasNote}`
- **hasSeasonAndEpisodeImages** (Boolean) - Full access: `${tvShow.hasSeasonAndEpisodeImages}`
- **hasTrailer** (Boolean) - Full access: `${tvShow.hasTrailer}`
- **ids** (Map<String,Object>) - Full access: `${tvShow.ids}`
- **imagesToCache** (List<MediaFile>) - Full access: `${tvShow.imagesToCache}`
- **imdbId** (String) - Full access: `${tvShow.imdbId}`, Shortcut: `${showImdb}`
- **lastScrapeLanguage** (String) - Full access: `${tvShow.lastScrapeLanguage}`
- **lastScraperId** (String) - Full access: `${tvShow.lastScraperId}`
- **lastWatched** (Date) - Full access: `${tvShow.lastWatched}`
- **locked** (boolean) - Full access: `${tvShow.locked}`
- **mainFile** (MediaFile) - Full access: `${tvShow.mainFile}`
- **mainVideoFile** (MediaFile) - Full access: `${tvShow.mainVideoFile}`
- **mediaFiles** (List<MediaFile>) - Full access: `${tvShow.mediaFiles}`
- **mediaFilesRecursive** (List<MediaFile>) - Full access: `${tvShow.mediaFilesRecursive}`
- **mediaInfoAspectRatio** (float) - Full access: `${tvShow.mediaInfoAspectRatio}`
- **mediaInfoAspectRatio2** (Float) - Full access: `${tvShow.mediaInfoAspectRatio2}`
- **mediaInfoAudioChannelDotList** (List<String>) - Full access: `${tvShow.mediaInfoAudioChannelDotList}`
- **mediaInfoAudioChannelList** (List<String>) - Full access: `${tvShow.mediaInfoAudioChannelList}`
- **mediaInfoAudioChannels** (String) - Full access: `${tvShow.mediaInfoAudioChannels}`
- **mediaInfoAudioChannelsDot** (String) - Full access: `${tvShow.mediaInfoAudioChannelsDot}`
- **mediaInfoAudioCodec** (String) - Full access: `${tvShow.mediaInfoAudioCodec}`
- **mediaInfoAudioCodecList** (List<String>) - Full access: `${tvShow.mediaInfoAudioCodecList}`
- **mediaInfoAudioLanguage** (String) - Full access: `${tvShow.mediaInfoAudioLanguage}`
- **mediaInfoAudioLanguageList** (List<String>) - Full access: `${tvShow.mediaInfoAudioLanguageList}`
- **mediaInfoContainerFormat** (String) - Full access: `${tvShow.mediaInfoContainerFormat}`
- **mediaInfoFrameRate** (double) - Full access: `${tvShow.mediaInfoFrameRate}`
- **mediaInfoSource** (String) - Full access: `${tvShow.mediaInfoSource}`
- **mediaInfoSubtitleCodecList** (List<String>) - Full access: `${tvShow.mediaInfoSubtitleCodecList}`
- **mediaInfoSubtitleLanguageList** (List<String>) - Full access: `${tvShow.mediaInfoSubtitleLanguageList}`
- **mediaInfoVideoBitDepth** (int) - Full access: `${tvShow.mediaInfoVideoBitDepth}`
- **mediaInfoVideoCodec** (String) - Full access: `${tvShow.mediaInfoVideoCodec}`
- **mediaInfoVideoFormat** (String) - Full access: `${tvShow.mediaInfoVideoFormat}`
- **mediaInfoVideoResolution** (String) - Full access: `${tvShow.mediaInfoVideoResolution}`
- **newlyAdded** (boolean) - Full access: `${tvShow.newlyAdded}`
- **note** (String) - Full access: `${tvShow.note}`, Shortcut: `${showNote}`
- **originalBasename** (String) - Full access: `${tvShow.originalBasename}`
- **originalFilename** (String) - Full access: `${tvShow.originalFilename}`
- **originalTitle** (String) - Full access: `${tvShow.originalTitle}`, Shortcut: `${showOriginalTitle}`
- **parent** (String) - Full access: `${tvShow.parent}`, Shortcut: `${parent}`
- **path** (String) - Full access: `${tvShow.path}`
- **pathNIO** (Path) - Full access: `${tvShow.pathNIO}`
- **plot** (String) - Full access: `${tvShow.plot}`
- **productionCompany** (String) - Full access: `${tvShow.productionCompany}`, Shortcut: `${showProductionCompany}`
- **productionCompanyAsArray** (List<String>) - Full access: `${tvShow.productionCompanyAsArray}`, Shortcut: `${showProductionCompanyAsArray}`
- **rating** (MediaRating) - Full access: `${tvShow.rating}`
- **ratings** (Map<String,MediaRating>) - Full access: `${tvShow.ratings}`
- **releaseDate** (Date) - Full access: `${tvShow.releaseDate}`
- **renameHistory** (MediaEntityFilenameHistory) - Full access: `${tvShow.renameHistory}`
- **runtime** (int) - Full access: `${tvShow.runtime}`
- **runtimeOfEpisodes** (int) - Full access: `${tvShow.runtimeOfEpisodes}`
- **scraped** (boolean) - Full access: `${tvShow.scraped}`
- **seasonCount** (int) - Full access: `${tvShow.seasonCount}`
- **seasonMediaFiles** (List<MediaFile>) - Full access: `${tvShow.seasonMediaFiles}`
- **seasonNames** (Map<String,Map<Integer,String>>) - Full access: `${tvShow.seasonNames}`
- **seasonOverviews** (Map<String,Map<Integer,String>>) - Full access: `${tvShow.seasonOverviews}`
- **seasons** (List<TvShowSeason>) - Full access: `${tvShow.seasons}`
- **sortTitle** (String) - Full access: `${tvShow.sortTitle}`
- **status** (String) - Full access: `${tvShow.status}`, Shortcut: `${showStatus}`
- **tags** (List<String>) - Full access: `${tvShow.tags}`, Shortcut: `${showTags}`
- **tagsAsString** (String) - Full access: `${tvShow.tagsAsString}`
- **title** (String) - Full access: `${tvShow.title}`, Shortcut: `${showTitle}`
- **titleSortable** (String) - Full access: `${tvShow.titleSortable}`, Shortcut: `${showTitleSortable}`
- **tmdbId** (int) - Full access: `${tvShow.tmdbId}`, Shortcut: `${showTmdb}`
- **top250** (int) - Full access: `${tvShow.top250}`
- **totalFilesize** (long) - Full access: `${tvShow.totalFilesize}`
- **trailer** (List<MediaTrailer>) - Full access: `${tvShow.trailer}`
- **traktId** (int) - Full access: `${tvShow.traktId}`
- **tvdbId** (int) - Full access: `${tvShow.tvdbId}`, Shortcut: `${showTvdb}`
- **userRating** (MediaRating) - Full access: `${tvShow.userRating}`
- **videoFilesize** (long) - Full access: `${tvShow.videoFilesize}`
- **videoHDRFormat** (String) - Full access: `${tvShow.videoHDRFormat}`
- **videoIn3D** (boolean) - Full access: `${tvShow.videoIn3D}`
- **watched** (boolean) - Full access: `${tvShow.watched}`
- **year** (int) - Full access: `${tvShow.year}`, Shortcut: `${showYear}`
```

--------------------------------

### Export Movies to Template

Source: https://www.tinymediamanager.org/docs/http-api

Use this action to export movies using a specified template and export path. Ensure the template name corresponds to an existing template folder.

```json
{
  "action": "export",
  "scope": { "name": "all" },
  "args": { "template": "mytemplate", "exportPath": "/tmp/export" }
}
```

--------------------------------

### Apply framerate renderer

Source: https://www.tinymediamanager.org/docs/tvshows/renamer

Format video framerate, optionally rounding to an integer.

```text
${episode.mediaInfoFrameRate;framerate}
```

```text
${framerate(round)}
```

```text
${episode.mediaInfoFrameRate;framerate(round)}
```

--------------------------------

### Chaining Renderers

Source: https://www.tinymediamanager.org/docs/movies/renamer

Allows multiple renderers to be applied sequentially to a single value. The output of one renderer becomes the input for the next.

```text
${movie.title;chain(replace(umlauts.csv);lower)}
```

--------------------------------

### Filesize Formatting Renderer

Source: https://www.tinymediamanager.org/docs/movies/renamer

Formats file sizes into human-readable units (K, M, G, etc.). You can specify the desired unit; 'G' is the default if none is provided.

```text
${movie.videofilesize;filesize(G)}
```

--------------------------------

### Extras Subfolder Structure

Source: https://www.tinymediamanager.org/docs/movies/multi-version

Place the main movie version in the root folder and secondary versions in an 'extras' subfolder. tinyMediaManager will ignore files within the extras directory.

```text
H:\movies
 300 (2006)
     300 (2006).mkv
     movie.nfo
     fanart.jpg
     poster.jpg
     extras
         300 (2006) - 4k.mkv
         300 (2006) - extended cut.avi
 ...
```

--------------------------------

### Separate Folder Structure for Movie Versions

Source: https://www.tinymediamanager.org/docs/movies/multi-version

Organize each movie version into its own unique folder to ensure full compatibility with tinyMediaManager features like scraping and renaming.

```text
H:\movies
 300 (2006) - 1080p
     300 (2006) - 1080p.mkv
     movie.nfo
     fanart.jpg
     poster.jpg
     sample
         sample.avi
 300 (2006) - 4k
     300 (2006) - 4k.mkv
     movie.nfo
     fanart.jpg
     poster.jpg
 300 (2006) - extended cut
     extended cut.avi
     movie.nfo
     fanart.jpg
     poster.jpg
 ...
```

--------------------------------

### Fetch Movie Subtitles from First Data Source with cURL

Source: https://www.tinymediamanager.org/docs/http-api

Fetches French subtitles for movies from the first data source. Replace '<your-api-key>' with your actual API key.

```bash
curl -d '{"action":"downloadSubtitle", "scope":{"name":"dataSource", "args":[0]}, "args":{"language":"fr"}}' \
  -H "Content-Type: application/json" \
  -H "api-key: <your-api-key>" \
  -X POST http://localhost:7878/api/movie

```

--------------------------------

### Bitrate Renderer

Source: https://www.tinymediamanager.org/docs/exporttemplates

Formats bitrate values into specified units such as k, M, or Mbps. Mbps is the default unit if none is specified.

```text
${movie.mediaInfoVideoBitrate;bitrate(Mbps)}
```

```text
${episode.mediaInfoVideoBitrate;bitrate(Mbps)}
```

--------------------------------

### Docker Compose for TinyMediaManager

Source: https://www.tinymediamanager.org/docs/docker

This Docker Compose file defines a TinyMediaManager service. It configures environment variables, volume mounts for data and media, port mappings, restart policy, and logging options for persistent and managed deployment.

```yaml
---
version: "2.1"
services:
  tinymediamanager:
    image: tinymediamanager/tinymediamanager:latest
    container_name: tinymediamanager
    environment:
      - USER_ID=1000
      - GROUP_ID=100
      - ALLOW_DIRECT_VNC=true
      - LC_ALL=en_US.UTF-8 # force UTF8
      - LANG=en_US.UTF-8   # force UTF8
      - PASSWORD=<password>
    volumes:
      - </path/to/local/data/>:/data
      - </path/to/movies>:/media/movies
      - </path/to/addons/>:/media/tv_shows
    ports:
      - 4000:4000 # Webinterface
      - 5900:5900 # VNC port      
    restart: unless-stopped
    logging: # restrict log size
      driver: "json-file"
      options:
        max-file: "5"   # number of files or file count
        max-size: "20m" # file size      


```

--------------------------------

### Download Missing Trailers and Subtitles for TV Shows by Path with cURL

Source: https://www.tinymediamanager.org/docs/http-api

This cURL command downloads missing trailers and German subtitles for TV shows located at a specific path. Replace '<your-api-key>' with your actual API key.

```bash
curl -d [
  {"action": "downloadTrailer", "scope": {"name": "path", "args": ["/media/tvshows"]}, "args": {"onlyMissing": true}},
  {"action": "downloadSubtitle", "scope": {"name": "path", "args": ["/media/tvshows"]}, "args": {"language": "de", "onlyMissing": true}}
] \
  -H "Content-Type: application/json" \
  -H "api-key: <your-api-key>" \
  -X POST http://localhost:7878/api/tvshow

```

--------------------------------

### Update All Movie Data Sources with cURL

Source: https://www.tinymediamanager.org/docs/http-api

Use this cURL command to update all movie data sources. Ensure you replace '<your-api-key>' with your actual API key.

```bash
curl -d '{"action":"update", "scope":{"name":"all"}}' \
  -H "Content-Type: application/json" \
  -H "api-key: <your-api-key>" \
  -X POST http://localhost:7878/api/movie

```

--------------------------------

### Set environment variables

Source: https://www.tinymediamanager.org/docs/start-parameters

Define specific environment options required for the JVM execution environment.

```yaml
env:
  - "_JAVA_AWT_WM_NONREPARENTING=1"
```

--------------------------------

### Apply replacement and split renderers

Source: https://www.tinymediamanager.org/docs/tvshows/renamer

Perform search-and-replace operations or extract specific items from lists.

```text
${episode.title;replace(umlauts.csv)}
```

```text
${episode.title;replace(x264,h264)}
```

```text
${tvShow.genres;split(1)}
```

```text
${tvShow.genres;split(1,3)}
```

--------------------------------

### Fetch Ratings for All Movies with cURL

Source: https://www.tinymediamanager.org/docs/http-api

This cURL command fetches ratings for all movies. Replace '<your-api-key>' with your actual API key.

```bash
curl -d '[{"action":"fetchRatings", "scope":{"name":"all"}}]' \
  -H "Content-Type: application/json" \
  -H "api-key: <your-api-key>" \
  -X POST http://localhost:7878/api/movie

```

--------------------------------

### Apply array renderers

Source: https://www.tinymediamanager.org/docs/tvshows/renamer

Renderers for formatting lists and ensuring unique values.

```text
${tvShow.genres;array}
```

```text
${episode.mediaInfoAudioLanguageList;uniqueArray}
```
Tokens:
Raw