An OCP/OVOS-media skill for playing music from Plex on your Neon or OpenVoice OS device via OVOS Common Play (OCP).
Since this is an OCP skill, your music voice requests will automatically search your Plex music library via API. You can also search from the GUI on the OCP dashboard.
Due to the way OCP handles intent matching, the Plex skill will return more confident results if you ask for a media type explicitly. For example you might say "play the movie Ghostbusters" to make sure you get back a movie result instead of a soundtrack or TV show. This skill also significantly boosts its confidence score if you include the word Plex in your request: "play music by Charles Mingus on Plex."
Note: The assumption with users of the Plex skill is that they would want to get Plex results by default, so the base confidence score is 95/100. Asking for Plex specifically boosts that base score to 100. While this will increase the chances of Plex results coming in first, other skills may also have high confidence scores, so results are not guaranteed.
token(str): Your Plex token. This is required for the skill to work. You can find your token at https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/.base_confidence(int): The base confidence score for this skill, expressed as a percentage. Default is 95.
Music: "Hey Mycroft, play Jimi Hendrix" "Hey Mycroft, play music by Michael Jackson" "Hey Mycroft, play The Who on Plex"
Movies (not recommended on Mark 2): "Hey Mycroft, play the movie Ghostbusters" "Hey Mycroft, play the Ghostbusters movie on Plex"
TV (not recommended on Mark 2): "Hey Mycroft, play the Scooby Doo series" "Hey Mycroft, play the Ghostbusters TV show on Plex"
Update ~/.config/neon/neon.yaml to include the following:
skills:
default_skills:
- git+https://github.com/OscillateLabsLLC/skill-plexRestart neon-skills with sudo systemctl restart neon-skills or restart Neon services from the GUI.
For pip installation instructions, see the OVOS section.
When it loads, you will see a screen asking you to visit https://plex.tv/link and enter a code. Note that you must be logged into the Plex instance you wish to use. Enter the code and you will authorize the Mark 2 to use your Plex server. You will only need to do this once.
If this is not working for some reason or you prefer to use a specific token, you can manually update the skill settings:
mkdir -p config/neon/skills/skill-plex.oscillatelabsllc
touch ~/.config/neon/skills/skill-plex.oscillatelabsllc/settings.json
cat <<EOF > ~/.config/neon/skills/skill-plex.oscillatelabsllc/settings.json
{
"__mycroft_skill_firstrun": false,
"token": "REPLACE"
}
EOFVisit https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/ for instructions on finding your Plex token.
It should look something like ys738s6uPWXpwabc4sRYe.
Enter your token in ~/.config/neon/skills/skill-plex.oscillatelabsllc/settings.json where it says REPLACE.
Finally, sudo systemctl restart neon-skills.
Edit docker/config/neon.yaml and add a default skill:
skills:
default-skills:
- git+https://github.com/OscillateLabsLLC/skill-plexRestart the neon-skills container, then edit docker/xdg/config/neon/skills/skill-plex.oscillatelabsllc/settings.json. Add a token entry per the Mark 2 instructions above.
pip install git+https://github.com/OscillateLabsLLC/skill-plex
If you're using containers, add the following to ~/ovos/config/skills.list:
git+https://github.com/OscillateLabsLLC/skill-plex