diff --git a/README.md b/README.md
index ad126ef68a5416a95c3aaec97d716c7c74918851..68d10f6589ace1e2dbfe40471e27f3a66e235369 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,15 @@
 # mediactl
 
+This repository contains the software running on the `mediactl.mediahell.hfbk.net` Raspberry that controls the media technology in the Extended Library ([see also Extlib Documentation](https://code.hfbk.net/medientechnik/ext-lib/extlib-documentation)).
+
+mediactl sports a touchscreen that allows control of the media technology in that room – the interface for that touchscreen can be remotely accessed via [mediactl.mediahell.hfbk.net](http://mediactl.mediahell.hfbk.net) if your machine is connected to the [mediahell network](https://code.hfbk.net/medientechnik/network/mediahell). 
+
+![rack-perspective](/data/cloud/medientechnik/dokumentation/extlib-documentation/images/rack-perspective.jpg)  
+
 
 ## autostart on RPI
 
-See [this](https://blog.r0b.io/post/minimal-rpi-kiosk/) for a description of how to start chromium via .xinit 
+See [this](https://blog.r0b.io/post/minimal-rpi-kiosk/) for a description of how to start chromium via `/home/d0/.xinit` – note: this file contains the screen blanking settings (`xset 600 0` )
 
 ## note about apt
 
@@ -23,13 +29,13 @@ So we can then ssh into the machine with a tunnel
 ssh -R 127.0.0.1:8080 mediactl
 ```
 
-## note about git
+## Editing the code in this repository
 
-Git does not work in the mediactl network per default. As of now the recommended way is to mount it locally via sshfs:
+Git does <u>not</u> work in the [mediahell network](https://code.hfbk.net/medientechnik/network/mediahell) out of the box. As of now the recommended way is to mount it locally via sshfs (replace the `id_ed25519` key with a valid one you own).
 
 ```bash
 mkdir -p remote-mediactl
-sudo sshfs -o allow_other,default_permissions -o IdentityFile=/home/d0/.ssh/id_ed25519 -p2222 d0@mediactl.mediahell.hfbk.net:/home/d0/mediactl remote-mediactl
+sudo sshfs -o allow_other,default_permissions -o IdentityFile=/home/YOURUSER/.ssh/id_ed25519 -p2222 YOURUSER@mediactl.mediahell.hfbk.net:/home/d0/mediactl remote-mediactl
 ```
 
 
@@ -37,7 +43,7 @@ sudo sshfs -o allow_other,default_permissions -o IdentityFile=/home/d0/.ssh/id_e
 
 | Device            | Connection Kind                         | Purpose                                        |                                                              |
 | ----------------- | --------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------ |
-| Allen&Heath AHM16 | Ethernet                                | Audio DSP and Mixer                            | [TCP Protocol](https://www.allen-heath.com/content/uploads/2023/11/AHM-TCP-Protocol-V1.4.pdf) |
+| Allen&Heath AHM16 | Ethernet                                | Audio DSP and Mixer                            | [TCP Protocol](https://www.allen-heath.com/content/uploads/2023/11/AHM-TCP-Protocol-V1.4.pdf) (essentially MIDI over IP) |
 | RPI 3B "projctl"  | Ethernet/WIFI (REST via mediahell wifi) | Controlling and monitoring the projector       | see [code.hfbk.net](https://code.hfbk.net/medientechnik/ext-lib/projctl) |
 | Kramer VS-411X    | GPIO and GND                            | Switching HDMI-Sources, Audio Extractor        | GPIO, Pull port to GND                                       |
 | Quadro DSP        | (USB-Serial)                            | Poweramp, Check State                          | [Reverse Engineering](https://reverseengineering.stackexchange.com/questions/25066/t-amp-quadro-500-dsp-calculate-checksum) |
diff --git a/images/rack-perspective.jpg b/images/rack-perspective.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..ef8fb61cec45a3072dacbfcecd1dd84f39325c39
Binary files /dev/null and b/images/rack-perspective.jpg differ