API keys

API keys for third-party SEPIA services

Some services integrated in SEPIA require an API key to run properly (e.g. Weather via forecast.io). Here you will find info about these services, how to get the API keys (usually for free with a generous daily limit) and use them.

How to add an API-key to SEPIA

Look for the config file "assist.*.properties" (usually "custom" when you are using the SEPIA custom-bundle with it's start scripts) in the "[SEPIA]/sepia-assist-server/Xtensions/" folder. Open it with a text-editor and scroll down to the bottom. There you will find the entries for each supported third-party service. Add your keys and save the changes then restart the SEPIA assist-server.

Forecast.io/DarkSky

Info: Currently the default weather service in SEPIA.
Get key: https://darksky.net/dev/register - 1000 calls per day free
Value in config file:
forecast_io_key=...

Google Maps

Info: Currently the default GEO-coder service in SEPIA. Required to get names for places and GPS coordinates.
Get key: https://cloud.google.com/maps-platform - ~10000 calls per month free
Value in config file:
google_maps_key=...

Spotify API

Info: Required if you want to search the Spotify database and generate URIs for songs etc. that can be used to start the app.
Get key: Register here: https://www.spotify.com/de/signup/ then log-in here: https://developer.spotify.com/dashboard/ and go to: CREATE CLIENT ID, choose and app name (anything) and choose non-commercial. Finally click show client secret and copy the key.
Values in config file:
spotify_client_id=...
spotify_client_secret=...