A simple web client application to retrieve music related information. A plain HTML implementation, called Vanilla is provided. A vue.js application is considered but not fully developed. A local web server provides end points and data marshalling for clients.

SWENG861 Project, AskMinstrel
André Wagner
July, 2020

The project directly makes use of the following packages:

• CherryPy A Python HTTP framework and server.
• Tekore A Python client for the Spotify API.
• Requests A library for HTTP/1.1 requests.
• Slugify Generate URI compatible strings.

Content provided by Spotify

Since a setup.py is not provided, the following manual setup is required.

1. install python 3.6
2. unzip askminstrel.zip contents to a new directory
3. pip install cherrypy
4. pip install tekore
5. pip install requests
6. pip install python-slugify

AskMinstrel requires a credentials.json file in the current working directory. See Spotify for information on how to obtain a client id and secret. The file contents should look like:

{
    "client_id": "...",
    "client_secret": "..."
}

AskMinstrel is a Python module that can be executed with

python -m askminstrel

For available command line parameters

python -m askminstrel -h

By default, the AskMinstrel server will use port 50861. So direct a web browser to http://localhost:50861/vanilla and ask minstrel!