plexmusic-skill's Introduction

PlexMusic-Skill

Description

This Mycroft skill can play music from your plex media server with speech commands.

Requirements

you will need access to a plex media server and a working version of the vlc player.

how to get vlc:

Debian/Ubuntu sudo apt install vlc
CentOs sudo yum install vlc
Arch/Manjaro sudo pacman -S vlc

Install

msm install https://github.com/colla69/plexmusic-skill.git

Examples

"Hey mycroft, play mockingbird!"
"Hey mycroft, play eminem!"
"Hey mycroft, play album meteora"

Functions

Play song|artist|album name
Play artist name
Play album name
Play playlist name
Pause music
Resume music
Next|Skip
Reload|Refresh library

Usage

Once you have installed the skill, go to https://account.mycroft.ai/skills and find the Plex Music Skill.
Please fill in the 3 fields:

plex uri (address of your PlexMediaServer, it has to be reachable on port 32400)
e.G. http://my.plex.address
plex token (for info visit https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/)
e.G. ys738s6uPWXpwabc4sRYe
Library name in plex (the name of the library to play the music from)
e.G. Music

Alternative config (mycroft.conf):

"plexmusic-skill": {
  "musicsource": "http://my.plex.address",
  "plextoken": "ys738s6uPWXpwabc4sRYe", 
  "plexlib": "music", 
  "ducking": true
}

The first intallation will need to download all your library metadata and will save it in a JSON file. (~/.config/plexSkill/data.json)
The process will take a long time, don't panic, you can watch it load if you have debug=True in your config.