> 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/main/movies.md).

# Movies

TV Rename also manages movies...

## Movie Library

<figure><img src="https://3508557057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx0gPeIfHpbgTioNust1M%2Fuploads%2Fb8KoYqA0dLFvV7DTysCI%2Fimage.png?alt=media&amp;token=f3a193cd-5506-4108-944f-a9e4a44b0fac" alt=""><figcaption></figcaption></figure>

Below these panels are a series of buttons which allow you to manage the content. They are: -

* `Add` - Adds a new movie to the list. Remember you may need to add folders for the movie separately if you need to monitor it in the media library.
* `Edit` - Edit the currently selected movie
* `Delete` - Remove the currently selected movie(s) from TV Rename’s database, and optionally delete the selected movie(s) from the media library - ***careful!***
* `Refresh` - Refresh the current view
* `Scan Movies` - Do a scan just for Movies (ie no TV Shows)
* `Filter` - Filter the listed movies based on the entered criteria.
* `Context Menu` - Opens the same menu as right-clicking. This button is only shown when **Show Accessibility Options** is ticked on the [Display](https://www.tvrename.com/menu/preferences/display.md) tab of **Options>Preferences**.

The right hand side of the screen has 3 tabs:

* **Information** - key information about the movie. NB you can expand the Cast and Crew section to get more information
* **Images** - Any downloaded images and posters from the movie
* **Trailer** - Embedded YouTube viewer of the movie's trailer

**REMEMBER:**

* Clicking on the `Add` button will open the *Add/Edit Movie* window ready to add another movie.
* Clicking the `Edit` button with a **movie** highlighted will open the same window pre-populated with that movie's details.
* Right-clicking on a movie will give you some custom options too, including
  * `Force Refresh` - Force TV Rename to delete the cached data it has about that movie and refresh from the source
  * `Scan` followed by the movie's name - Do a scan just for this movie.

### Filters

<figure><img src="https://3508557057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx0gPeIfHpbgTioNust1M%2Fuploads%2FQ1dY1disgKZ1be65WnWg%2Fimage.png?alt=media&amp;token=e69ca5c8-d00c-4c96-84a9-bb91d344c1b3" alt=""><figcaption></figcaption></figure>

Allows you to filter the movie list to just the ones you are interested in at that moment

### Adding Movies to the library

There are a number of ways one can add movies to their library:

1. Manually
2. Use [**Tools>Move Movies From...**](https://www.tvrename.com/menu/tools-menu/scan-movie-folder.md). This is useful if you have a selection of movies in a folder and you wish to organise them into your library. This will iterate through the movie files in the specified folder and:
   1. If the file matches a movie in your library ask whether it is a new movie, or it should replace the existing movie file
   2. If the file does not match a movie in your library, but does match one on TMDB, offer to add the movie and copy the file into the correct place
   3. If it's not sure, ask you what to do with the file
3. If you already have an organised movie library, use [**Tools>Bulk Add Movies...**](https://www.tvrename.com/menu/tools-menu/bulk-add.md) to keep the current directory structure and add all movies to the library.
4. Copy movie files into the search folder. Tick **Notify when new media is found** on the [Search Folders](https://www.tvrename.com/menu/preferences/search-folders.md) tab of **Options>Preferences** and then run a scan. Auto add will identify that the file is new and ask to add the new movie to the library.

## Add/Edit Movie

### Basics

<figure><img src="https://3508557057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx0gPeIfHpbgTioNust1M%2Fuploads%2FIVwo391CRR1zKAfzGl12%2Fimage.png?alt=media&amp;token=8b4e4147-cb67-4a61-8ea6-e450633edc63" alt=""><figcaption></figcaption></figure>

The Basics tab links the movie to its entry at the data source and sets what the movie is called.

To find the movie, type its name (or its code at the source, if you know it) in the code box and click `Search`, then click the right movie in the list of matches.

* **Source** – where TV Rename gets this movie’s information. **Library Default** uses the **Default Movie Source** on the [Data Sources](https://www.tvrename.com/menu/preferences/data-sources.md) tab of **Options>Preferences**. **The TVDB** or **TMDB** uses that source for this movie only.
* **Custom show name** – tick it and type a name to use instead of the title from the source. TV Rename uses this name for the movie everywhere, including its folder and file names.
* **Custom Language** – tick it and choose the language to ask the source for, for this movie only.
* **Custom Region** – tick it and choose the region to use for this movie’s release date, instead of the **Preferred region** on the Data Sources tab.

### Folders

<figure><img src="https://3508557057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx0gPeIfHpbgTioNust1M%2Fuploads%2FV9S1eAZCGcWk9X8KS6LA%2Fimage.png?alt=media&amp;token=91622293-e6ea-4374-95f1-595c797e18ed" alt=""><figcaption></figcaption></figure>

The Folders tab tells TV Rename where this movie’s files are kept in your library.

**Folder Type** sets how the movie is stored:

| Folder Type             | What it means                                                                                                             |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Single Movie per Folder | The movie has a folder of its own.                                                                                        |
| Many Movies per Folder  | The movie’s file sits directly in the base folder, together with other movies.                                            |
| DVD format              | The folder holds a DVD copy of the movie. TV Rename looks for `VIDEO_TS\VIDEO_TS.IFO` in it and doesn’t rename the files. |
| Bluray format           | The folder holds a Blu-ray copy of the movie. TV Rename looks for `BDMV\index.bdmv` in it and doesn’t rename the files.   |

Tick **Automatic Folders** to let TV Rename work out the movie’s folder:

* **Base Folder** – the movie library folder the movie goes in. The list holds your **Movie Library Folders** from the [Library Folders](https://www.tvrename.com/menu/preferences/library-folders.md) tab of **Options>Preferences**.
* **Movie Folder Name** – **Subdirectories (default)** names the movie’s folder with the **Folder format** on that same Library Folders tab, which is shown in grey beside it. **Custom Subdirectories** lets you type a different folder name for this movie; click `Tags...` to see the tags you can use.

Tick **Manual/Additional Folders** to list the movie’s folders yourself. Type a folder in **Folder:** (or click `Browse...` to pick one) and click `Add`. Select a folder in the list and click `Open` to open it in File Explorer, or `Remove` to take it off the list.

At least one of **Automatic Folders** and **Manual/Additional Folders** must be ticked.

If some files in these folders are on TV Rename’s ignore list, the tab says so and shows a `See Ignore List` button.

### Custom File Naming

By default TV Rename will name movie files using the [Filename Format](https://www.tvrename.com/menu/preferences/library-folders.md) in **Preferences>Library Folders**. If this movie should use its own format then it can be overridden and specified here:

<figure><img src="https://3508557057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx0gPeIfHpbgTioNust1M%2Fuploads%2Fsh7cUpyV57cI0NiB9Bxe%2Fimage.png?alt=media&amp;token=e5e5c359-d07e-4193-a379-30928dae42ba" alt=""><figcaption></figcaption></figure>

### Aliases

Aliases are other terms that TV Rename uses (as well as the main name of the media) to match a filename to the movie name. TV Rename has 2 types of aliases:

1. **Source Aliases** that come from the data source
2. **Custom Aliases** that the user adds manually

<figure><img src="https://3508557057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx0gPeIfHpbgTioNust1M%2Fuploads%2Fd32l870WENvEgi6ZzOyJ%2Fimage.png?alt=media&amp;token=5ee75fb0-b955-4424-9a01-d90afbf294b5" alt=""><figcaption></figcaption></figure>

### Advanced

Use the advanced options to configure when and how the movie should be scanned and renamed.

<figure><img src="https://3508557057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx0gPeIfHpbgTioNust1M%2Fuploads%2Fknxm1eTRqoxW6GQ9LdhQ%2Fimage.png?alt=media&amp;token=25441a58-bab3-4176-87c4-290134c4ecfe" alt=""><figcaption></figcaption></figure>


---

# 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/main/movies.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.
