provided sample configuration.

1 files changed, 37 insertions, 1 deletions

diff --git a/README.md b/README.md
index 4e62449..037f4ce 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,43 @@ Pool Video Switch 2
 Developer and Integrator documentation
 ------------------------------------------------------
 
-### Configuration files
+### Configuration File
+The configuration file should be saved as `/opt/openslx/pvs2/pvs2.ini`. As this
+extension is stateless the same set of files is used by both client and manager.
+
+A sample configuration can be found in `sample_configuration`.
+
+#### General settings
+
+* rooms: list all rooms that should be available to users
+
+* allowClientQuit: If set to true, users can shut down the client by clicking on
+  "Quit" in the toolbar of pvsclient. 
+
+
+#### Room settings
+A room section represents a physical or virtual room where clients are
+placed on defined positions. Viable configuration options are:
+
+MUST:
+
+* mgrIP: The ip of the instructor's PC
+
+* client: An array containing all clients and their positions. For the exact
+  syntax compare with the provided sample configuration
+
+CAN:
+
+* backgroundImage: Path to an image file that will be drawn as a background behind the room window
+
+* gridSize: size of the grid, defaults to minimal size to fit all clients on the
+  screen
+
+* clientSize: size of the clients on the grid. In combination with a big grid.
+  This allows you to create well-detailed room configurations.
+
+* priority: Important for the auto-connect feature, but also affects the sorting
+  in the connect window of the client.
 
 ### Lock/Unlock Scripts
 The functionality of PVS client(`pvsclient`) can be extended by providing