v0.1.2 - Updated Readme + manifest.

Author: EldinZenderink

README.md

@@ -1,16 +1,64 @@
-# MidiController
-Blender plugin to control object properties through midi.
+# MidiControl Plugin Documentation
 
-Demonstration Video:
+## Introduction
+The **MidiControl** plugin enables you to connect a MIDI device to Blender and control the values of objects (e.g., location, rotation, scale) or any other numeric input — including geometry nodes, brush settings, and more — via your MIDI controller’s inputs.
 
-[<img src="https://i.ytimg.com/vi/rg6pHa3B34s/hq720.jpg" width="50%">](https://youtu.be/rg6pHa3B34s)
+---
 
-## Installation
+## Functionalities
 
-See releases!
+### 1. Property Mapping
 
-### Dependencies
+The plugin supports two distinct mapping methods:
 
-python-rtmidi (comes with the plugin, no manual installation needed!): https://github.com/SpotlightKid/python-rtmidi
+#### **Method 1 – Object Property Mapping**
+Used for mapping properties shared by multiple objects in Blender.
 
-pyperclip (comes with the plugin, no manual installation needed!):  https://github.com/asweigart/pyperclip
+**Steps:**
+1. Move the MIDI control you wish to assign on your MIDI device.
+2. Adjust the value of the desired property in Blender.
+3. The plugin automatically detects the last property you changed. Click the **Map** button.
+4. Set the mapping name, along with the minimum and maximum values.
+5. The property is now linked to your MIDI control.
+
+> **Note:** Changes apply **only** to the currently selected object(s) in the viewport. You may select one or multiple objects to affect.
+> This method **cannot** be used for brush properties or other specialized values like geometry nodes. Use **Method 2** for such cases.
+
+---
+
+#### **Method 2 – Direct “Full Data Path” Mapping**
+Ideal for mapping a specific property of a single object, independent of which object is selected.
+
+**Steps:**
+1. Move the MIDI control you wish to assign on your MIDI device.
+2. In Blender, right‑click the property you want to map and select **Copy Full Data Path**.
+3. The plugin detects the copied data path. Click the **Map** button.
+4. Set the mapping name, along with the minimum and maximum values.
+5. The property is now linked to your MIDI control.
+
+> **Tip:** This method also works for brush settings, geometry nodes, and other changeable Blender properties.
+
+---
+
+### 2. Selection Groups
+
+Create groups of objects that can be selected instantly via a mapped MIDI control button. This allows rapid switching between object sets during a workflow.
+
+---
+
+### 3. Resolution Control
+
+Adjust the granularity of property value changes.
+You can map **two MIDI controls** to act as **Fine** and **Coarse** resolution factors, which are multiplied by the main MIDI input to refine control sensitivity.
+
+---
+
+### 4. Keyframe Insertion
+
+Bind a MIDI button to insert a keyframe for **all mapped properties** of the currently selected object.
+
+---
+
+### 5. Frame Control
+
+Use a MIDI control to navigate the timeline by adjusting the current frame position.

blender_manifest.toml

@@ -3,7 +3,7 @@ schema_version = "1.0.0"
 # Example of manifest file for a Blender extension
 # Change the values according to your extension
 id = "midicontroller"
-version = "0.1.0"
+version = "0.1.2"
 name = "MidiController"
 tagline = "Control objects properties through midi"
 maintainer = "Eldin Zenderink"
@@ -15,7 +15,7 @@ type = "add-on"
 
 # Optional list defined by Blender and server, see:
 # https://docs.blender.org/manual/en/dev/advanced/extensions/tags.html
-tags = ["Animation", "Object", "Scene", "Paint", "User Interface"]
+tags = ["Animation", "Object", "Paint", "User Interface"]
 
 blender_version_min = "4.2.0"
 # # Optional: Blender version that the extension does not support, earlier versions are supported.