Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel63
outlinefalse
stylenone
typelist
printabletrue

24.4.1

License Key Activation Failure

If you are activating a license for the first time on a machine you may see the following error even if your license is valid.

...

To confirm that this error is invalid, check the most recent log file in

%LOCALAPPDATA%/M-XR/Maestro/Logging/Job_Manager_GUI/

If you see line similar to the below then your license may in fact be valid, and you should try following workaround.

Code Block
[ERROR  ] not enough values to unpack (expected 3, got 2)

Workaround

  1. Close Marso if you still have it open.

  2. In a text editor open %LOCALAPPDATA%/M-XR/Maestro/config.json

  3. Insert your license key in quotation marks like so:

    image-20240926-173138.pngImage Removed
  4. Restart Marso

You should find that your license key is already populated in the settings dialog, and activating now works correctly if your license is in fact valid.

24.4.0

Update Failure

The Updater shipped with Marso in versions up until 24.4.1 has been disabled as of the 20th of September 2024 due to an access key rotation. If you are unable to update from a version before 24.4.1 to a version after 24.4.1 you may need to re-download the Updater executable (M-XR_Marso_Update.exe) from here and replace the update executable in your install directory.

You should then be able to launch Marso and have it update correctly.

24.3.2

Normals Texture Files

The colour space on the Normals for PNG and JPEG outputs is not correct. Normally the should be in raw/linear and not need an input transformation, there is an issue with the file authoring that is encoding them as sRGB. To resolve, adjust the input transformation in your program of choice to treat them as sRGB.

Light System Menu Crash

...

When the menu is in this state, i.e. you have any number of rows in the New Light System frame, if you click on a row in this frame then the program will crash. Any data currently entered for a light system you are creating will be lost. No saved light system data will be impacted. If you are running a job and this crash occurs Marso will attempt to recover at next startup but progress for that job may be lost.

...

Current

GUI not displaying error

In a small set of circumstances with the prepare step when it errors the GUI is unable to report the error back to the user as it would normally. It will just show the job in the FAILED PREP state. To get around this look into %LOCALAPPDATA%/M-XR\Maestro\Logging\Job_Manager_GUI for the error details.

Spaces in paths

Currently having spaces in paths is not supported. So most steps will fail if a path includes a space. This covers calibration and processing. As a solution for the time being it is recommended to move the data to a location where there are no spaces in the path.

Run out of storage

If the program is running and the drive that the sctrach directory is set to use fills up (due to Marso or other programs) then windows will throw a Storage Warning, the job in Marso will fail.

...

To resolve you must clear space on the drive, usually we aim for 1TB of free space. Then the program can be relaunched and job can be restarted safely.

Windows defender false positive

Windows defender has an AI based threat detection system that on some systems detects a portion of Marso as a threat. The threat should look like Trojan:Script/Wacatac.B!ml

...

If you are unable to add an exception due to security policy then we don’t currently have a solution.

Firewall blocked

If you have your firewall blocked and set not allow any connections then Marso will crash and will not provide a clear error. Marso requires external internet connection to run inorder to conenct to our DRM system.

...

Code Block
https://api.keygen.sh/* - HTTP/HTTPS (80/443) - License validation
*.mongodb.net - TCP ports 27015-27017 - Database
*.backblazeb2.com - HTTP/HTTPS (80/443) - Binary hosting

VPN support

Currently based on our testing, Marso does not work with VPNs. They can tried at the user’s own risk but we do not expect them to work.

Historic

License Key Activation Failure

Fixed: 24.4.2

If you are activating a license for the first time on a machine you may see the following error even if your license is valid.

...

To confirm that this error is invalid, check the most recent log file in

%LOCALAPPDATA%/M-XR/Maestro/Logging/Job_Manager_GUI/

If you see line similar to the below then your license may in fact be valid, and you should try following workaround.

Code Block
[ERROR  ] not enough values to unpack (expected 3, got 2)

Workaround

  1. Close Marso if you still have it open.

  2. In a text editor open %LOCALAPPDATA%/M-XR/Maestro/config.json

  3. Insert your license key in quotation marks like so:

    image-20240926-173138.pngImage Added
  4. Restart Marso

You should find that your license key is already populated in the settings dialog, and activating now works correctly if your license is in fact valid.

Update Failure

Fixed: 24.4.1

The Updater shipped with Marso in versions up until 24.4.1 has been disabled as of the 20th of September 2024 due to an access key rotation. If you are unable to update from a version before 24.4.1 to a version after 24.4.1 you may need to re-download the Updater executable (M-XR_Marso_Update.exe) from here and replace the update executable in your install directory.

You should then be able to launch Marso and have it update correctly.

Normals Texture Files

Fixed 24.4.0

The colour space on the Normals for PNG and JPEG outputs is not correct. Normally the should be in raw/linear and not need an input transformation, there is an issue with the file authoring that is encoding them as sRGB. To resolve, adjust the input transformation in your program of choice to treat them as sRGB.

Light System Menu Crash

Fixed 24.4.0

...

When the menu is in this state, i.e. you have any number of rows in the New Light System frame, if you click on a row in this frame then the program will crash. Any data currently entered for a light system you are creating will be lost. No saved light system data will be impacted. If you are running a job and this crash occurs Marso will attempt to recover at next startup but progress for that job may be lost.