MusicBoxRaspberryPi · TimNekk · Dec 9, 2023 · Dec 9, 2023
diff --git a/README.md b/README.md
@@ -1 +1,26 @@
-# MusicBoxController
+<h1 align="center" id="title">Music Box Controller</h1>
+
+<p align="center"><img src="https://socialify.git.ci/MusicBoxRaspberryPi/MusicBoxController/image?description=1&amp;font=Inter&amp;language=1&amp;name=1&amp;owner=1&amp;theme=Light" alt="project-image"></p>
+
+
+## 🖥️ Compatibility
+
+- Tested on **Raspberry Pi Pico W**
+- Any microcontroller with MicroPython should work in theory
+
+
+## 🛠️ Installation
+
+1. Clone the repository `git clone https://github.com/MusicBoxRaspberryPi/MusicBoxController`
+2. Rename `config.py.dist` to `config.py`
+3. Edit `config.py` to your needs
+4. Copy contents of `src` to your microcontroller
+
+<p align="center"><img src="images/schematic.png" alt="schematic" width="1000"></p>
+<p align="center"><img src="images/schematic2.png" alt="schematic2" width="1000"></p>
+
+## 🚀 Usage
+
+- **Left button** - Previous device
+- **Right button** - Next device
+- **RFID Scan** - Play track
diff --git a/images/schematic.png b/images/schematic.png
diff --git a/images/schematic2.png b/images/schematic2.png