Skip to content

danielBreitlauch/NLPlexRemote

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NLPlexRemote

Natural language remote control for Plex clients.

Build Status

About

NLPlexRemote allows you to control connected Plex clients with natural language commands. One great usage is to combine it with either pocket sphinx, google speech or any other speech-to-text api. The spoken command gets transformed into text and NLPlexRemote uses that to control your Plex client.

Features

  • Play/pause or navigate to media on connected clients with relatively fuzzy natural language
  • Find movies and tv shows by title, actors, release date, rating or everything combined
  • Control subtitles and language
  • Define and extend your language commands and meaning in a simple way
  • English and German commands are already supported
  • Use complex query combinations and context sensitive follow up commands

Installation

NLPlexRemote is compatible with Python 2.7.
There will be a pip package in the future.
Until then...

python ./setup.py install

Usage Examples

####First step: create the Remote: You need the Url to your Plex server, the client name and a language definition.

from NLPlexRemote import Remote, English
r = Remote(English(), 'http://192.168.0.30:32400', 'Swordmaster')

####Play a movie: If there are multiple choices. It will pick one at random.

r.execute('play an action movie with bruce willis')
r.execute('play any movie from the 60s')
r.execute('play an unseen romance')

####Follow up queries: These are context aware commands that consider the commands from before.

r.execute('go to any unseen episode from 88')
r.execute('filter episodes with patrick')
r.execute('another one')
r.execute('play it')
  1. Pick one episode that was released 1988.
  2. Retain all episodes with an actor named Patrick. Which brings you basically to Star Trek TNG.
  3. It considers the requested media from before and chooses another episode from it.
  4. Up until now the client just shows the detail pages of the found episodes. This command will play the episode.

Equivalent - Directly playing the episode:

r.execute('play any episode of star trek the next generation season 2')
r.execute('play any episode with patrick from 1988')

####Language, Subtitles and other Controls:

r.execute('turn subtitles on')
r.execute('switch subtitles')
r.execute('toggle language')
r.execute('pause movie')

About

Remote control Plex clients with natural language.

Resources

License

MIT, BSD-3-Clause licenses found

Licenses found

MIT
LICENSE
BSD-3-Clause
LICENSE.txt

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages