Known limitations¶

The following limitations have been noticed when using OpenCOR on our supported platforms.

Windows, Linux and macOS¶

By default, OpenCOR uses the system’s language for menus, message boxes, etc., as long as it is either English or French (please contact us if you would like OpenCOR to support other languages). If the system uses another language, OpenCOR will default to English. Otherwise, if you specify English or French then please be aware that system messages, diaogs, etc. will still be displayed using the system’s language.
OpenCOR uses the CellML API, which is known to have the following limitations:
- It leaks memory, although it should not be a “problem” in most cases.
- It may incorrectly (in)validate certain CellML files.
OpenCOR comes with Python support, which requires OpenCOR to be installed in a directory that does not contain spaces.

A scaled display will, on Linux, result in some aspects of OpenCOR being rendered at the wrong size (e.g., icons will be smaller and scroll bars bigger). On Windows, OpenCOR should scale itself automatically, although it will look more or less blurry depending on your display scaling and screen resolution. In case OpenCOR does not scale itself, turn off Fix scaling for apps:

or better, locate your copy of OpenCOR, right click on [OpenCOR]\bin\OpenCOR.exe, click on the Properties menu item, and have the high DPI scaling performed by the system:

The File Browser window plugin may, on some systems, result in OpenCOR being slow to respond at startup. This has nothing to do with OpenCOR, but most likely with a Windows shell add-on.
If OpenCOR was installed in a system folder using the ZIP file then the first time OpenCOR is run it will have to be run as administrator. This is so that OpenCOR can update the shebang of its Python scripts to point to its copy of Python.

OpenCOR is supported on Ubuntu 20.04 LTS (Focal Fossa) and later. However, OpenCOR’s Python requires a specific version of libffi which may or may not be present on a later version of Ubuntu. For this reason, OpenCOR comes with its own copy of libffi, but this means that OpenCOR’s scripts must set LD_LIBRARY_PATH, so that OpenCOR’s Python can find libffi. This means that, on some later versions of Ubuntu, to run [OpenCOR]/bin/OpenCOR directly will result in the Python Console window plugin not to work (since LD_LIBRARY_PATH is not set, which means that our copy of libffi cannot be found).

Starting with macOS Mojave, macOS has a Dark Mode, which is not currently supported by OpenCOR.