TV Shows

Media Center Presets

tinyMediaManager has presets for various media centers. By pressing the button for your desired media center, all affected settings will be set to the default for the chosen media center.

Currently we support presets for:

  • Kodi (17+)
  • XBMC/Kodi (<17)
  • Jellyfin
  • Emby
  • Plex
  • MediaPortal 1.x (Moving Pictures and MyVideo)
  • MediaPortal 2.x

Automatic Tasks

  • Automatic rename: you can let tinyMediaManager automatically rename your TV shows/episodes after they have been scraped
  • Automatic aspect ratio detection: tinyMediaManager automatically detects the aspect ratio of TV shows after they have been scraped
  • Automatic sync with if you have enabled access to, you are able to automatically sync your media library and watched state with Is that option is disabled, you have to manually trigger the synchronization process
  • Automatic update on startup: you can let tinyMediaManager update all your TV show data sources on startup

Misc. Settings

  • Extract meta data (via mediainfo) on “update data sources” if no NFO is available: if there is no NFO available you can let mediainfo try to extract embedded metadata from your episode files
  • Extract missing artwork from VSMETA files on “update data sources”: VSMETA files can contain artwork. By activating this option, tinyMediaManager extracts missing artwork directly from the VSMETA files when scanning for new content
  • Build image cache on import: when importing new TV shows/episodes into tinyMediaManager you can create the image cache on the fly (only available when the image cache is enabled in the general settings). Caution: building the image cache will take a while

UI Settings

UI Settings

  • Show the following artwork types in the detail view: to choose which kind of artwork should be displayed in the TV show/season/episode detail tab
    • Poster/Season poster
    • Fanart
    • Banner
    • Thumb
    • Clearlogo
  • Display missing episodes: tinyMediaManager is able to mix in missing episode if the TV show has been scraped previously (to know which episodes are available). When activating this option, the missing episodes will be mixed into the TV show list.
    • Display missing specials: Also display missing specials (episodes from season 0)
  • TV show table tooltips: using this setting you can activate/suppress tooltips in the TV show table
  • Metadata completeness: here you can choose which metadata fields will be checked for the green checkmark in the TV show table for completeness
  • Artwork completeness: here you can choose which artwork files will be checked for the green checkmark in the TV show table for completeness
  • Fall back to TV show artwork: if there is no artwork for seasons, you can fall back to the TV show artwork
  • Preferred rating: tinyMediaManager supportes multiple ratings for every TV show/episode. The rating source in this setting indicates which rating source should be preferred for being used in the UI.


  • TV show quickfilter: to choose which data of the TV show should be used when searching in the filter box (above the TV show table). Possible fields to search at the moment:
    • Node (the element in the first column)
    • Title
    • Original title
    • Note
  • Universal text filter: in addition to the quickfilter (above the TV show table), there is an universal text filter in the filter dialog. You can choose which fields will be used for the universal filter
  • Persist UI filters: remember the last active UI filter (this will be loaded on the next start of tinyMediaManager)

Data Sources

Data Sources

This is the core setting of the TV show section. Every folder specified in this list will be searched for TV show/episode files. While the TV show importer tries to parse out as much as possible (seasons, episodes, names..) you have to follow one strict rule: the folders inside the data source have to be the root folders for your tv shows – each folder in your data source contains exactly one TV show. Further nesting is allowed and should be no problem for the importer, as well as different file name notations:

    Breaking Bad
        Season 2

Since we have a large rule set of regular expressions to detect episode/season number, there are still some notations which are problematic. The best results are always with a filename containing season and episode information with the following scheme SxxExx, along with a directory structure like:

<TV show folder>
    Season 1
    Season 2

tinyMediaManager (and Java) supports accessing local drives and network shares, but is unable to perform mount/logon actions. You have to connect to external drives from your system before starting an update data sources in tinyMediaManager!

  • Imported episodes are in DVD order: When importing a new episode, tinyMediaManager has to decide whether the detected season/episode number is in aired order or DVD order. With this setting you can switch the default.

Exclude Folder(s) from Scan

Every folder in this list will be excluded from a scan. You can also put a file called .tmmignore into every folder you wish to have excluded from the scan.

Bad Words

Words from this list will be removed from file names while parsing for the title. This comes in handy if you some special words like release groups in your file names.

NFO Settings

  • NFO format: There is support for Kodi and MediaPortal NFO formats. Choosing the right format affects how the data is written to the NFO files. You will find all compatible NFO formats here.
  • NFO file naming: You can choose between different file names for the NFO files. If no NFO file name is selected, tinyMediaManager does not write any NFO files.
    • TV shows:
      • tvshow.nfo
    • Episodes:
      • <episode filename>.nfo
  • Source for <dateadded>: there are several sources where you can retrieve the date added for your TV shows/episodes. This option lets you specify which one will be written into the NFO.
  • NFO language: The language in which texts like genre names should be written to the NFO file
  • Certification format: The format of the data in the <certification> tag.
  • Write <episodeguide> tag: Several versions of Kodi may have problems if that tag is available in the NFO. Using this setting you can suppress writing this tag.
  • Write <enddate> tag: Write the date of the last aired episode to the NFO if the show has the status ENDED.
  • Include all actors/guests into the TV show NFO: Several media centers expect all possible actors (from episodes) to the contained in the TV show NFO. This option will enable writing of all actors/guests into the TV show NFO.
  • Only include the first studio: Some Kodi skins only support one studio in the NFO to display the studio logo. With this setting tinyMediaManager will only include the first studio into the NFO.
  • Add <lockdata>true</lockdata> to the NFO: When writing NFO files with this tag, (at least) Emby is being prevented from modifying tinyMediaManager created NFO files
  • Write clean NFO: If this option is activated, tinyMediaManager write a clean NFO file without embedding unknown/unsupported data from existing NFO files.


In this list you can choose your preferred metadata scraper from a list of all available scrapers. At the moment tinyMediaManager offers scrapers for the following meta data sources:


And additionally there is one meta scrapers which offer enhanced data:

  • Universal scraper: with this scraper you can combine results from various other scrapers to create an individual scraping result for your needs

You will find a detailed description of those scrapers on the scraper description page.

Scraper Options

Advanced Options

  • Preferred language: Choose the preferred language for scraping (for localized content like title, tagline and plot). Not all scrapers offer localized content, but tinyMediaManager tries to find localized in this language.
  • Certification country: TV show certifications are available for several countries. You can choose for which country tinyMediaManager should try to get the certification.
  • Country for release date: Release dates can vary in different countries. You can choose which country to prefer when scraping release dates.
  • Capitalize first letter of every word in title and original title: As the option itself tells - when activating this, tinyMediaManager puts the found title/original title to Title Case.

Metadata Scrape Defaults

In this section you can set which types of metadata should be scraped per default. You can always override this in the scrape dialogs in tinyMediaManager.

The command line version of tinyMediaManager completely relies on this setting.


  • Automatically scrape images: with this option enabled, tinyMediaManager tries to find the best image files from the artwork scrapers according to your settings in the Images section.


Artwork Scraper

In this list you can choose the artwork scrapers from a list of all available scrapers. You can activate multiple scrapers here to get the best possible artwork. At the moment tinyMediaManager offers scrapers for the following artwork sources:

  • FFmpeg

Advanced Options

  • Preferred language: Get the artwork with text in the given language. - indicates that tinyMediaManager should look for artwork without any texts on it. Please note that not all artwork sources offer the needed information for this to work (it is known that and work with this setting).
  • Poster size: Choose the preferred poster size. tinyMediaManager will try to get the poster in this size (and the chosen language). If it’s not available an image from the other sizes will be taken.
  • Fanart size: Choose the preferred fanart size. tinyMediaManager will try to get the fanart in this size (and the chosen language). If it’s not available an image from the other sizes will be taken.
  • Download actor images to .actors: Kodi supports reading of actor images from the (hidden) folder .actors inside the TV show folder. If you enable this option, all available actor images will be downloaded to this folder upon scraping the TV show.
  • Use the name “Special” for season 0: instead of writing season 0 files, the term specials will be used
  • Enable extrafanart: This option allows you to store multiple fanarts to the extrafanarts folder inside the TV show folder.
  • Maximum of downloaded images: in addition to choose the extrafanarts by hand (image chooser dialog) you can automatically download extrafanarts. This option let you choose how much extrafanarts will be downloaded per TV show.

Artwork Filenames

Available artwork settings for TV shows:

  • Poster
    • poster.ext
    • folder.ext
  • Fanart
    • fanart.ext
  • Banner
    • banner.ext
  • Clearart
    • clearart.ext
  • Thumb
    • thumb.ext
    • landscape.ext
  • Logo
    • logo.ext
  • Clearlogo
    • clearlogo.ext
  • Disc art
    • disc.ext
    • discart.ext
  • Characterart
    • characterart.ext
  • Keyart
    • keyart.ext

Available artwork settings for seasons:

  • Season poster
    • seasonXX-poster.ext
    • <season folder>/seasonXX.ext
    • <season folder>/folder.ext
  • Season banner
    • seasonXX-banner.ext
    • <season folder>/seasonXX-banner.ext
  • Season thumb
    • seasonXX-thumb
    • <season folder>/seasonXX-thumb.ext
    • seasonXX-landscape
    • <season folder>/seasonXX-landscape.ext

XX stands for the season number.

Available artwork settings for episodes:

  • Episode thumb
    • <episode filename>-thumb.ext
    • <episode filename>.ext
    • <episode filename>.tbn

.ext stands for the image format of the artwork file which should be either .png, .jpg or .gif.


In this list you can enable all wanted trailer scrapers from a list of all available scrapers. You can activate multiple scrapers here to get the best possible trailers. At the moment tinyMediaManager offers scrapers for the following trailer sources:


Advanced Options

  • Use yt-dlp for trailer downloading: You can choose to use the external tool yt-dlp for downloading your trailers from YT. To use this, you need to download the yt-dlp from their Github repository, create a subfolder called addons in your content folder (the folder where your data is) and put the yt-dlp executable into this folder.

You need to use the correct file name for the executable for being detected: yt-dlp.exe for Windows and yt-dlp for macOS/Linux. Otherwise tinyMediaManager is not able to find the executable.

  • Use preferred trailer settings: Rather than choosing the first available trailer, you can set your preferred trailer source (e.g. Youtube) and trailer quality (e.g. 1080p).
  • Automatic trailer download: Upon scraping, also download the chosen trailer to your TV show folder if no local trailer has been found
  • Trailer file naming: You can set the desired trailer filename. If no desired filename is set, no trailer will be downloaded.
    • tvshow-trailer.ext
    • <TV show title>-trailer.ext
    • trailers/<TV show title>-trailer.ext


In this list you can enable all wanted subtitle scrapers from a list of all available scrapers. You can activate multiple scrapers here to get the best possible subtitles. At the moment tinyMediaManager offers scrapers for the following subtitle sources:


Advanced Options

  • Preferred language: The preferred language for subtitle download.
  • Force downloading of best subtitle: If there is no match by the file hash, try to download the best-matching subtitle
  • Subtitle language style: Save subtitle files with the given language style in their filename.


tinyMediaManager offers a powerful renamer to rename your TV shows and all associated files to your desired folder-/filenames. While there is almost nothing you can’t do with the renamer, it has still one big restriction: you can only rename the TV shows inside its own data source. Renaming it to a destination which is not inside the own data source is not supported.

Renamer Pattern

Folder name, Season folder name and Episode filename: Choose the desired folder name(s) and filename for renaming. Here you can enter fixed parts of the name and dynamic ones. You will find a list of all available tokens for building up dynamic names beneath the settings along with examples of your media library. With leaving the folder name/filename empty, the renamer will skip the name generation for the empty part.

You will find more details of the TV show renamer in the corresponding docs.

Advanced Options

  • Automatic rename: you can let tinyMediaManager automatically rename your TV shows/episodes after they have been scraped
  • Replace spaces in the TV show folder name with / Replace spaces in the season folder name with / Replace spaces in the filename with: You can replace all spaces with either underscores, dots or dashes by activation this option.
  • Replace colons with: Since colons are illegal characters in folder names and filenames, tinyMediaManager offers you to choose how they should be replaced.
  • Replace non ASCII characters with their basic ASCII equivalents: Some file systems might need to have ASCII conform file names - by activating this option tinyMediaManager tries to convert non ASCII characters into a similar ASCII character (e.g. Ä - Ae; ß - ss, …).
  • First character number replacement: If you use the renderer ;first (like in ${title;first}) and the first character would be a digit, replace the digit with the given character.


Here you can see the renamer results using an example from your library.

Post processing

You can trigger external tools from within tinyMediaManager to do some work, which is not doable in tinyMediaManager itself. In this section you are able to maintain the access to different external tools along with all needed parameters. To access data from your TV shows/episodes which may be passed to the external tools, you can use JMTE syntax.

You will find more details about post processing in the corresponding docs.