What Are You Listening? (WAYL)

WAYL is a locally hosted browser source that displays what you're listening to on Spotify.

Installation and Configuration

1. Download the project from GitHub and place it in a local directory.

2. First Launch:
   Run the application once. The program will generate a config.toml file and then exit with an error since the generated file needs to be configured.

3. Configure the config.toml file with the following details:

   ClientID     = ""
   ClientSecret = ""
   Port         = ""

   • ClientID and ClientSecret: Obtain these from the Spotify Developer Dashboard.
   • Port: Choose a port number (e.g., 8080).

4. Second Launch: Launch the application again. Open your browser and go to http://localhost:PORT/ (replace PORT with the port number you configured). You will be redirected to a login screen where you need to log in with your Spotify account. After a successful login, you will be redirected to http://localhost:PORT/playback, where the currently playing music will be displayed.

Command-Line Arguments

WAYL accepts several command-line arguments:

• Without Arguments
  Runs the server normally. Creates any missing files if they are not found.

  ./WAYL

• -k
  Kills all running instances of the program.

  ./WAYL -k

• -rI
  Resets all configurations and tokens. Deletes all configuration and token data and reinitializes them.

  ./WAYL -rI

• -rT
  Resets the token data. Deletes the token data and reinitializes the token directory.

  ./WAYL -rT

• -rC
  Resets the configuration files. Deletes the configuration files and reinitializes them.

  ./WAYL -rC

Configuration Files

The config directory contains:

• playback.html: HTML file to display the currently playing track.
• styles.css: CSS file to style the playback display.
• script.js: JavaScript file to handle dynamic updates and interactions.

These files can be customized to your preferences. If any file is broken or improperly configured, use the -rC argument to reset them to their default state.