tinyMediaManager offers a command line interface (CLI) to execute common tasks without the user interface (e.g. on headless servers).
tinyMediaManager v4/v5
To start tinyMediaManager via the command line you can use the dedicated executable for command line arguments:
- Windows: tinyMediaManagerCMD.exe
- Linux: tinyMediaManager
- macOS: tinyMediaManager (note: the executable is inside the tinyMediaManager.app, in the subfolder
Contents/macOS/)
Execute with the -h parameter to display the syntax. There are three parameters for the main command tinyMediaManager:
| Parameter | |
|---|---|
-h |
display the help and exit |
--update |
update tinyMediaManager from the command line) |
-V |
display the version and exit |
Movie module
the movie subcommand offers various tasks for the movie module (tinyMediaManager movie):
| Parameter | |
|---|---|
-h |
display the help and exit |
-u, --updateAll |
Scan all data sources for new content |
--updateX=<index> |
Scan the given data sources for new content. The indices are in the same order as in the UI/settings |
-n, --scrapeNew |
Scrape new movies (found with the update options) |
--scrapeUnscraped |
Scrape all unscraped movies |
--scrapeAll |
Scrape all movies |
-t, --downloadTrailer |
Download missing trailers |
-s, --downloadSubtitles |
Download missing subtitles |
-sL, --subtitleLanguage=<language> |
Desired subtitle language(s) (optional) |
-r, --renameNew |
Rename & cleanup all movies from former scrape command |
--renameAll |
Rename & cleanup all movies |
-e, --export |
Export your movie list using a specified template |
-eT, --exportTemplate=<template> |
The export template to use. Use the folder name from the templates folder |
-eP, --exportPath=<path> |
The path to export your movie list to |
-w, --rewriteNFO |
Rewrite NFO files of all movies |
-d, --ardNew |
Detect aspect ratio of new movies (found with the update options) |
-dA, --ardAll |
Detect aspect ratio of all movies |
-V |
display the version and exit |
-mi |
reload mediainfo data (v4.3.6+) |
-mix |
reload mediainfo data - ignore XML (v4.3.6+) |
Examples
tinyMediaManager movie -u -n -r to find/scrape and rename new movies
tinyMediaManager movie -t -s to download missing trailer/subtitles
tinyMediaManager movie -e -eT=ExcelXml -eP=/user/export/movies to export the movie list with the ExcelXml template to /user/export/movies
TV show module
the tvshow subcommand offers various tasks for the TV show module (tinyMediaManager tvshow):
| Parameter | |
|---|---|
-h |
display the help and exit |
-u, --updateAll |
Scan all data sources for new content |
--updateX=<index> |
Scan the given data sources for new content. The indices are in the same order as in the UI/settings |
-n, --scrapeNew |
Scrape new TV shows/episodes (found with the update options) |
--scrapeUnscraped |
Scrape all unscraped TV shows/episodes |
--scrapeAll |
Scrape all TV shows/episodes |
-t, --downloadTrailer |
Download missing trailers |
-s, --downloadSubtitles |
Download missing subtitles |
-sL, --subtitleLanguage=<language> |
Desired subtitle language(s) (optional) |
-r, --renameNew |
Rename & cleanup all TV shows/episodes from former scrape command |
--renameAll |
Rename & cleanup all TV shows/episodes |
-e, --export |
Export your TV show list using a specified template |
-eT, --exportTemplate=<template> |
The export template to use. Use the folder name from the templates folder |
-eP, --exportPath=<path> |
The path to export your TV show list to |
-w, --rewriteNFO |
Rewrite NFO files of all TV shows/episodes |
-d, --ardNew |
Detect aspect ratio of new TV shows/episodes (found with the update options) |
-dA, --ardAll |
Detect aspect ratio of all TV shows/episodes |
-V |
display the version and exit |
-mi |
reload mediainfo data (v4.3.6+) |
-mix |
reload mediainfo data - ignore XML (v4.3.6+) |
Examples
tinyMediaManager tvshow -u -n -r to find/scrape and rename new TV shows/episodes
tinyMediaManager tvshow -t -s to download missing trailer/subtitles
tinyMediaManager tvshow -e -eT=TvShowDetailExampleXml -eP=/user/export/tv to export the TV show list with the TvShowDetailExampleXml template to /user/export/tv
tinyMediaManager v3
To start tinyMediaManager via the command line you can use the dedicated executable/shellscript for command line arguments:
- Windows: tinyMediaManagerCMD.exe
- Linux: tinyMediaManagerCMD.sh
- macOS: tinyMediaManagerCMD-OSX.sh (note: the shellscript is inside the tinyMediaManager.app, in the subfolder
Contents/Resources/Java)
Execute without any parameter to display the syntax.
| Parameter | |
|---|---|
-updateMovies |
update all movie datasources and add new movies/files to the database |
-updateMoviesX |
replace X with 1-9 - just updates a single movie datasource; ordering like GUI |
-updateTv |
update all TvShow datasources and add new TvShows/episodes to the database |
-updateTvX |
replace X with 1-9 - just updates a single TvShow datasource; ordering like GUI |
-update |
update all (short for ‘-updateMovies -updateTv’) |
-scrapeNew |
auto-scrape (force best match) new found movies/TvShows/episodes from former update(s) |
-scrapeUnscraped |
scrape all unscraped movies (independent from update) |
-scrapeAll |
ALL movies/TvShows/episodes, whether they have already been scraped or not |
-rename |
rename & cleanup all the movies/TvShows/episodes from former scrape command |
-config \<file.xml\> |
specify an alternative configuration xml file in the data folder |
-export \<template\> \<dir\> |
exports your complete movie/tv library with specified template to dir |
-checkFiles |
does a physical check, if all files in DB are existent on filesystem (might take long!) |
so a tinyMediaManagerCMD.exe -update -scrapeNew -renameNew perfectly cleans your new and updated items :)
NOTE: if you start tinyMediaManager this way, you won’t get an UI or updates! You can update tinyMediaManager either by starting the UI or starting the updater executable for your system:
- Windows: tinyMediaManagerCMDUpd.exe
- Linux: tinyMediaManagerUpdaterCMD.sh
- macOS: tinyMediaManagerUpdaterCMD-OSX.sh (note: the shellscript is inside the tinyMediaManager.app, in the subfolder
Contents/Resources/Java)