diff --git a/README.md b/README.md
new file mode 100644
index 0000000..612b496
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# Raspberry Pi Pico W live weather viewer
+## Project description 
+- Live Weather Display: Fetches current local weather conditions from the Open-Meteo API.
+- Automatic Updates: Weather information is refreshed every 10 minutes.
+- Live clock updates every second sync using ntp.
+- Real-time clock updated every second and synced via NTP.
+- Clean, readable display output on a 1.3" I2C OLED screen.
+- Switch between current weather and forcast using the buttons next to the screen.
+
+## Requirements 
+- Raspberry Pi Pico W or Pico 2W with micropython installed.
+- 1.3" inch OLED display.
+
+## Example Display Output
+### Current Weather:
+
+![](current.jpg)
+
+Selective redrawing implemented so that only changes are redrawn so that the clock can be updated every second without redrawing the whole screen.
+
+### Today's Forcast:
+
+![](forecast.jpg)
+
diff --git a/current.jpg b/current.jpg
new file mode 100644
index 0000000..8117a16
Binary files /dev/null and b/current.jpg differ
diff --git a/forecast.jpg b/forecast.jpg
new file mode 100644
index 0000000..84ee8f2
Binary files /dev/null and b/forecast.jpg differ