Skip to content

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

License

Notifications You must be signed in to change notification settings

wayneclub/Plex-Metadata

Repository files navigation

Plex-Metadata

zh python

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!

Buy Me A Coffee

About

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

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages