wayneclub / Plex-Metadata

Automatically find metadata (synopsis, posters) from Netflix, HBOGO, Amazon, AppleTV, Friday, iTunes, etc., and apply to Plex.

Plex-Metadata

NON-COMMERCIAL USE ONLY

Plex-Metadata supports auto-fetching metadata and posters from multiple streaming services, such as Amazon, Apple TV+, CatchPlay, Disney+, FridayVideo, Google Play, HamiVideo, HBOGOAsia, iQIYI, KKTV, MyVideo, Netflix, Viu, etc.

DESCRIPTION

Plex-Metadata is a command-line program to download metadata and posters from the most popular streaming platform. It requires Python 3.10+, and NodeJS. It should work on Linux, on Windows, or macOS. This project is only for personal research and language learning.

INSTALLATION

• Linux, macOS:

pip install -r requriements.txt

• Windows: Execute install_requirements.bat

Service Requirements

Name	Authentication
Netflix	Cookies

Get Cookies

1. Install Chrome plugin: get-cookiestxt-locally
2. Login to the streaming service, and use the plugin to download cookies.txt (Don't modify anything even the file name)
3. Put cookie.txt into Plex-Metadata/cookies

USAGE

Local

1. Depending on the download platform and modify Plex-Metadata/user_config.toml

   [metadata]
   default-language = 'zh-Hant' # en/zh-Hant
   
   [metadata.Amazon]
   locale = 'zh_TW' # en_US, zh_TW
   
   [metadata.AppleTVPlus]
   locale = 'zh-TW' # en-US, zh-TW
   
   [metadata.DisneyPlus]
   region = 'TW' # US, TW, HK
   
   [metadata.GooglePlay]
   region = 'TW'    # US, TW
   locale = 'zh-TW' # en-US, zh-TW
   
   [metadata.Netflix]
   region = 'tw' # us, tw, hk

2. Follow each platform's requirements and put cookies.txt into Plex-Metadata/cookies

3. Execute the program with the command line

   python plex_metadata.py URL [OPTIONS]

OPTIONS

  -h, --help                    show this help message and exit

  -s, --season                  download season [0-9]

  -e, --episode                 download episode [0-9]

  -t, --title                   plex media title

  -r, --replace                 replace metadata

  -rp, --replace-poster         replace poster

  -dl, --download-poster        download posters

  -locale, --locale             interface language

  -p, --proxy                   proxy

  -d, --debug                   enable debug logging

  -v, --version                 app's version

More Examples

• Print all seasons and all episodes' metadata

python plex_metadata.py URL

• Replace all seasons and all episodes' metadata on Plex

python plex_metadata.py URL -r

• Replace all seasons and all episodes' metadata on Plex with the title X

python plex_metadata.py URL -r -t "X"

• Replace season 1 episode 1's metadata on Plex

python plex_metadata.py URL -s 1 -e 1 -r

• Replace all seasons and all episodes' posters on Plex

python plex_metadata.py URL -rp

• Download all seasons and all episodes' posters

python plex_metadata.py URL -dl

FAQ

• Any issue during downloading metadata and posters, upload the screenshot and log file (Please provide title, platform, and region).

Support & Contributions

• Please ⭐️ this repository if this project helped you!
• Contributions of any kind are welcome!