Find missing entries from movie series in your Plex library.
For example: You have Iron Man 1 and Iron Man 3, this will inform you that Iron Man 2 is missing.
To get started, edit credentials.json and provide the required credentials.
A temporary Plex token can be found by clicking the 3 dot icon on a movie in your library, selecting Get Info from the drop down, and then clicking View XML.
The token is located in the address bar as X-Plex-Token=YOUR_TOKEN_HERE, only YOUR_TOKEN_HERE is required.
The library id is found in the XML as librarysectionID="x", only x is required.
The IP address that your Plex server runs on including port. E.g: 192.168.1.138:32400
PlexGap utelises the TMDB API to find out whether a movie is part of a series.
The read acccess token allows temporary write access to create a list on your TMDB profile containing the movies that were found.
To obtain an API key for TMDB, create a free account and verify your email.
Navigate to the API settings by clicking your account icon in the top right, selecting settings from the drop down and then API on the left dashboard.
Click to generate a new API key as a developer and accept the terms and conditions.
You will now be asked to input information about the application that will use this API key, anything can be entered here.
Once done, your API key will be located under API Key (v3 auth) and your read access token under API Read Access Token (v4 auth).
Make sure credentials.json and the jar file are in the same directory and type java -jar PlexGap.jar in CMD.
When running the application you will be asked to select an option:
Where would you like to read your Plex library in from?
1. [json_file].json
2. The Plex API
As obtaining the information for all movies in your plex library is a time consuming process, the application will save the relevant data in a json file as it is found.
If you have run the application before, you can select this option to prevent having to go through the process again. New movies on plex that are not in the json file are appended to it.
The application will first query your plex server for the contents of your library.
Each movie is then passed to the TMDB API to find the collection id (if it belongs to a collection).
This process can take a few minutes depending on the size of your library.
Once the data has been collected, you will be prompted to select an option:
What would you like to do with your movies?
1. Find missing sequels
The application will go through all movies which belong to a collection and query the TMDB API to find the other movies in these collections and compare them to the Plex library.
Upon checking all movies, you will be prompted with a link to follow:
Please visit:
https://www.themoviedb.org/auth/access?request_token={YOUR_REQUEST_TOKEN_HERE}
To approve the application.
This allows it to create a TMDB list containing your missing movies.
Type "ok" when ready:
TMDB requires authentication in allowing applications to write to your profile.
First the application passes your provided read access token to obtain a request token.
You must then follow the provided link to approve this request token, and confirm to the application that this has been done.
This allows the application to use the now approved request token to obtain an access token, finally granting temporary permission to write data to your profile.
Once you have approved this request and typed ok, you will be asked to provide a name for your list, and then be directed to the newly created TMDB list containing all of the missing movies that were found:
Your list has been created!
Visit:
https://www.themoviedb.org/list/{NEW_LIST_ID}
TMDB collections are curated but can be quite broad/generalised - There is a singular James Bond collection, not one per actor. As this list is created on your profile, you can remove any movies you don't want and import it in to Radarr.