Moilapp Installation Guide

This guide provides step-by-step instructions to install and run the MoilApp repository on Ubuntu 20.04 with Python version > 3.7.

Clone this Repository

1. Use the "git clone" command to download the code from the repository to your local machine.

$ git clone https://github.com/McutOIL/moilapp.git --branch=Moilapp-V4.0

Change Working Directory

2. After successfully cloning the repository, change working directory by using the command line below and the try to install . build.sh file top install all dependencies library.

$ cd moilapp

$ . build.sh

In case the command . build.sh above is installed Successfully , you can proceed to part 7. Nevertheless, if the installation fails, you can install manually by referring to section 3 below.

Check the display server protocol ubuntu version using this command

Check your protocol system in ubuntu version.

$ echo $XDG_SESSION_TYPE

If your computer is of the wayland type, you have to change to x11 to replace it. You can use the command below to disable it WaylandEnable=false. However, if your computer is already x11 type you can skip this section.

$ sudo nano /etc/gdm3/custom.config

and then, restart your computer.

$ sudo systemctl restart gdm3

we also recommend installing libxcb when your computer is type x11.

$ sudo apt install libxcb-cursor0

Set up Virtual Environment

3. Two ways to build a virtual environment are: installing it in general or specifically for Python. Use the provided command to prevent installation errors and ensure that dependencies required for each project are installed without interfering with other projects or the system's Python installation. A virtual environment helps developers maintain project stability and avoid compatibility issues between package versions.

$ sudo apt install virtualenv

$ virtualenv venv

or

$ python3.8 -m venv venv

note: you can change the python version ex: *python3.8, python3.9, python3.10

4. To start using the virtual environment, you need to activate it. You can do this by running the activate script located in the `bin` directory of your virtual environment. On Linux or macOS, use the following command:

$ source venv/bin/activate

5. Before installation the library requirements you should be to upgrade an existing package PIP to the latest version, you can use the command.

$ pip install --upgrade pip

Followed by the name of the package. This command will download and install the latest version of the package, replacing the older version that was previously installed.

6. With the environment activated, you can install all required packages. The packages will be installed in the virtual environment and will not affect the global Python installation.

$ pip install -r requirements.txt

Run the Application

7. After all ready, run the main program in `src` directory, on your terminal you can type this command to run the project

$ cd src

$ python3 main.py

That's it! You should now have the Moilapp repository installed and ready to use on your Ubuntu 20.04 machine.