From 655f5b87c43f4ac5cfaef6be482d652c532edc23 Mon Sep 17 00:00:00 2001 From: Eddy Pedroni Date: Sun, 10 Nov 2024 12:32:32 +0100 Subject: Update readme.md --- readme.md | 32 ++++++++++++++++++++++++-------- 1 file 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`. -- cgit v1.2.3