Skip to content

Latest commit

 

History

History
116 lines (72 loc) · 2.93 KB

README.md

File metadata and controls

116 lines (72 loc) · 2.93 KB
Raw

pavie

Node.js restful API for Plex Media Server.

Tested on Plex Media Server v1.16.3.

License: MIT npm version Install size

Install

$ npm install pavie

Usage

const Pavie = require("pavie")

const pavie = new Pavie({ username: "USERNAME", password: "PASSWORD" })

pavie
  .signin()
  .then(user => {
    console.log(user)
  })
  .catch(err => {
    console.error(err)
  })

Documentation

Instance methods

signin()

Authenticate user to Plex server. This is the first method to call, this instantiate your server and your token for the others methods !

Return user <object> if authentification is successfull.

getResources()

Get the list of resources with connection settings. Conection : [name, protocol, address, port, uri, local, relay, IPv6].

getUser()

Get user info. Return: [id, uuid, username, title, email, thumb, authToken, certificateVersion, rememberExpiresAt].

getIdentity()

Get basic info about the Plex server. Return: [machineIdentifier, version]

getActions()

Get the list actions availables. ie : platform, platformVersion, updatedAt, version, machineIdentifier, myPlexUsername. Return : [activities, butler, channels, clients, devices, diagnostics, hubs, library, livetv, media, player, playlists, resources, search, server, ...].

getLibraries()

Get a list of libraries. Return: [section, recentlyAdded, onDeck].

getLibrary([library = 'sections'])

Get a list of sections in the library. Return: [Movies, Music, TV Shows].

getDirectoriesFromSection([library = 'sections'], [sectionId = 2])

Get list of directory in a specified section. Default : TV Shows section. Return : [all, unwatched, newest, recentlyAdded, recenntlyViewed, recentlyViewedShows, onDeck, folder, ...]

getDirectory([library = 'sections'], [sectionId = 2], [directory = 'all'])

Get a list of TV Shows by directory. Default : TV Shows and all. Return : [studio, type, title, contentRating, summary, index, rating, year, thumb, art, duration, originallyAvailableAt, ...].

search([library = 'sections'], [sectionId = 2], [filters = { type: 2}])

Search Tv Shows, episodes, movies or musics. Default : [sectionId : Tv Shows, type: Tv Shows] For Tv Shows, type: [2: Tv Shows, 3: Seasonn, 4 : Episode]

refresh([library = 'sections'], [sectionId = 2])

Refresh a section.

getMedatadata([id])

Get metdata of a media.

getServers()

Get a list of servers. Return: [name, host, address, port, machineIdentifier, version].

getSynchronize()

Get synchronize info.

synchronize([accounntId])

Synchronize Plex and Trakt.tv.

getHubs([action = 'continueWatching'])

Hubs actions [continueWatching, onDeck]