Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nicjansma/plex-poster-optimizer
Ensures Plex Posters are high-quality, e.g. above a minimum height/width threshold.
https://github.com/nicjansma/plex-poster-optimizer
Last synced: 10 days ago
JSON representation
Ensures Plex Posters are high-quality, e.g. above a minimum height/width threshold.
- Host: GitHub
- URL: https://github.com/nicjansma/plex-poster-optimizer
- Owner: nicjansma
- License: mit
- Created: 2019-12-18T00:16:39.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2020-06-19T20:24:15.000Z (over 4 years ago)
- Last Synced: 2024-08-01T12:19:27.682Z (3 months ago)
- Language: JavaScript
- Homepage:
- Size: 50.8 KB
- Stars: 15
- Watchers: 4
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# plex-poster-optimizer v1.0.2
Ensures Plex Posters are high-quality, e.g. above a minimum height/width threshold.
I found that I wanted to "fix" my Posters after converting from [MyMovies to Plex](https://github.com/nicjansma/mymovies2plex),
as MyMovies had written low-quality (e.g. 510x355 px) DVD box art into a `folder.jpg`, which Plex picked up via
the _Local Media Assets_ instead of a higher-quality source like _The Movie Database_.
As a result, my Plex Posters were a mix of nice, high-res (1000px+) Posters from TMDB and awkward looking low-res DVD box art.
This script scans all of your Plex movies to find Posters underneath the specified threshold, and changes the Poster to other
higher-res options automatically.
## Usage
```
> $ node index.js --help
Options:
--host Plex host [string]
--token Plex token [string]
--section Section titles [string]
--filter Title filter [string]
--pretend Pretend (don't set status) [boolean] [default: false]
--minHeight Minimum height [default: 1000]
--minWidth Minimum width [default: 800]
--provider Poster provider[array] [default: "com.plexapp.agents.themoviedb"]
--max Maximum number to update [default: "-1"]
--help Show help [boolean]
--version Show version number [boolean]
```
### 1. Getting your Plex Token
To run, you'll need to find your Plex Token. You can do this by viewing
any title on your Plex, selecting _Get Info_, then _View XML_. The URL of the
XML file will be something like this:
```
https://plexhost.plex.direct:32400/library/metadata/n?checkFiles=1&includeExtras=1&includeBandwidths=1&X-Plex-Token=abc123
```
Your Plex Token is `abc123` in the above URL.
### 3. Updating Posters
Example:
```
node index.js \
--host myhost \
--token abc123 \
--section Movies \
--provider com.plexapp.agents.themoviedb \
--provider com.plexapp.agents.imdb
```
It's recommended to do this in pretend mode first, to see what it would do
```
node index.js ... --pretend
```
## Version History
* 1.0.2 (2020-06-19) - Fixed a runtime error if no posters are available
* 1.0.1 (2019-12-22) - Fixed to work with HTTPS poster URLs
* 1.0.0 (2019-12-19) - Initial version