Troubleshooting an Issue

When using any application, it's possible to encounter issues or problems that can prevent it from functioning as intended. These issues may range from minor annoyances to major bugs that significantly impact the user experience. As a user of the application, it's important to report these issues to the developers so that they can be addressed and fixed.

Overall, reporting issues is a crucial part of the software development process, and it helps to ensure that applications are reliable, functional and user-friendly. Such issues can be found below:

Application Installation

If you encounter problems with some libraries (requirements.txt), such as some libraries that cannot be installed on the computer, as shown in the image below:

alternate text

PyQt6 cannot installation

alternate text

Sphinx-rtd-theme incompatible (Theme)

We recommend creating a specific virtual environment for no errors to occur when users do installation the library. Like the following.

$ sudo apt-get install python3.9-venv​

$ python3.9 -m venv venv​

$ source venv/bin/activate​
$ pip --version

Screen Recording on Application

That is a difficulty when utilizing MoilApp screen recording functions because the captured video can only be seen as a black screen and cannot be played back caused by the type system protocol. You may fix it, though, by following the instructions below.

alternate text

Wayland type screen

Command to check type security screen

$ echo $XDG_SESSION_TYPE
alternate text

open configuration

Command to open custom configuration

$ sudo nano /etc/gdm3/custom.config
alternate text

Change to waylandEnable=False

alternate text

Restart your computer

Command for restart your computer

$ sudo systemctl restart gdm3

The last way is if the condition has been on x11 type, however, the program still cannot be running, may you should be typing command on your terminal to fix it.

$ sudo apt install libxcb-cursor0

Python.h Missing on Python-dev

If you encounter installation problem with pybind while using MoilCV, you can install python-dev that is compatible with your Python version to resolve the issue. The steps to take so are the instruction provided below.

$ sudo apt-get install python3.8-dev

or

$ sudo apt-get install python3.9-dev
alternate text

Python-dev installed based on version

Sphinx Documentation for PDF

Difficulty in accessing the MoilApp documentation in PDF format is a common issue encountered by users. This is often caused by errors that occur during the initial conversion of the documentation to HTML. To resolve this issue. Please endure that you follow the instructions carefully.

alternate text

Convert rst file to html file

If the following error occurs, we advise installing an additional library so that it can be converted properly.

Command for install library

$ sudo apt install latexmk

$ sudo apt install textlive-latex-extra

The command below can be typed in the terminal to access the documentation.

Command for generate file

$ make html

$ make latexpdf

This command is employed for deleting a documentation file, and it is also beneficial when updating a modified file. If the previous file is not deleted, the documentation will still show the outdated file instead of the updated version.

$ make clean

Application running

You cannot update the application when an update notification is there when you establish a new branch and add some functions or alter the source code. You will encounter an error and a dump if you try this. alternate text

check for update on local branch

To update your branch, you can utilize this command in case you encounter an error. This command will ensure that any changes made are saved locally.

$ git stash save "Save comment in local computer"

And then, try do change another branch again.

$ git checkout "develop/main"

Adjustment of name your branch want to change

References