Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jacobwgillespie/plex-sync
:clapper: Command line utility for synchronizing Plex Media Server watched / seen status between multiple servers
https://github.com/jacobwgillespie/plex-sync
cli plex sync
Last synced: about 2 months ago
JSON representation
:clapper: Command line utility for synchronizing Plex Media Server watched / seen status between multiple servers
- Host: GitHub
- URL: https://github.com/jacobwgillespie/plex-sync
- Owner: jacobwgillespie
- License: other
- Created: 2016-08-07T15:58:37.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2021-09-03T15:31:59.000Z (about 3 years ago)
- Last Synced: 2024-04-14T07:49:20.184Z (5 months ago)
- Topics: cli, plex, sync
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/plex-sync
- Size: 160 KB
- Stars: 305
- Watchers: 28
- Forks: 37
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# plex-sync
A simple command-line utility to synchronize watched / seen status between different [Plex Media Servers](https://plex.tv).
[](https://www.npmjs.com/package/plex-sync)
[](https://travis-ci.org/jacobwgillespie/plex-sync)
[](https://david-dm.org/jacobwgillespie/plex-sync)
[](https://greenkeeper.io/)
[](https://asciinema.org/a/9j3oyj46vugcc039l7tbxecw4)
## Features
* Syncs watch status between different Plex servers.
## Requirements
* NodeJS 4+
## Installation
`plex-sync` is installed via NPM:
```shell
$ 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](https://support.plex.tv/hc/en-us/articles/204059436-Finding-your-account-token-X-Plex-Token), or use [this bookmarklet](https://jacobwgillespie.github.io/plex-token-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:
```shell
$ 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:
```shell
$ plex-sync 10.0.1.5/1 10.0.1.10/3
```
Sync three servers, with different ports:
```shell
$ 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:
```shell
$ plex-sync 10.0.1.2/2 https://server-domain/3
```
Dry run, to see what the script will do:
```shell
$ DRY_RUN=1 plex-sync 10.0.1.5/1 10.0.1.5/1
```
Precise matching (slow and may crash the Plex server):
```shell
$ MATCH_TYPE=precise plex-sync 10.0.1.5/1 10.0.1.5/1
```
Syncing between multiple Plex users (different access tokens):
```shell
$ plex-sync [email protected]/1 [email protected]/3
```
Unidirectional sync (read from one server, write to the other):
```shell
$ plex-sync 10.0.1.5/1,r 10.0.1.10/3,w
```
Complex use case:
```shell
$ 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.