====== Version v3.11.0 or more recent ======
==== Debian/Ubuntu/Mint ====
Tested on Ubuntu 22.04. Unfortunately Actiona requires Qt 6.4 or more recent, so we can't use the system libraries.

Dependencies:
<code bash>
sudo apt-get install git-core build-essential cmake libnotify-dev libopencv-dev libxtst-dev libglx-dev libgl1-mesa-dev libxcb-cursor0 libudev-dev libbluetooth-dev libxkbcommon-dev
</code>

Download the [[https://www.qt.io/download-open-source|Qt online installer]] (open source edition) and install it.

Create/Sign up to your Qt Account, choose "Custom installation".

Install Qt 6.6.3 (Qt 6.7 is not compatible) with the following modules:
	- Desktop
	- Qt 5 Compatibility Module
	- Additional Libraries
		- Qt Multimedia
		- Qt Speech

Get the code.
<code bash>
git clone --recursive https://github.com/Jmgr/actiona.git
</code>

Enter the actiona directory:
<code bash>
cd actiona
</code>

Then build (you might have to replace $HOME/Qt with the path where your Qt installation resides).
<code bash>
mkdir build
cd build
cmake .. -DCMAKE_PREFIX_PATH=$HOME/Qt/6.6.3/gcc_64 -DCMAKE_BUILD_TYPE=Release
cmake --build .
</code>

To run actiona, enter:
<code bash>
./actiona/actiona
</code>

===== Windows (with MinGW) =====
  - Download and install the Qt online installer: https://www.qt.io/download-qt-installer-oss (note that you will need to create an account and log in)
    - Select Qt 6.6.3 (Actiona 3 is not compatible with newer versions at the moment)
    - Check Qt 5 Compatibility Module
    - In "Additional libraries":
      - Check Qt Multimedia
      - Check Qt Speech
  - Install CMake: https://cmake.org/download/
  - Install Git: https://gitforwindows.org/
  - Download the source code for OpenCV 4.x: https://opencv.org/releases/ and extract the archive
  - Open a Command Prompt: (update the path to Qt if you installed it somewhere else)
<code bash>
set PATH=C:\Qt\Tools\mingw1120_64\bin;%PATH%
cd <OpenCV directory>
mkdir build
cd build
cmake -G "MinGW Makefiles" -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=. -DBUILD_SHARED_LIBS=ON -DBUILD_TESTS=OFF -DBUILD_EXAMPLES=OFF -DBUILD_opencv_world=OFF -DBUILD_opencv_calib3d=OFF -DBUILD_opencv_dnn=OFF -DBUILD_opencv_features2d=OFF -DBUILD_opencv_flann=OFF -DBUILD_opencv_gapi=OFF -DBUILD_opencv_highgui=OFF -DBUILD_opencv_ml=OFF -DBUILD_opencv_objdetect=OFF -DBUILD_opencv_photo=OFF -DBUILD_opencv_stitching=OFF -DBUILD_opencv_video=OFF -DBUILD_opencv_videoio=OFF -DBUILD_opencv_imgcodecs=OFF -DBUILD_opencv_java=OFF -DBUILD_opencv_js=OFF -DBUILD_opencv_python_bindings_generator=OFF -DBUILD_opencv_ts=OFF -DBUILD_opencv_perf_core=OFF -DBUILD_opencv_perf_imgproc=OFF -DBUILD_opencv_perf_features2d=OFF -DBUILD_opencv_perf_flann=OFF ..
cmake --build .
</code>
  - Open Git Bash: (and cd to the directory where you want to save the source code for Actiona)
    - <code bash>git clone --recursive https://github.com/Jmgr/actiona.git</code>
  - Open QtCreator:
    - in Edit -> Preferences, check that your kits are not greyed out: if so, check that the CMake tool is set
    - File -> Open file or project, select the CMakeLists.txt file in the Actiona source code directory
    - Set the build type to Release (Debug builds are not currently working when using MinGW on Windows)
    - In Projects -> CMake -> Initial Configuration, click Add on the right, then Directory.
    - Add "OpenCV_DIR" as the key, and "<OpenCV directory>\build" as the value
    - Click "Re-configure with Initial Parameters"
    - In Build steps -> Details, in Tool aguments, add -j (allows compiling with more than one core)
    - Build
  - You should be able to run Actiona from within QtCreator now

====== Version v3.10.2 or older ======

===== Windows =====
  - Install Visual Studio 2015 (Community edition should work)
  - Install Qt (5.2.0 or more recent, QtScript is needed)
  - Install QtCreator
  - Install OpenCV binaries for Windows (version 2.x)
  - Open CMakeLists.txt using QtCreator
  - In the "Projects" tab, in "additional arguments", add:
    - OPENCV_LIB="Path to the OpenCV library folder" (where all the .lib are)
    - OPENCV_INCLUDE="Path to the OpenCV include path" (containing the opencv2 folder)
    - OPENCV_LIB_CORE=Name of the core library filename (for example opencv_core249)
    - OPENCV_LIB_IMGPROC=Name of the imgproc library filename (for example opencv_imgproc249)
  - Compile
  - Copy the opencv_corexxx.dll and opencv_imgproc.dll files from the OpenCV install path to the build directory containing all the binaries that where built in the previous step
  - Run
===== GNU/Linux =====
==== Debian/Ubuntu/Mint ====
=== First download ===
We need Git, a C++ compiler (that can compile C++11 code, so for GCC, version 4.7 or better), Qt and all dependencies:
<code bash>
sudo apt-get install git-core build-essential cmake qtbase5-dev libqt5x11extras5-dev libqt5xmlpatterns5-dev libqt5texttospeech5-dev qtscript5-dev qttools5-dev qtmultimedia5-dev qttools5-dev-tools libnotify-dev libudev-dev libopencv-dev libxtst-dev
</code>

If you want to use SQL databases you will also have to install the corresponding bindings, for instance, MySQL:
<code bash>
sudo apt-get install libqt5sql5-mysql
</code>

Get the code.
<code bash>
git clone --recursive https://github.com/Jmgr/actiona.git
</code>

Enter the actiona directory:
<code bash>
cd actiona
</code>

Then build.
<code bash>
mkdir build
cd build
cmake ..
cmake --build .
</code>

To run actiona, enter:
<code bash>
./actiona
</code>

=== Update ===
To update your version, open a terminal, go to the actiona/build directory and enter
<code bash>
git pull
cmake ..
cmake --build .
</code>