diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..003967c
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,18 @@
+# esp32-ssd1306-spotify
+uses the SpotifyArduino.h library and the spotify api to show the currently playing song on a 128x64 pixel display
+
+## libraries req'd
+- `include <Wire.h>`
+- `include <Adafruit_GFX.h>`
+- `include <Adafruit_SSD1306.h>`
+- `include <WiFi.h>`
+- `include <WiFiClientSecure.h>`
+- `include <SpotifyArduinoCert.h>`
+- `include <SpotifyArduino.h>`
+- `include <ArduinoJson.h>`
+- i got lazy doing this so just check [main.ino](https://git.rintyuu.dev/rintyuu/esp32-ssd1306-spotify/src/branch/main/main.ino)
+
+## visual representations, please
+ok
+![esp32 on breadboard connected to ssd1306 oled display](https://7z.rintyuu.dev/u/X2PT7c.jpeg)
+check out a video demo [here](http://7z.rintyuu.dev/u/jd3me9.mp4)
\ No newline at end of file