Giter Club home page Giter Club logo

plex-sync's Introduction

plex-sync

A simple command-line utility to synchronize watched / seen status between different Plex Media Servers.

npm Travis Dependencies Greenkeeper badge MIT license

asciicast

Features

  • Syncs watch status between different Plex servers.

Requirements

  • NodeJS 4+

Installation

plex-sync is installed via NPM:

$ npm install -g plex-sync

Usage

There are several available configuration environment variables:

Variable Description
PLEX_TOKEN The API token used to access your Plex server. To locate this token, follow the instructions here, or use this bookmarklet. The Plex token must be set on the arguments or via the environment variable.
DRY_RUN Set this environment variable to make plex-sync print out what it was planning to do rather than actually perform the synchronization.
MATCH_TYPE Can be either fuzzy (default) or precise. When the matching is fuzzy, the script will match items by their year and title. When the matching is precise, the script matches items by their internal Plex GUID, which is usually the IMDb or TMDb ID. This requires an individual API request to be performed for each item (each movie, each TV episode, etc.) and thus is very slow and can potentially overwhelm and crash the Plex server. Use at your own risk.
RATE_LIMIT Default 5. If the MATCH_TYPE is set to precise, this is the maximum number of concurrent API requests plex-sync will make to your server to fetch GUIDs. Use this to (potentially) alleviate performance issues with precise matching.

First, find the IDs for the libraries on each server you would like to sync. These IDs can be found at the end of the URL when viewing the library in your browser (like .../section/ID).

Next, use the CLI as follows:

$ plex-sync [https://][token@]IP[:PORT]/SECTION[,rw] [https://][token@]IP[:PORT]/SECTION[,rw]
            [[https://][token@]IP[:PORT]/SECTION[,rw]...]

Examples

Sync watched status between two servers, using the default port (32400), using library ID 1 for the first server and library 3 for the second:

$ plex-sync 10.0.1.5/1 10.0.1.10/3

Sync three servers, with different ports:

$ plex-sync 10.0.1.5:32401/1 10.0.1.5:32402/1 10.0.1.10/3

Sync with a server via HTTPS:

$ plex-sync 10.0.1.2/2 https://server-domain/3

Dry run, to see what the script will do:

$ DRY_RUN=1 plex-sync 10.0.1.5/1 10.0.1.5/1

Precise matching (slow and may crash the Plex server):

$ MATCH_TYPE=precise plex-sync 10.0.1.5/1 10.0.1.5/1

Syncing between multiple Plex users (different access tokens):

Unidirectional sync (read from one server, write to the other):

$ plex-sync 10.0.1.5/1,r 10.0.1.10/3,w

Complex use case:

$ plex-sync [email protected]:32401/1,r https://[email protected]/3,w [email protected]/2,rw

For more complex strategies, like syncing between multiple different library mappings, just run the tool multiple times. If you need to run the synchronization on a schedule, use another scheduling tool like cron. These more advanced features may be added in the future, but currently plex-sync is very simple.

Contributing

Contributions are welcome. Open a pull request or issue to contribute.

License

MIT license. See LICENSE for more information.

plex-sync's People

Contributors

greenkeeper[bot] avatar greenkeeperio-bot avatar jacobwgillespie avatar jgigliotti avatar

Watchers

 avatar

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.