Eli application

Tutorial 1 Installation

Date: March 28, 2020, 8:11 p.m. |

This tutorial explains how to install Eli application on your computer. Eli can be installed on Windows operating system or on Linux operating systems. It should works also on Mac OS but I did not try it.

Windows installation

There are three options how to install Eli application on windows computer:

Install setup package: Download Windows 64-bit installer from download page. Run setup file as administrator. Application will be installed to “Program files” directory. Run eli application from startup menu or from desktop icon.
Install executable package: Download Windows 64-bit non installer package from download page. Unzip it to some directory where user has read/write permission. It can be unzipped as a standard user. Go to eli/bin directory and run eli.exe. Eli application will start
Install from source code: Download Source code package from download page and unzip it to some directory where user has read/write permission. It can be unzipped as a standard user. Source code can be downloaded also from github: https://github.com/TomasStachera/Eli . Install followed SW for source code compilation:
- wxWidgets: Install it from page: https://www.wxwidgets.org/ Add wxWidgets directory to system path. (Go to System variable and change variable PATH)
- OpenCV: Install it from page : https://opencv.org/ . Add OpenCV directory to system path. (Go to System variable and change variable PATH)
- cmake: Install it from page: https://cmake.org/
- MinGW: Install it from page: http://www.mingw.org/ . It can be used also another C++ compiler instead Mingw.
- After installation all needs packages go to eli root directory and open file CmakeLists.txt and find follow paragraph:
```
      # Declare wxWidgets directory
      IF(WIN32)
      SET(wxWidgets_ROOT_DIR C:/prog_linux/wx64)
      SET(wxWidgets_LIB_DIR C:/prog_linux/wx64/lib/gcc_dll)
      SET(wxWidgets_LIBRARIES C:/prog_linux/wx64/lib/gcc_dll)
      SET(wxWidgets_INCLUDE_DIRS C:/prog_linux/wx64/include)
      ENDIF()
```
- Change directory path according your wxWidgets path. If you want to create setup package find new paragraph on the end of file:
```
set(CPACK_GENERATOR "RPM")
```
- Change generator type to “NSIS”. Save CmakeLists.txt file.
- Open Windows terminal.
- Go to Eli root directory (directory where CmakeLists.txt is placed)
- Create directory build:
```
#mkdir build
          
```
- Go to build directory:
```
#cd build
```
- Execute cmake command :
```
#cmake -G "MinGW Makefiles" ..
```
  Remark:This command is valid only if MinGw compiler is used, if you use another compiler change “-G” option. Do not forget 2 dots in the end of command. It means that CmakeLists.txt is up one directory.
- If cmake command was without error you can compile source code with follow command.
```
#mingw32-make
```
- If compilation is without errors it will be eli.exe file with two library files in build directory.
- Run application by click on eli.exe. If you have some errors with missing dll, check if OpenCV an wxWidgets library is set in system path.
- If you want create setup package, create directory dlls inside build directory and copy all wxWidgets and OpenCV dlls to this directory. Copy also Mingw Dlls which is necessary for running application. Look on executable package /bin directory to see which dlls needs to be copied.
- Run package command:
```
#mingw32-make package
```
- If command is without errors setup package is creates in build directory. Run setup file for install eli application

Linux installation

There are two options how to install Eli application on Linux operating system. The first option is compile from source code. This option can be used for all linux distribution. The second option is install from binary package. This option is available only for Fedora and Ubuntu distribution.

Install binary package: Select this option only if you have Ubuntu or Fedora 64 bit application. At first install wxWidgets and OpenCv library, which is needed for Eli application.
- Ubuntu: Open terminal window and write follow commands:
```
#sudo apt install libwxgtk-media3.0-0v5 libwxgtk-media3.0-gtk3-0v5 libwxgtk-webview3.0-gtk3-0v5 libwxgtk3.0-0v5 libwxgtk3.0-gtk3-0v5
#sudo apt install libopencv-dev
#sudo apt install python3-opencv
```
- Fedora: Open terminal window and write follow commands:
```
#sudo dnf install opencv opencv-devel wxGTK3-devel
```
- Download binary package for your distribution. Go to directory where binary package was downloaded and type:
- Ubuntu:
```
#sudo sudo apt install ./Eli-1.0.deb
```
- Fedora:
```
#sudo dnf install ./Eli-1.0.rpm
```
- Run command Eli in terminal for start Eli application
Install from source code: This option can be used for all linux distributions. At first you need install package needs for compilation:
- g++ compiler
- cmake
- OpenCV package(standard package + devel):
  Ubuntu:
```
#sudo apt install libopencv-dev
#sudo apt install python3-opencv
```
  Fedora:
```
#sudo dnf install opencv opencv-devel
```
- wxWidgets package (standard package+ devel):
  Ubuntu:
```
#sudo apt install libwxgtk-media3.0-0v5 libwxgtk-media3.0-gtk3-0v5 libwxgtk-webview3.0-gtk3-0v5 libwxgtk3.0-0v5 libwxgtk3.0-gtk3-0v5
#sudo apt install libwxgtk-media3.0-dev libwxgtk-media3.0-gtk3-dev libwxgtk-webview3.0-gtk3-dev libwxgtk3.0-dev libwxgtk3.0-gtk3-dev
```
  Fedora:
```
#sudo dnf install  wxGTK3-devel
```
- Download Source code package from download page and unzip it to some directory where user has read/write permission. Source code can be downloaded also from github: https://github.com/TomasStachera/Eli .
- Go to eli root directory and open file CMakeLists.txt and find follow paragraph in the end of file:
- Change package generator according your distribution (RPM or DEB or other)
- Save CmakeLists.txt and close this file.
- Create build directory:
```
#mkdir build
```
- Go to build directory:
```
#cd build
```
- Execute cmake command :
```
#cmake  ..
```
- If there is no error, makefile should be generated in build directory
- Compile application with make command:
```
#make 
```
- If compilation is without error run eli application be execute:
```
# ./Eli
```
- If you want create installation package run command:
```
# make package
```
- Install package on your system
Append Eli application to Gnome desktop.
If you want to run eli application from gnome panel you need to create desktop file:
- Create empty file eli.desktop
- Insert follow lines in eli.desktop file:
```
[Desktop Entry]
Type=Application
Encoding=UTF-8
Name=Eli
Comment=Eli gui program
Exec=/usr/bin/Eli
Icon=/usr/share/Eli/icons/eli_icon.png
Terminal=false
```
  Remark: This file expected that eli is installed to usr/bin directory. If you use another directory change Exec and Icon part according installed directory.
- Save eli.desktop file
- This file should be copied to /usr/share/applications directory for access to all user or to ~/.local/share/applications for access only for current user

Tutorial 1 Installation

Leave comments:

Comments: