README.md

Notessa

This application allows you to create notes of many types.

Table of contents

• Note
• Installing dependencies
• Building the project
• Creating a translation
• Known Issues

Note

Current version - Notessa 3. It was compiled for Windows 10/11, on Linux and macOS some things may not work correctly.

Installing dependencies

To install dependencies you need to run the following command:

pip install -r requirements.txt

The version of Python for which the project was developed: 3.12

The entry point to applications is the app.py file, which is located in the Notessa directory.

You need to enter the command while above the directory!

Notessa
├── app.py
├── ...
└── ...

While in the directory above, you need to run the command:

for Windows

python -m Notessa.app

for Linux

python3 -m Notessa.app

Building the project

While in the directory with the app.py file, enter the command:

pyinstaller --name="Notessa" -w app.py

The application will be built, and a Notessa.spec file will be created in the same directory. Subsequently, you can build/rebuild the project using this manifest:

pyinstaller Notessa.spec

Creating a translation

While in the project directory, i.e. in "Notessa", to create a file for translation, you must enter the following command:

pyside6-lupdate ./ -ts ru.ts

This file can then be opened in Qt Linguist and the required parts can be translated. After the translation is completed, you need to convert the file from .ts to .qm format. This is done as follows:

pyside6-lrelease ru.ts -qm ru.qm

After successful conversion, the files must be placed in the project directory in the ./resource/translations/ directory Next, if a resource file with translations exists, you need to enter a line with a new translation file:

<RCC>
  <qresource>
    <file>translations/en.qm</file>
    <file>translations/ru.qm</file>
  </qresource>
</RCC>

Finally, you need to convert the resource file to a Python file as follows:

pyside6-rcc translations.qrc -o translations_rc.py

Known Issues

• Sometimes, while in CreateVideoNoteWidget and after closing it, the application crashes. The reason is not clear.
• Cannot find the correct canvas size in CreatePaintNoteWidget. There have been attempts to measure the height of widgets to calculate the correct size, but the attempts were unsuccessful.
• Currently, it is not possible to resize the entire application window. This is because there is an issue with PaintNote canvas being sized correctly. In addition, at the moment it is not clear how to correctly resize the PaintNote canvas (not scaling, but the size, as in the Paint graphic editor in Windows).
• The application window can be moved in Windows, but it doesn't work in Linux (tested only in Ubuntu 22.04). This is due to a Qt issue (Wayland relocation issue). In X11 (tested in Manjaro KDE kernel 6.1.31-2-Manjaro DE Plasma 5.27.5), the ability to move the window is available, but it does not work correctly (jerks, super-fast movement).
• In the new version of the application (applies to Linux, tested on Ubuntu 22.04), it is not possible to get a preview from the webcam or record video, although sound is recorded. In Windows 10, recording and display occurs correctly. The triggering of the Webcam is also not clear, either this is due to the camera taking a long time to load, or a problem with the media classes.
• There is no message about the need to manually restart the application after changing the language.