System requirements

• 64-bit Windows 10 version 1809 (build 17763) or later, or 64-bit Windows 11;
• at least 1 GB of free space for installation and temporary extraction;
• additional free space for projects, original images and exports;
• the two-pane editor is most comfortable to use on a higher-resolution display.

1. Download the installer

   The file name is JegyzokonyvGenerator-3.0.5-windows-x86_64-Setup.exe. Wait until your browser has fully completed the download.

2. Verify the file

   Use the SHA-256 verification, particularly if you received the installer on a USB drive or through another intermediary.

3. Close any running older version

   Save the open project, then close the application. The installer will notify you if an instance is still running.

4. Start the installer

   Double-click the downloaded EXE. Installation takes place under your own user account, so an administrator password is not normally required.

5. Handle the SmartScreen warning safely

   Version 3.0.5 is not signed with an Authenticode certificate, so Windows may display “Windows protected your PC”. If, and only if, the file name and SHA-256 value match, select More info, followed by Run anyway. Do not disable SmartScreen or antivirus protection globally.

6. Follow the installer steps

   Read the licence terms, choose whether to create a desktop shortcut, then begin installation. A Jegyzőkönyv Generátor shortcut is created in the Start menu.

7. First launch

   Start the application from the Start menu. It creates the user-data and log folders on first launch. An internet connection is not required for normal editing or export.

Checking compatibility

64-bit x86-64 Linux with glibc 2.38 or later is required. A graphical Linux desktop session and the usual X11 or Wayland, OpenGL/EGL, XCB, xkbcommon, fontconfig and D-Bus system libraries are also needed. The package is not intended for Alpine/musl, headless or minimal server systems. Check the architecture and glibc version in a terminal:

uname -m
ldd --version

The expected result of the first command is x86_64. The glibc version shown by the second command must be at least 2.38.

Extracting and starting from a terminal

tar -xzf JegyzokonyvGenerator-3.0.5-linux-x86_64-portable-nuitka.tar.gz
cd JegyzokonyvGenerator
chmod +x JegyzokonyvGenerator
./JegyzokonyvGenerator

The chmod command is normally required only before the first launch. Keep the complete JegyzokonyvGenerator directory together: the application will not work without the Qt, font, template and licence files beside the executable.

Starting from the file manager

In the properties of the extracted JegyzokonyvGenerator file, allow the file to run as a program, then start it by double-clicking. The exact wording varies between desktop environments.

1. Install or extract the release for your system, then start the application.
2. Select Fájl → Új projekt (File → New project) if the application does not open with an empty form.
3. On the Alapadatok (Basic data) tab, enter the date and all required fields marked with an asterisk.
4. On the Állományok (Datasets) tab, enter the available products and check the unit beside every numeric value.
5. On the Hely és engedély (Location and permit) tab, enter WGS84 or EOV coordinates and record permit numbers where applicable.
6. On the Képek és SEO (Images and SEO) tab, select a company logo, an overview image and any additional figures, then check the captions.
7. Review the élő előnézet (live preview) on the right. The application retains its current scroll position while you edit.
8. Select Projekt mentése (Save project). When saving for the first time, choose a location and name for the .jkvproj project folder.
9. Click the always-visible HTML + PDF export… button at the bottom left, or press Ctrl+E.
10. Open both the HTML and the PDF in the finished export. When publishing on the web, upload the complete export folder without changing its directory structure.

Recommended workflow: create and save a project first, save regularly while working, and review the preview before export. Updating the live preview does not by itself save the project.

This tab lists the delivered datasets related to the survey and its processing:

• number, sensor and size of raw images;
• number and size of oblique documentation images;
• physical size of the project file;
• number of point-cloud points and LAS file size;
• DFM and DDM resolution and file size;
• GeoTIFF and ECW orthophoto resolution and size;
• boundary format, such as Shapefile or KML;
• direct georeferencing with RTK correction and terrestrial geodetic survey;
• free-text notes.

Units and missing values

Each numeric field has a clearly visible drop-down unit selector. Available units are mm, cm or m for resolution; MB, GB or TB for file size; db for item count; and pont for point count.

If a value is unavailable or not applicable, leave the value empty and select the Üres (Empty) unit. Do not type “nincs” (none), a dash or text containing a unit in a numeric field.

RTK and geodetic indicators

In addition to an empty value, the list offers I, N and –. Use them consistently according to the meaning adopted by your organisation; if no reliable information is available, leave the field empty.

Coordinates

• WGS84: enter latitude (lat) first, followed by longitude (lon). Example: 47,4979 and 19,0402.
• EOV: the X field is the northing coordinate and the Y field is the easting coordinate. Follow the field labels rather than the column order used by another application.
• The WGS84 → EOV and EOV → WGS84 buttons perform manual conversion.
• When Automatikus átszámítás (Automatic conversion) is enabled, completing the coordinate pair in one system also updates the values in the other system.

Verification: conversion does not determine whether the entered point is professionally correct. Before export, compare it with a known map location and take particular care with the lat/lon and EOV X/Y order.

Permits

The fields for aerial remote-sensing, airspace and environmental research permit numbers appear when Engedélyszámok megadása (Enter permit numbers) is enabled. Disabling it clears the fields, so turn it off only if you genuinely intend to remove these data.

Images and captions

1. Beside Céges logó (Company logo), click Tallózás… (Browse), then select the image file.
2. Áttekintő kép (Overview image) is the first large figure. Its default caption is “A terület átnézeti képe”. You may freely edit the text; if you leave it empty and move away from the field, the default is restored.
3. Click További ábra hozzáadása (Add another figure) to create fields for Második ábra, Harmadik ábra and subsequent numbered figures.
4. Each additional figure has its own multi-line caption. Sor eltávolítása (Remove row) removes that figure and its caption from the project.

Supported image types are PNG, JPEG, WebP, GIF, BMP and TIFF. An image may be no larger than 100 MB or 100 million pixels. The application checks the actual image content, not merely the file extension.

You may add up to 100 additional figures to the project in addition to the Overview image.

Original and web images: when the project is saved, a secure copy of the original image is placed in the project’s media folder. During export, a reduced-size WebP image no wider than 650 pixels is generated from it for the website. The original project image is not modified.

SEO and web integration

SEO-cím (SEO title)

If empty, the project name is used. Keep it brief and clear because it becomes the search-result title; the maximum length is 200 characters.

SEO-leírás (SEO description)

If empty, the application creates a description automatically. A custom description can summarise the content more precisely; metadata longer than 320 characters is truncated.

SEO-kulcsszavak (SEO keywords)

This field cannot be edited. Its automatic order is HRAMN, topic title, topic date, orthophoto, model, point cloud, photogrammetry.

Kanonikus webcím (Canonical URL)

The report’s final, complete http:// or https:// address. Leave it empty until final hosting and a permanent URL are available.

Közösségi megosztási kép (Social sharing image)

Enter a complete https:// image URL. If left empty, the selected Overview image becomes the default sharing image; no automatic sharing image is created if there is no Overview image.

Dokumentum nyelve (Document language)

A BCP 47 code, such as hu or hu-HU. The default is hu.

Földrajzi régió (Geographic region)

For example, HU or HU-BU. The default is HU.

A .jkvproj project is a folder, not a single file

On the first save, the application creates a directory such as veszprem-20260715.jkvproj. Its main contents are:

veszprem-20260715.jkvproj/
├── project.json       form data
├── media/             project copies of the original images
└── .project-save.lock hidden file used for save locking

The hidden .project-save.lock file is normal and does not indicate a stuck active lock. Do not delete it manually. When transferring the project to another computer, always copy the complete .jkvproj folder, not only project.json.

Saving

• An * at the end of the title bar indicates unsaved changes.
• Projekt mentése (Save project) updates the active project.
• Mentés másként… (Save as) asks first for the parent folder and then for the project name.
• Before closing, creating a new project or opening another project, the application asks what to do with unsaved changes.
• The live preview does not save the project automatically. Export, however, automatically saves the current project state before it begins.

Importing a legacy JSON project

A legacy JSON file may reference external local image files, so import requires separate confirmation. The application imports valid images and may skip missing ones. Immediately after importing, select Mentés másként… (Save as) to create a self-contained, portable .jkvproj folder.

Backups

1. Save the project, then close the application.
2. Copy the complete .jkvproj folder to another physical drive or to your organisation’s approved backup location.
3. Periodically try opening the copy and check the images.
4. Keep a separate copy of the complete final export folder as well.

Do not work on the same project in two application instances. Save locking prevents several dangerous conflicts, but simultaneous editing from two computers in a shared network folder or synchronisation service may cause data loss.

1. Review the data

   Review all four tabs and the complete preview. Required fields are marked with an asterisk.

2. Start the export

   Click HTML + PDF export… at the bottom left, or press Ctrl+E.

3. Correct any reported errors

   Export does not start if an error is present. For warnings, the application lists the points to review and asks whether to continue.

4. Automatic project save

   If the project is new or has been modified, the application saves it before export. For a new project, it opens the Mentés másként… (Save as) dialog. If saving is cancelled or fails, no export is created.

5. Select an export root folder

   The application automatically creates a subdirectory inside it, based on the date and project name. If an export with the same name already exists, it asks for confirmation before safely replacing it.

6. Wait for the PDF to finish

   The progress indicator closes, then the Export kész (Export complete) message shows the exact location of the HTML file. Do not close the application during export.

Contents of the completed export

jegyzokonyv-<datum>-<megnevezes>/
├── jegyzokonyv-<datum>-<megnevezes>.html
├── report-data.json
├── location.geojson
├── asset-manifest.json
├── media/
│   ├── jegyzokonyv-<datum>-<megnevezes>.pdf
│   └── web-optimised WebP images
├── style/
└── additional local font and presentation resources

The version 3.0.5 export folder also contains separate report-data.json, location.geojson and asset-manifest.json files. The structured report data, GeoJSON point and asset inventory are also embedded in the HTML. For this reason, the complete folder must be kept together.

PDF limitation: the output contains searchable and selectable text, but it is not a PDF/A archival document and is not a tagged, fully accessible PDF.

Post-export checklist

• open the HTML in at least one modern browser;
• check the logo, every figure and every caption;
• click the PDF download link in the HTML;
• review every page of the PDF, especially page breaks and the final page;
• search for a word containing Hungarian accented characters in the PDF to verify that the text is searchable;
• only then deliver or upload the output.

Updating the installed Windows version

1. Save and close the open project.
2. Back up important .jkvproj folders.
3. Download and verify the new installer.
4. Start it. A new release that uses the same application folder updates the program files; user project data do not need to be copied into the installation folder.
5. After launching, check the version in Súgó → Névjegy (Help → About), then open a copy of an older project.

Updating a portable version

Always extract the new archive into a new, empty folder. Do not mix application files from two versions. Copy the complete required .jkvproj project folders from the old data/projects folder, or open them from their original location. Delete the old portable directory only after successful testing and backup.

Uninstalling the installed Windows version

Open Settings → Apps → Installed apps, find Jegyzőkönyv Generátor, then select Uninstall. Make a separate backup of your projects before uninstalling; do not rely on retained user-data folders as your only copy.

Removing a portable version

Close the application, copy any projects and exports that you want to keep from the data folder, then delete the complete extracted application directory.