README.md

@@ -1,2 +1,41 @@
-# 3d_cursors_briefcase
+# 🌟 Welcome to 3D Cursors Briefcase 💼.
 
+Take control of your 3D cursor in Blender like never before!
+With 3D Cursors Briefcase, you can save, load, and manage multiple 3D cursors.
+Try it today and launch your 3D Cursors experience! 🚀
+
+
+# ⚙️ Installation:
+- [Download](3D-Cursor-Briefcase.py) the Python script for the add-on.
+- Open Blender and go to `Edit > Preferences`.
+- In the Preferences window, click on the `Add-ons` tab.
+- Click on `Install...` and navigate to the downloaded Python script.
+- Click on `Install Add-on` and make sure to enable the add-on by checking the box next to it.
+
+# 📖 User guide:
+
+
+- **Go to** `View3D > Sidebar > View Tab`.
+    - In the `3D Cursors 💼` panel.
+
+![user interface](3d-cursor-case-guide.png "user interface")
+1. **Saving a 3D Cursor:**
+    - Position your 3D cursor in the desired location and rotation.
+    - Click on the `+` button. This will save the current position and rotation of the 3D cursor.
+
+2. **Deleting a 3D Cursor:**
+    - Select the saved 3D cursor from the list.
+    - Click on the `-` button. This will remove the selected 3D cursor from the list.
+
+3. **Moving a 3D Cursor Up/Down in the List:**
+    - Select the saved 3D cursor from the list.
+    - Click on the `🞁` or `🞃` button to change the order of the selected 3D cursor in the list.
+
+4. **Loading a 3D Cursor:**
+    - Select the saved 3D cursor from the list.
+    - Click on the `Load` button. This will move the 3D cursor to the saved location and rotation.
+
+5. **Going to a 3D Cursor:**
+    - Click on the `Centre View` button. Centers the view on the 3D Cursor.
+
+[LICENSE](LICENSE)