> For the complete documentation index, see [llms.txt](https://www.tvrename.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.tvrename.com/menu/tools-menu/bulk-add.md).

# Bulk Add

## Bulk Add Shows <a href="#bulk-add-shows" id="bulk-add-shows"></a>

<figure><img src="https://3508557057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx0gPeIfHpbgTioNust1M%2Fuploads%2FcIhdVSQXNqCF1qVKoU9I%2Fimage.png?alt=media&#x26;token=6d67b7df-3ddb-449a-a339-abe82336432c" alt=""><figcaption></figcaption></figure>

This is where you tell TV Rename about the location(s) of your media library. Additionally you can check these locations for new folders unknown to TV Rename and quickly scan and add them to the ***TV Shows*** tab.

Before using this tool, check that your preferred renaming style is set in [*Options>Filename Template Editor*](https://www.tvrename.com/menu/options-menu/filename-template-editor.md).

`Add` (or drag and drop) folders to the **Monitor Folders** list on the **Folders** tab. Click the `Check >>` button, and TV Rename will recursively search through the new folders looking for new TV shows. Once this is complete, if anything new is found, the ***Scan Results*** tab will appear populated with the paths to any newly found shows. It will also identify the folder structure of the show (“Flat” - everything in one folder or “Folder per season”).

<figure><img src="https://3508557057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx0gPeIfHpbgTioNust1M%2Fuploads%2FgEGZlKS8pZnmDE0Rjm8U%2Fimage.png?alt=media&#x26;token=9df9c295-6f28-4faf-ba08-812b08b2e9cf" alt=""><figcaption></figcaption></figure>

TV Rename looks inside each folder it finds. If any of its subfolders has a name that ends in a season word followed by a number, the show is listed as “Folder per season”; if none do, it is listed as “Flat”. For example, with the season word `Season`, subfolders named `Season 1`, `Season 01` and `Season01` all count: the space is optional, the number can be any length, and upper or lower case doesn't matter. The season words are the **Season search terms** on the [Scan Settings](https://www.tvrename.com/menu/preferences/scan-settings.md) tab of **Options>Preferences** (by default `Season;Series;Saison;Temporada;Seizoen`). Unless **Force to Use Season Words from Settings Only** is ticked there, TV Rename also uses the **Seasons name** from the [Display](https://www.tvrename.com/menu/preferences/display.md) tab and the season folder names set up for the shows already in your library.

Click the `Auto ID All` button and TV Rename will try and identify the newly found shows. If the show is found the **Show** and **Source Code** columns will be populated. If a show isn’t being matched or is incorrectly identified highlight the row in question and use the `Edit` button to perform a manual search, and for a more in-depth interrogation you can use the `Visit TVDB` button which will launch a web browser targeting the shows page or `Open Folder` which will open the selected folder in Windows Explorer.

`Auto ID All` identifies each folder using, in this order:

1. a show ID in the folder name, if there is one (see below)
2. any NFO or XML file in the folder with a ‘tvdbid’ tag (Kodi format)
3. the show’s name, taken from the folder name

### Putting the show ID in the folder name

To make sure a folder is matched to the right show, add the show’s ID from TheTVDB, TMDB, TVmaze or IMDb to the folder name. Write the site’s name, then `-` or `=`, then the ID:

* the site’s name is `tvdb`, `tmdb`, `tvmaze` or `imdb`, with or without `id` on the end (`tvdbid`, `tmdbid`, `tvmazeid`, `imdbid`), in upper or lower case
* there must be a `-` or `=` between the name and the ID (a space doesn’t work)
* the tag must be inside `{ }` or `[ ]`
* for IMDb, write the whole ID as IMDb shows it, starting with `tt` and keeping any leading zeros (for example `tt0903747`)

For example, each of these folders is identified as Silo:

* `Silo {tvdb-403245}`
* `Silo (2023) {tvdb-403245}`
* `Silo [tvdbid=403245]`
* `Silo {tmdb=125988}`
* `Silo [tmdbid-125988]`
* `Silo [tvmaze=38052]`
* `Silo {imdb-tt14688458}`
* `Silo [imdbid=tt14688458]`

And `Breaking Bad (2008) {imdb-tt0903747}` is identified as Breaking Bad.

Clicking `Remove` will remove the highlighted row from the New Shows list; however, it will be re-detected in the next run of “Auto ID All”.

Clicking `Ignore` will add the folder to the list in the ***Ignore*** tab and it will be ignored in subsequent scans.

## Bulk Add Movies

**Tools > Bulk Add Movies...** looks through your movie library folders for movie files that aren't in TV Rename yet, so you can add them to the **Movies** tab all at once.

### Choosing the folders

On the **Folders** tab, the **Monitor Folders** list shows your movie library folders. Click `Add` (or drag and drop folders onto the list) to add one, select a folder and click `Remove` (or press Delete) to take it off, or click `Open` (or double-click it) to open it in File Explorer. Changes made here change your movie library folders.

On the **Ignore** tab, the **Ignore Folders** list holds folders to skip when checking, with the same `Add`, `Remove` and `Open` buttons. This list is shared with Bulk Add Shows.

Click `Check >>` on either tab to start.

### Checking the folders

TV Rename opens the **Scan Results** tab and looks through each monitor folder and its subfolders, showing its progress as it goes. Click `Stop Scan` to stop early.

These are skipped:

* a monitor folder that is also one of your TV library folders
* folders on the Ignore list
* folders that already belong to a movie in TV Rename
* the Recycle Bin, if **Ignore Recycle Bin** is ticked
* folders with no video files in them, if **Only Include Folders containing Video files** is ticked

The last two options are on the [Scan Settings](https://www.tvrename.com/menu/preferences/scan-settings.md) tab of **Options>Preferences**, in the **Bulk Add TV Shows from Library Folders** group, and apply to Bulk Add Movies as well.

{% hint style="warning" %}
If **Only Include Folders containing Video files** is not ticked, `Check >>` deletes any completely empty folder (one with no files and no subfolders) that it finds in your movie library folders.
{% endhint %}

### The New Movies list

Each video file found is listed under **New Movies**, with its **Folder**, and the **Movie**, **Year** and **Source Code** once the movie has been identified. You can also drag and drop a folder onto the list to check just that folder.

| Button                         | What it does                                                                                                                               |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `Auto ID All`                  | Tries to identify every movie in the list that hasn't been identified yet.                                                                 |
| `Edit` (or double-click a row) | Opens a search so you can choose the right movie yourself.                                                                                 |
| `Remove` (or press Delete)     | Takes the selected rows off the list. They will be found again the next time you check.                                                    |
| `Ignore`                       | After you confirm, adds the selected folders to the Ignore Folders list and takes them off the list.                                       |
| `Visit TVDB`                   | Opens the selected movie's page on TheTVDB or TMDB, whichever it was identified from. It does nothing until the movie has been identified. |
| `Open Folder`                  | Opens the selected movie's folder in File Explorer.                                                                                        |

### Putting the movie ID in the file or folder name

To make sure a movie is matched to the right title, add its TMDB or IMDb ID to the movie's file name or to its folder name. Write `tmdb` or `tmdbid` followed by the TMDB number, or `imdb` or `imdbid` followed by the whole IMDb ID as IMDb shows it (starting with `tt` and keeping any leading zeros), with `-` or `=` between the name and the ID, inside `{ }` or `[ ]`. For example, each of these is identified as The Matrix (1999):

* a file named `The Matrix {tmdb-603}.mkv`
* a file named `The Matrix {tmdb=603}.mkv`
* a file named `The Matrix [tmdbid-603].mkv`
* a folder named `The Matrix {tmdb-603}`
* a file named `The Matrix {imdb-tt0133093}.mkv`
* a file named `The Matrix [imdbid=tt0133093].mkv`
* a folder named `The Matrix {imdb-tt0133093}`

A movie’s TheTVDB ID works the same way. Write `tvdb` or `tvdbid`, in upper or lower case, then `-` or `=`, then TheTVDB’s number for the movie, inside `{ }` or `[ ]`. For example, each of these is also identified as The Matrix (1999):

* a file named `The Matrix {tvdb-169}.mkv`
* a file named `The Matrix [tvdbid=169].mkv`
* a folder named `The Matrix {tvdb-169}`

Without an ID, `Auto ID All` searches for the movie by its name.

When you are ready, click `Add & Close`. TV Rename asks you to confirm, then adds every identified movie to the **Movies** tab. Movies that haven't been identified are not added.

Click `Close` to close the window without adding anything. If any movies have been identified, TV Rename asks you to confirm first.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.tvrename.com/menu/tools-menu/bulk-add.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
