From a3e69461e1373f9e73818b38633dc85a1b261215 Mon Sep 17 00:00:00 2001
From: Marc Monka <77387009+marcmonka@users.noreply.github.com>
Date: Fri, 31 Oct 2025 16:52:21 +0100
Subject: [PATCH] new description

---
 README.md | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 93a6102..f76e4f8 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,28 @@
 # XDJ100SX
-Open Source Standalone DJ Deck using an old CDJ 100 S
+An Open Source Standalone DJ Deck
+
+This project is another experimental project that combines hardware, MIDI and open source software to convert an old Pioneer CDJ-100S to a standalone player using all modern features.
+
+## Main Requirements:
+
+- Raspberri Pi 3b+
+- Arduino/Teensy with MIDI libraries
+
+
+## Content:
+
+- /arduino/ -> firmware code
+- /3d-model/ -> STL file to 3D print
+- /datasheets/ -> Original CDJ, Teensy and Raspberry datasheets
+- /images/ -> Process and result pics
+- /raspberri-img/ -> IMG file with all set for a Pi 3B+.
+- /mixxx/ -> Custom skin and MIDI mapping for this project
+- /print-assets/ -> STL file to 3D print + adhesive custom skin to print
+- /docs/ -> Documentation of this project
+
+
+### 📜 License
+- All code in this repository is released under the [GNU GPL v3 License](https://www.gnu.org/licenses/gpl-3.0.html).
+- All documentation, 3D models, and visual materials are released under the [Creative Commons BY-SA 4.0 License](https://creativecommons.org/licenses/by-sa/4.0/).
+
+© 2025 Marc Monka