Skip to content

Troubleshooting

Kristian Lytje edited this page Jul 23, 2025 · 4 revisions

Getting the programs to run on some platforms can be somewhat tricky. Please refer to the following if you encounter any issues.

Note

Can't find your issue? Please create a discussion thread with more information so we can help get it solved.

Windows

Why do I get SmartScreen warnings? The Microsoft SmartScreen filter may warn you about potential security risks when running AUSAXS for the first time. You should be able to ignore this warning by clicking "More information", where you will be able to override the warning. Removing this notice from our end requires a yearly fee to sign our program, which we are currently unable to support.

Warning! You should only ignore SmartScreen warnings for software you trust! AUSAXS is completely open source, so if you have any security concerns, you are free to check the code.

Why is a black box (terminal) opening when I run the program? When using the graphical interface, a new process must be launched to run either the Python or precompiled plotting scripts. Currently, a new terminal is therefore opened to run these commands.

If you have experience coding for Windows, please consider contributing a better way to execute commands.

MacOS

Why does it immediately crash upon opening the program?

The GUI binaries are compiled against specific MacOS versions, which are usually not backwards compatible. We strive to compile against the oldest MacOS versions available for both CPU architectures on GitHub.

Should you encounter any issues with the architecture-specific programs, we recommend using the universal binaries, which are compiled without GUI support and should therefore be compatible with significantly older versions of MacOS. In case these also do not work, you can try to compile the software yourself as described here.

Linux

Usually there are no issues on this platform. Perhaps you simply lack the permissions to execute the program? Try marking them as executable: chmod +x <program>

Clone this wiki locally