Initial setup incl. Spotify auth

Author: marcelstoer

.editorconfig

@@ -0,0 +1,17 @@
+# This file is for unifying the coding style for different editors and IDEs
+# editorconfig.org
+
+root = true
+
+[*]
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+max_line_length = 100
+curly_bracket_next_line = false
+
+[*.{html,php}]
+max_line_length = 160

.github/workflows/main.yml

@@ -0,0 +1,27 @@
+# documentation at https://docs.platformio.org/en/latest/integration/ci/github-actions.html
+
+name: PlatformIO CI
+
+on: [push, pull_request]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/cache@v3
+        with:
+          path: |
+            ~/.cache/pip
+            ~/.platformio/.cache
+          key: ${{ runner.os }}-pio
+      - uses: actions/setup-python@v4
+        with:
+          python-version: '3.9'
+      - name: Install PlatformIO Core
+        run: pip install --upgrade platformio
+
+      - name: Build PlatformIO Project
+        run: pio run

.gitignore

@@ -0,0 +1,2 @@
+.pio
+.vscode

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 ThingPulse
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,64 @@
+# Color Kit Grande Spotify Controller
+
+[![Build Status](https://github.com/ThingPulse/esp32-spotify-remote/actions/workflows/main.yml/badge.svg)](https://github.com/ThingPulse/esp32-spotify-remote/actions)
+
+Spotify controller application for the [ThingPulse Color Kit Grande](https://thingpulse.com/product/esp32-wifi-color-display-kit-grande/).
+
+[![Color Kit Grande with sample application: weather station](https://thingpulse.com/wp-content/uploads/2022/10/ThingPulse-Color-Kit-Grand-with-sample-application.jpg)](https://thingpulse.com/product/esp32-wifi-color-display-kit-grande/)
+
+## Purpose of this project
+
+Using the ThingPulse Spotify Controller you control a Spotify player (phone, browser, etc) from an Espressif ESP32 microcontroller.
+Album artwork as well as title and artist name are loaded from the Spotify Web API over WiFi and displayed on a color TFT touch-screen.
+The currently playing song can be paused, resumed and skipped to the next or previous song in the playlist.
+
+A full OAuth 2.0 web flow is used to acquire the necessary access and refresh tokens to permit the user to control the player.
+In order to run this project on your device, you will need to setup an application on your Spotify dashboard (instructions below).
+
+## Features
+
+ - Artwork download
+ - Control player on touch screen: play, Pause, next, prev
+ - Authentication and authorization (OAuth 2.0 flow) on device.
+
+## Service level promise
+
+<table><tr><td><img src="https://thingpulse.com/assets/ThingPulse-open-source-community.png" width="150">
+</td><td>This is a ThingPulse <em>community</em> project. See our <a href="https://thingpulse.com/about/open-source-commitment/">open-source commitment declaration</a> for what this means.</td></tr></table>
+
+## Setup instructions
+
+### Precondition
+
+The below instructions assume a properly configured Visual Studio Code installation with PlatformIO.
+See our [instructions](https://docs.thingpulse.com/guides/esp32-color-kit-grande/#development-environment) if you need help with this.
+
+### Get access to the Spotify API
+
+1. Go to [https://developer.spotify.com/dashboard/login](https://developer.spotify.com/dashboard/login) and login to or sign up for the Spotify Developer Dashboard
+
+2. Select "My New App"
+
+   <img src="./images/SpotifyDashboard.png" width="400">
+
+3. Fill out the form. Give your new app a name you can attribute to this project.
+It's safe to select "I don't know" for the type of application.
+
+   <img src="./images/SpotifyAppSignUp1.png" width="400">
+
+4. At the end of the 3 steps click "Submit"
+
+   <img src="./images/SpotifyppSignUp3.png" width="400">
+
+5. Set the unique Client ID and Client Secret as values for the respective variables in `settings.h`.
+
+   <img src="./images/SpotifyCredentials.png" width="400">
+
+6. Click on "Edit Settings". Add "http://tp-spotify.local/callback/" to the Redirect URIs section.
+
+   **NOTE** If you are running more than ThingPulse Spotify Remote in the same WiFi network, you should choose a unique name rather than "tp-spotify". Regardless of what you choose it has to reflect what you set for `SPOTIFY_ESPOTIFIER_NODE_NAME` in `settings.h` in the project.
+
+   <img src="./images/SpotifyAppSettings.png" width="400">
+
+7. Don't forget to save your settings.
+   <img src="./images/SpotifyAppSettingsSave.png" width="400">