tinyMediaManager Rescrape: Keep Custom Metadata and Artwork
Rescrape movies in tinyMediaManager while protecting custom plots and posters. Choose fields, check the NFO, and back up both app data and library files.
To fill missing movie details in tinyMediaManager, select a small set of movies, review the scrape fields, and enable Do not overwrite existing data. That setting is useful when you want to keep a plot you wrote or artwork you chose. It also keeps existing mistakes, so decide what needs changing before starting.
The workflow below focuses on movies that already have the correct identity. The tinyMediaManager behavior is drawn from its official documentation; the backup plan and small-batch checks are our recommendations.
Choose between filling gaps and correcting data
First, open the movie and check its title, year and provider ID. tinyMediaManager's Details panel includes IDs with links to common providers, while Media Files lists the video, NFO and artwork. Use those views to identify the exact record and files you are about to change. See the movie-panel documentation.
There are two different jobs:
- Fill a gap: the movie is correct, but its tagline or another field is empty. Preserve existing values and request the missing detail.
- Correct a value: the movie is wrong, or an existing field is outdated. Keeping every existing value will prevent the intended correction.
Do not combine those jobs in one large selection. If a remake is matched to the original film, first confirm the intended provider entry. A missing-fields scrape can otherwise combine your old text with new details about the wrong movie.
For a correctly matched movie with one inaccurate field, consider editing that field by hand. A full rescrape may be more work to review than the problem warrants.
Back up the app data and the sidecar files
tinyMediaManager's FAQ says scraping can create or overwrite NFO and artwork files. It also documents daily backups of the database and settings, with a restore into the app's data folder. Those are different things to recover. See the file-change and backup FAQ.
Before the first batch, our recommendation is to:
- Use Tools → Open data folder to locate the app data, then finish current tasks and close tinyMediaManager before copying it. Keep a dated copy, or confirm you have a suitable backup from before the changes.
- Separately copy the selected movies' NFO and local artwork files, preserving their folder names. A storage snapshot can serve the same purpose. Keep the backup outside any scanned media source.
- Save a short note of the current file paths, scrape options and custom values you care about.
Pause other tools that write to those same folders during the test. Otherwise, a changed poster or NFO may come from another app and make the result hard to explain.
Check Automatic rename before rescraping: tinyMediaManager can rename movies after a scrape. Turn that off for this metadata-only pass if you want filenames to stay put. Its movie settings document this option. Treat any post-processing scripts you have configured as separate changes to review too.
Check the active scrape options
tinyMediaManager's toolbar distinguishes Update sources, which discovers media and changes to the folder structure, from Search & Scrape, which gets online metadata. Rename & Cleanup is another action. Clicking an icon runs its default action; the text beneath it opens secondary actions. See the toolbar guide.
For the first pass:
- Select one correctly matched movie in the movie list.
- Open Search & Scrape and inspect the search or scrape dialog before confirming.
- Keep the intended movie selected. Check its year and identity against the record you reviewed earlier.
- Request only the metadata you need. Under Metadata Scrape Defaults, tinyMediaManager lets you choose field types, and the scrape dialogs can override those defaults.
- Enable Do not overwrite existing data for a missing-fields pass. Leave artwork scraping out of this pass if your task is text only.
The current movie-settings reference describes the no-overwrite option as filling missing fields. Its original feature announcement also covers retaining existing images and trailers. That protection is not a backup, and it does not prevent other actions such as renaming.
Version 5.3.5 added an option to force metadata overwrites, according to the official changelog. Check the choices in your installed version rather than copying the position of a checkbox from an older screenshot. For this preserve-existing-data task, do not select an option that forces overwrites.
Command-line scraping relies on the saved defaults. Review those before automating the job; the options you used in an interactive dialog may differ.
Worked example: add a tagline, keep the plot and poster
Suppose your movie has a custom plot you wrote to avoid spoilers, a poster you prefer, and an empty tagline. The table below uses the fictional title North Pier (2021). Use a real, verified provider record when trying the workflow.
| Item | Before the scrape | Intended result |
|---|---|---|
| Movie identity | Correct title, year and provider ID | Same record |
| Plot | Your spoiler-free description | Keep the exact text |
| Tagline | Empty | Fill from the selected provider, if available |
| Poster | Your chosen local image | Keep the same file |
| Video path | Movies/North Pier (2021)/North Pier (2021).mkv |
Unchanged |
Back up this movie's sidecars, select it alone, request the tagline and keep no-overwrite protection enabled. Check the result against the table after the task finishes.
An empty tagline afterward is not a reason to turn off every safeguard. Check whether the provider has one in your chosen language and whether that field was selected. An unavailable value can remain empty even when the workflow is correct.
Now consider a different case: the tagline contains old text that you want replaced. A fill-missing-fields pass is the wrong choice for that job. Review that movie separately, restrict the change to the intended field, and keep a copy of the old value. Correcting a single field should not require accepting every other provider suggestion.
Verify the app, the files and the player
Use a few concrete checks before expanding to more movies:
- Reopen the movie's details and compare the custom text with your saved note. Check the provider ID as well as the display title.
- Inspect the actual NFO beside the video. Confirm the intended value is present and the values you meant to keep survived. A changed timestamp alone proves very little.
- Open the local poster file and compare it with the backup. For exact preservation, compare file contents or checksums rather than judging only the thumbnail.
- Confirm the video still has the same name and path. If you had external subtitles, check that they remain beside the intended file.
Finally, use your media server's documented metadata refresh procedure for that one item. Then check what the player displays and open the movie. The editor, disk and player are separate places to verify. For Kodi specifically, tinyMediaManager's FAQ notes that external NFO edits are not automatically re-imported; our Kodi NFO refresh guide covers that step.
If the NFO is right and the player is still wrong, investigate the player's metadata source or refresh behavior before scraping again.
Recover without making a second bulk change
If a result is wrong, stop the batch and keep the failed result long enough to compare it. Do not immediately run another whole-library scrape with different settings.
For a small text mistake, restoring the old value in the editor may be enough. Confirm what that save writes to the NFO. For a broader rollback, close tinyMediaManager and preserve the current app data before restoring the matching pre-change database/settings backup and the affected sidecar copies.
The official backup instructions assume media paths have not been renamed or removed. A database restore does not move those files back. Also remember that an older whole-app backup can discard unrelated edits made since it was taken; that is a reason to use a fresh backup and a short test window.
After recovery, reopen the movie and compare both its saved details and files. Refresh the affected item in your player again if it already read the changed files. Avoid writing new NFOs from a still-incorrect database over the copies you just restored.
Bring reviewed metadata into MetaTana
If you are considering a tinyMediaManager alternative, finish the small preservation check before moving the whole library. Correct metadata is worth keeping whichever tool you use next.
MetaTana's import preview has Trust my NFOs and artwork enabled by default. For trusted items identified from NFO files, existing values are kept and providers fill missing details or artwork. Renaming has its own setting: choose Never for Rename files in this folder while comparing the results, and leave Start scan after import off until you have reviewed the import.
The tinyMediaManager import guide explains what transfers and how import Undo differs from undoing later file changes. Download MetaTana when you are ready to try one folder. Keep one app responsible for writing that folder during the trial so that your checks remain clear.