Skip to content

Configuration

Jump to bottom
infinityofspace edited this page Nov 6, 2022 · 1 revision

Before you proceed, make sure you meet the following requirements:

  • free Amazon developer account
  • publicly accessible Jellyfin server with a domain and a valid SSL certificate
  • you are admin on the Jellyfin server

Configuration page

The Configuration page of the skill have the following config options:

  • Server Address:
    • this is the public url (with https) to your Jellyfin server, make sure you enter the root url
  • SSL Certificate Type:
    • the type of the SSL certificate you used for the domain
    • Wildcard: you are using a sub-domain of a domain that has a wildcard certificate from a certificate authority
    • Trusted: you are using a certificate from a trusted certificate authority, like Let’s Encrypt
    • SelfSigned: you have a self signed certificate. Please go to the Alexa Developer Console after you filled out all values and clicked on Rebuild Skill to upload the public certifcate part. Please follow the offical documentation.
  • Invocation Name: the name of the skill, it must consist of at least two words
  • SMAPI Client ID: part of the SMAPI access to access manage the skill in the cloud
  • SMAPI Client Secret: part of the SMAPI access to access manage the skill in the cloud
  • SMAPI Refresh Token: part of the SMAPI access to access manage the skill in the cloud
  • Vendor ID: the vendor id of your developer account, which is required to automatically create the skill in the cloud
  • Skill ID: use an existing skill, leave empty to create a new skill

There are also the following actions :

  • Save: saves the current config values
  • Rebuild Skill: builds the skill in the cloud
  • Delete skill database: deletes the skill database on the Jellyfin server

First setup

When setting up for the first time, please fill in all config options except for the Skill ID value.

The SMAPI (Alexa Skill Management API) config values require additional steps. To do this, follow the steps below:

  1. create a new security profile for the SMAPI access described here to get a SMAPI Client ID and SMAPI Client Secret
  2. install npm if you have not already installed it and install the ask-cli package: npm install ask-cli -g
  3. now setup the ask cli: ask configure
  4. use the client id and client secret from step 1. to generate the SMAPI Refresh Token: ask util generate-lwa-tokens --client-id <SMAPI Client ID> --client-confirmation <SMAPI Client Secret>
  5. go to the Alexa Developer Console Settings to see the Vendor ID the under My IDs entry

After you have filled in all options, you have to save the values with the Save button and now the Rebuild Skill button should appear. Select this button to build the skill in the cloud. Wait a few minutes until the skill is built. The first time always takes a little longer. Now you are ready to link your Alexa account with your Jellyfin account. To do this, go to the Alexa settings of your app and select your Jellyfin Skill in the My Skill tab under the Developer item. Start the account linking process and log in with your desired Jellyfn account. If everything was successful, you can use the skill now.

Clone this wiki locally