Sharing debug information - ItsSim/fsolauncher GitHub Wiki

If you've identified an issue with the launcher, the easiest way to provide debug information for it to be investigated is to enable the launcher's logging mode.

Running the launcher in this mode will generate a log file containing each action performed within the app.

To run the launcher in file logging mode, run the following command in a new Terminal window (macOS) or command prompt (Windows). If you're not familiar with opening Terminal or console windows: Opening a Terminal window on macOS or Launch command prompt on Windows

Start launcher in logging mode

macOS

Warning

You might need to run the launcher once so that the "unidentified developer" notice goes away. After running it once, close the launcher, then type and execute the command below in a Terminal window.

Execute this command: '/Applications/FreeSO Launcher.app/Contents/MacOS/FreeSO Launcher' --fl-filelog

Windows

Execute this command: "C:\Program Files (x86)\FreeSO Launcher\fsolauncher.exe" --fl-filelog

Obtaining the log file

After executing the command specified above, the log file will begin saving useful debug information.

Perform the actions you need to debug, and then close the launcher.

Retrieve the log file (file ending in .log) from the following directory:

Windows: C:\Program Files (x86)\FreeSO Launcher\logs
macOS: ~/Library/Application Support/FreeSO Launcher/logs

The directory should contain a file named session-<number>.log.

Share this file for review. The file may contain system usernames, so make sure you remove them before sharing if you wish.