plex-wrapper

A small module that makes it easier to use the Plex API for management.

Usage

Installing the package

$ npm i plex-wrapper

Getting started

First you need to require the package and then create an instance of the wrapper with the required parameters.

• clientId: A unique client identifier, you can generate a random one here. I do not recommend generating a new one every time you run it, as they will clutter up your authorized devices on your Plex.tv account.
• username: Your Plex.tv username.
• password: Your Plex.tv password.

import { PlexWrapper } from 'plex-wrapper';
var client = new PlexWrapper("clientId", "username", "password");

.authenticate() optional

Authenticate login with the supplied username and password

It is possible to manually authenticate after the authentication has gone through you can then take advantage of the promise callback. All the functions built into this library will try to authenticate before performing any method, so this functionality is only for people that wants to have full control.

import { PlexWrapper } from 'plex-wrapper';
var client = new PlexWrapper("clientId", "username", "password");

client.authenticate().then(() => {
    // Perform any action that requires the client to be signed in
    client.getServers();
});

.getServers()

Return all servers associated with Plex account

By default Plex API returns servers in XML format, this function converts it to JSON before returning. This function is also taking advantage of promise callbacks, which is demonstrated in the example:

import { PlexWrapper } from 'plex-wrapper';
var client = new PlexWrapper("clientId", "username", "password");

client.getServers().then(result => {
    // The result contains a JSON array with all the servers
    console.log(result);
});

.inivteUser()

Invite a given user to a specific Plex server under the account

This function allows you to invite a user to a specific server, given you have their username/email and the machine identifier of your server. The target will receive an email with the invite.

• username: Can either be the email or username of the target user.
• machineId: The server's machine identifier, can be obtained using the .getServers() function.

import { PlexWrapper } from 'plex-wrapper';
var client = new PlexWrapper("clientId", "username", "password");

client.inviteUser("username", "machineId");

.getUsers() and .getPendingUsers()

Return all users with shared library access or pending access to any Plex library

The Plex API splits up users that already accepted library sharing access and users that still got a pending invitation. Like the .getServers() function this one also parses the XML to JSON before returning it. The example demonstrate how you get each type of user:

import { PlexWrapper } from 'plex-wrapper';
var client = new PlexWrapper("clientId", "username", "password");

client.getUsers().then(result => {
    // The result contains a JSON array with all the shared library users
    console.log(result);
});

client.getPendingUsers().then(result => {
    // The result contains a JSON array with all the pending shared library users
    console.log(result);
});

.removeUser() and .removePendingUser()

Removes a specific user from accessing any shared libraries

Just like the get users, removing user is already separated based on if they have accepted the invite yet. To use this function you need to have a user's unique identifier.

• userId: A users unique identifier, can be obtained using the .getUsers() or .getPendingUsers() functions.

import { PlexWrapper } from 'plex-wrapper';
var client = new PlexWrapper("clientId", "username", "password");

client.removeUser("userId");
client.removePendingUser("userId");

License

MIT License

Copyright (c) 2019 Rasmus Buchholdt

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.