Update readme.mdHEADmaster

1 files changed, 24 insertions, 8 deletions

diff --git a/readme.md b/readme.md
index 74cabe8..b5d1094 100644
--- a/readme.md
+++ b/readme.md
@@ -4,34 +4,50 @@ This tool is designed to facilitate learning songs, and solos in particular, by
 
 ## Dependencies
 
-See requirements.txt and pacman.txt for required packages.
+Python dependencies are listed in the pyproject.toml files of the different projects and should be automatically installed by `pip`.
+
+Non-Python dependencies are listed in pacman.txt and should be manually installed before running `make`.
 
 ## Usage
 
-To use the GUI, run:
+To set up the environment and run the tests, just use `make`:
+
+```
+make
+```
+
+The GUI can then be executed in the venv:
 
 ```
-python solo_tool_qt.py
+./venv/bin/solo_tool_gui
 ```
 
-Or for the (very basic) CLI:
+Alternatively, the tool can be executed in headless mode. In this case all it does is load the provided session and connect to the MIDI controller:
 
 ```
-python solo_tool_cli.py
+./venv/bin/solo_tool_cli
 ```
 
 ## MIDI
 
-It is currently possible to control the tool with MIDI. With the device plugged in, a connection can be established by clicking on "Connect MIDI" in the GUI or entering "midi connect" in the CLI. Currently the only device supported is the Novation Launchpad Mini Mk II.
+It is currently possible to control the tool with MIDI. With the device plugged in, a connection can be established by clicking on "Connect MIDI" in the GUI or running the headless binary. Currently the only device supported is the Novation Launchpad Mini Mk II.
+
+The MIDI device button mapping is documented in `doc/diagram.drawio`.
 
 ## Tests
 
 For the automated tests, run:
 
 ```
-pytest *test.py
+make test
+```
+
+or just
+
+```
+make
 ```
 
 ## Architecture
 
-More details on the architecture are available in `diagram.drawio`.
+More details on the architecture are available in `doc/diagram.drawio`.