Skip to content

Latest commit

 

History

History
executable file
·
142 lines (88 loc) · 3.91 KB

README.md

File metadata and controls

executable file
·
142 lines (88 loc) · 3.91 KB

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