commit 785f2859e336db49095a8443be8d204ba0989925
parent 9589072687726dd51776b0e952625ae1996f4721
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date: Wed, 16 Apr 2025 10:14:11 +0200
Updated readme
Diffstat:
M | README.md | | | 35 | +++++++++++++++++++++++++++++++---- |
1 file changed, 31 insertions(+), 4 deletions(-)
diff --git a/README.md b/README.md
@@ -99,10 +99,20 @@ file in the tools/results folder.
To build and run a tool in debug mode, use `make debugtool`.
-## Running commands manually
+## User interfaces
-This project also includes a rudimentary shell that can be used to run
-commands manually. To build the shell use:
+User interfaces for this software are in an experimental stage. Some
+examples are included in this repository, but they are not polished.
+If you are a developer and you are interested in contributing, have a
+look at the examples and let me know!
+
+## Command-line interface
+
+The `shell` folder contains the code for a rudimentary shell that can
+be used to run commands manually. The user experience in not amazing,
+as the commands require quite verbose options.
+
+To build the shell run:
```
$ make shell
@@ -150,7 +160,24 @@ $ ./run solve_scramble -solver h48h0k4 -n 1 -M 4 -moves "R' U' F"
F' U' R
```
-For a full list of available command, use `run help`.
+For a full list of available command, use `./run help`.
+
+### QT
+
+A draft for a QT-based GUI is contained in the `qt` folder. In order
+to build it you need QT libraries and headers (for QML / QT Quick
+development) and CMake. If your environment is set up, you can
+build the QT GUI with
+
+```
+$ make qt
+```
+
+And then run it with
+
+```
+$ ./nissyqt
+```
## Using this software as a library