> 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

## 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 to 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 shows based on the entered criteria.

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 show.
* Clicking the `Edit` button with a **show** highlighted will open the same window pre-populated with that shows 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 Movie`- 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 'Scan Movie Folder'. This is useful if you have a selection of movies in a folder and you wish to orgnise them into your library. This will iterate through the movie files in the specified folder and:
   1. If the file matches 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 orgnised movie library, use bulk add to keep the current directory structure and add all movies to the library.
4. Copy movie files into the search folder. Enable 'Auto-add' 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>

### 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>

### Custom File Naming

<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

<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>