Git Product home page Git Product logo

plex-metadata's Introduction

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

plex-metadata's People

Contributors

wayneclub avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

plex-metadata's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.