Move LabRecorder into the monorepo as a component

THIRD-PARTY-NOTICES.md

@@ -37,11 +37,43 @@ Catch2 (https://github.com/catchorg/Catch2), Boost Software License
 
 ---
 
+## LabRecorder (MIT License)
+
+Recording application, vendored as a component at `apps/LabRecorder/`. Retains
+its upstream MIT license, including the security integration added here; the
+notice is also kept at `apps/LabRecorder/LICENSE`.
+
+```
+MIT License
+
+Copyright (c) 2012 Christian Kothe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+---
+
 ## pylsl (MIT License)
 
-Python binding, vendored as a component at `apps/pylsl/`. Retains its
-upstream MIT license, including the security integration added here; the notice
-is also kept at `apps/pylsl/LICENSE`.
+Python binding, vendored as a component at `apps/pylsl/`. Retains its upstream
+MIT license, including the security integration added here; the notice is also
+kept at `apps/pylsl/LICENSE`.
 
 ```
 Copyright (c) 2012-2018 Christian A. Kothe

apps/LabRecorder/.gitignore

@@ -0,0 +1,20 @@
+*.ui.autosave
+ui_*.h
+/build*/
+/package*/
+/install*/
+/CMakeLists.txt.user
+/CMakeLists.json
+/.vs/
+/.vscode/
+/out/
+/CMakeSettings.json
+# CLion
+.idea/
+cmake-build-debug/
+cmake-build-release/
+# Generated by CI scripts - or maintainers debugging CI scripts:
+liblsl.deb
+install-qt.sh
+.DS_Store
+

apps/LabRecorder/.travis.yml

@@ -0,0 +1,38 @@
+language: cpp
+compiler: clang
+env:
+  APP_VERSION="1.13.1"
+matrix:
+  include:
+  - os: osx
+    osx_image: xcode10.1
+before_install:
+- mkdir LSL
+- brew update
+- brew upgrade cmake
+install:
+- git clone https://github.com/sccn/liblsl.git
+- cmake -S liblsl -B liblsl/build -DCMAKE_INSTALL_PREFIX=$PWD/LSL/ -DLSL_UNIXFOLDERS=ON ..
+- cmake --build liblsl/build --config Release --target install
+before_script:
+- brew install qt;
+- export LSL_INSTALL_ROOT=LSL
+script:
+- cmake --version
+- cmake -S . -B build -DLSL_INSTALL_ROOT=${LSL_INSTALL_ROOT} -DQt5_DIR=/usr/local/opt/qt/lib/cmake/Qt5
+- cmake --build build --config Release --target install
+- cd build/install/Labrecorder
+- if [[ "$TRAVIS_OS_NAME" == "osx" ]]; then for app in *.app; do /usr/local/opt/qt/bin/macdeployqt
+  ${app} -dmg; mv "${app%.app}.dmg" "${app%.app}-${APP_VERSION}-${TRAVIS_OSX_IMAGE}.dmg";
+  done; fi
+deploy:
+  provider: releases
+  skip_cleanup: true
+  api_key:
+    secure: FQ+xqPuImk2ie4KeoDrP1u+6TB2qIoLPTk0wr7EEv+7oBfLodExVSyC67TEUVKUVnAYv2E1FFfHLZPUzMeiuFT6o40jkwekHEte3dbgWTgmW9iqiDw4eK5X0obZbDoYLJBbOiQfUsgH8nKpE/U5MprTpQ3KKQr2CjbcqGZnDY6k2yNope70bMe//4zBgv+qjvR1CDeI8sSrSUkBgDgVhujqNzS8I0FPoLAmJuBuFiA5Y7f/uwO17M1Nfso9WnNiWA8XhgJ1mgoA8BYrIx9hP2niK4gkFJ3p/iV0IK51KNxEELIQ7IKw/U12CLYD7+hKFBpyrZGcgCwXCHXR/G3/kNsxJrk395u+78gTLdiE3AuksWQZ+f+6br2pBG3UBTu/Qm3cVcVQRtNArKXDgiCaMc0qECL51o6qNTzPhLAHvGVGZCOjp34vW44MMWtKh584LqShojN/DH1OBUR3PjaHHiuxQMuaUXHto8SDfl0ZRSaeyElI+6kmU3XfTJfqFq2DpTX5LMYoiZUXwMKKQtWTGp8I2axL1LCnUsX/nlY63AoCY7CJTwX+DE1//YBwOsfafQ/VOMIpzQCXJNuHR3EAFVk+qcFt0wTVu/aa2oTkBaGN67LE22/pkwT4kxpI3kaXDo94CE0diEZWu4hHHNoQF1C/WuH/DH4HErJW8tPGrEm8=
+  file:
+  - LabRecorder-${APP_VERSION}-${TRAVIS_OSX_IMAGE}.dmg
+  - LabRecorderCLI-${APP_VERSION}-${TRAVIS_OSX_IMAGE}.dmg
+  on:
+    repo: labstreaminglayer/App-LabRecorder
+    tags: true

apps/LabRecorder/BUILD.md

@@ -0,0 +1,125 @@
+# Building Lab Recorder
+
+This file includes quick start recipes. To see general principles, look [here](https://github.com/labstreaminglayer/labstreaminglayer/blob/master/doc/BUILD.md).
+
+
+## Windows - CMake - Visual Studio 2017
+
+Starting with Visual Studio 2017, Microsoft began to support much closer integration with CMake. Generally, this uses the Visual Studio GUI as a wrapper around the CMake build files, so you should not expect to see most of the Visual Studio Project configuration options that you are familiar with, and CMake projects cannot be directly blended with non-CMake Visual Studio projects. There are also some weird gotchas, described below.
+
+You will need to download and install:<BR/>
+ * [The full LabStreamingLayer meta project](https://github.com/labstreaminglayer/labstreaminglayer) -> Clone (include --recursive flag) or download  
+ * [Visual Studio Community 2017](https://imagine.microsoft.com/en-us/Catalog/Product/530)
+ * [CMake 3.12.1](https://cmake.org/files/v3.12/)
+ * [Qt 5.11.1](https://download.qt.io/archive/qt/5.11/) 
+ * [Boost 1.65.1](https://sourceforge.net/projects/boost/files/boost-binaries/1.65.1/boost_1_65_1-msvc-14.1-32.exe/download)
+
+
+From Visual Studio:<BR/> 
+ * File -> Open -> CMake -> labstreaminglayer/CMakeLists.txt
+ * Wait while CMake configures automatically and until CMake menu turns black
+ * Select x86-Release
+ * CMake menu -> Change CMake Settings -> LabStreamingLayer
+
+Add the "variable" section to the x86-Release group, so that it looks approximately like this:
+```
+{
+  "name": "x86-Release",
+  "generator": "Ninja",
+  "configurationType": "RelWithDebInfo",
+  "inheritEnvironments": [ "msvc_x86" ],
+  "buildRoot": "${env.USERPROFILE}\\CMakeBuilds\\${workspaceHash}\\build\\${name}",
+  "installRoot": "${env.USERPROFILE}\\CMakeBuilds\\${workspaceHash}\\install\\${name}",
+  "cmakeCommandArgs": "",
+  "buildCommandArgs": "-v",
+  "ctestCommandArgs": "",
+  "variables": [
+    {
+      "name": "Qt5_DIR",
+      "value": "C:\\Qt\\5.11.1\\msvc2015\\lib\\cmake\\Qt5 "
+    },
+    {
+      "name": "BOOST_ROOT",
+      "value": "C:\\local\\boost_1_65_1"
+    },
+    {
+      "name": "LSLAPPS_LabRecorder",
+      "value": "ON"
+    }
+  ]
+}
+```
+
+ * Also consider changing the build and install roots, as the default path is obscure. When you save this file, CMake should reconfigure, and show the output in the output window (including any CMake configuration errors).
+
+ * Note that it is not a typo that Qt refers to msvc2015 rather than msvc2017.
+
+ * Select Startup Item (green arrow dropdown) -> LabRecorder.exe (Install)
+
+ * Click the green arrow. The application should launch.
+
+Note that if you change Qt versions, or other significant changes, it will be necessary to do a full rebuild before CMake correctly notices the change. CMake -> Clean All is not sufficient to force this.
+
+Just deleting the build folder causes an unfortunate error (build folder not found) on rebuild. To do a full rebuild, it is necessary to change the build and install folder paths in CMake -> Change CMake Settings -> LabStreamingLayer, build, then delete the old folder, change the path back, and build again.
+
+
+## Windows - CMake - Legacy
+
+This procedure also works in Visual Studio 2017, if desired. Generally, I'd recommend sticking with the newer procedure and Visual Studio 2017.
+
+This procedure generates a Visual Studio type project from the CMake files, which can then be opened in Visual Studio.
+
+You will need to download and install:<BR/>
+ * The full [LabStreamingLayer meta project](https://github.com/labstreaminglayer/labstreaminglayer) -> Clone (include --recursive flag) or download  
+ * Desired Visual Studio Version (the example uses 2015).
+ * [CMake 3.12.1](https://cmake.org/files/v3.12/)
+ * [Qt 5.11.1](https://download.qt.io/archive/qt/5.11/) 
+ * [Boost 1.65.1](https://sourceforge.net/projects/boost/files/boost-binaries/1.65.1/boost_1_65_1-msvc-14.1-32.exe/download)
+
+From the command line, from the labstreaminglayer folder:
+ * labstreaminglayer\build>cmake .. -G "Visual Studio 14 2015" -DQt5_DIR="C:/Qt/5.11.1/msvc2015/lib/cmake/Qt5" -DBOOST_ROOT=C:\boost\boost_1_65_1 -DLSLAPPS_LabRecorder=ON
+
+ * labstreaminglayer\build>cmake --build . --config Release --target install
+
+To see a list of possible generators, run the command with garbage in the -G option. 
+
+The executable is in labstreaminglayer\build\install\LabRecorder.
+
+You can open the Visual Studio Project with labstreaminglayer\build\LabStreamingLayer.sln.
+
+The command line install feature does not put build products in the sample place as when you build inside of Visual Studio. To get running to work inside of Visual Studio, it is necessary to copy the support files from labstreaminglayer\build\install\LabRecorder to labstreaminglayer\build\Apps\LabRecorder\Release. You must also right click LabRecorder -> Set as Startup Project and select Release and Win32.<BR/>
+
+If any significant changes are made to the project (such as changing Qt or Visual Stuido version) it is recommended that you delete or rename the build folder and start over. Various partial cleaning processes do not work well.
+
+
+## Linux
+
+    * Ubuntu (/Debian)
+        * `sudo apt-get install build-essential cmake qt5-default libboost-all-dev`
+
+1. Open a Command Prompt / Terminal (Windows: MSVC Command Prompt) and change into this directory.
+1. Make a build subdirectory: `mkdir build && cd build`
+1. Call cmake
+    * `cmake ..`
+    * If your liblsl binaries are not in `../../LSL/liblsl/build/install`, add the path (`cmake -DLSL_INSTALL_ROOT=/path/to/liblsl/binaries ..`)
+    * Optional: Use a [generator](https://cmake.org/cmake/help/latest/manual/cmake-generators.7.html#visual-studio-generators)
+1. You may need to specify additional cmake options.
+ . Build everything and copy the files to the `install` folder:
+    * `cmake --build . --target install`	
+
+
+## OS X
+
+    * Use [homebrew](https://brew.sh/)
+        * `brew install cmake qt boost`
+
+1. Open a Command Prompt / Terminal (Windows: MSVC Command Prompt) and change into this directory.
+1. Make a build subdirectory: `mkdir build && cd build`
+1. Call cmake
+    * `cmake ..`
+    * If your liblsl binaries are not in `../../LSL/liblsl/build/install`, add the path (`cmake -DLSL_INSTALL_ROOT=/path/to/liblsl/binaries ..`)
+    * Optional: Use a [generator](https://cmake.org/cmake/help/latest/manual/cmake-generators.7.html#visual-studio-generators)
+1. You may need to specify additional cmake options.
+ . Build everything and copy the files to the `install` folder:
+    * `cmake --build . --target install`
+