diff --git a/README.md b/README.md
index 0c07ddd..cc89015 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,70 @@
-# niu_scooters
-kqi3 and kqi2 firmware stuff
+# kqi3 and kqi2 scooter Firmware repository
+Repository with firmwares for the kqi3 and kqi2 scooters, these files where collected from various places. Also the JSON descriptors values are provided with information like the filename, type and MD5.
+
+
+
+## Kqi2 PRO:
+
+### DE: 
+
+https://raw.githubusercontent.com/scooterhacking/niu_scooters/main/KQI2/Pro/DE/update.json
+
+### EU:
+
+https://raw.githubusercontent.com/scooterhacking/niu_scooters/main/KQI2/Pro/EU/update.json
+
+### US:
+
+https://raw.githubusercontent.com/scooterhacking/niu_scooters/main/KQI2/Pro/US/update.json
+
+
+
+## Kqi3 sport
+
+### DE: 
+
+https://raw.githubusercontent.com/scooterhacking/niu_scooters/main/KQI3/Sport/DE/update.json
+
+### EU:
+
+https://raw.githubusercontent.com/scooterhacking/niu_scooters/main/KQI3/Sport/EU/update.json
+
+### US:
+
+https://raw.githubusercontent.com/scooterhacking/niu_scooters/main/KQI3/Sport/US/update.json
+
+
+
+## Kqi3 pro
+
+### DE: 
+
+https://raw.githubusercontent.com/scooterhacking/niu_scooters/main/KQI3/Pro/DE/update.json
+
+### EU:
+
+https://raw.githubusercontent.com/scooterhacking/niu_scooters/main/KQI3/Pro/EU/update.json
+
+### US:
+
+https://raw.githubusercontent.com/scooterhacking/niu_scooters/main/KQI3/Pro/US/update.json
+
+
+
+## Kqi3 max
+
+### DE: 
+
+https://raw.githubusercontent.com/scooterhacking/niu_scooters/main/KQI3/Max/DE/update.json
+
+### EU:
+
+https://raw.githubusercontent.com/scooterhacking/niu_scooters/main/KQI3/Max/EU/update.json
+
+### US:
+
+https://raw.githubusercontent.com/scooterhacking/niu_scooters/main/KQI3/Max/US/update.json
+
+
+
+Many thanks to Null, Ivan, cloud1250000 and Camialfa