Skip to content

Requirements

Jacob Alzén edited this page Apr 22, 2024 · 4 revisions

Rymdport compiles into a statically linked binary with no explicit runtime dependencies. Compiling requires a Go compiler (version 1.19 or later is required) and the prerequisites for Fyne. See the Compiling wiki page for more notes about compilation.

Graphics driver

Rymdport requires a driver that supports OpenGL 2.1 or later. If your driver supports OpenGL ES 2.0 or later, you can build with the gles build tag. See https://github.com/Jacalz/rymdport/wiki/Compiling#build-tags for more information.

OpenGL 2.1 was released in 2006 and most hardware does support this without any issues.

Windows-specific issues

If you get an error like this and Rymdport fails to open, you are running in to driver problems on Windows. The subsections below explain why this happens and how it can be avoided in many cases.

windows-graphics-error

Old Intel CPU with integrated graphics

The generic (and software rendering) graphics drivers on Windows are not very good and do not support OpenGL 2.1 for some reason. Make sure that you have the latest graphics driver installed.

Some graphics chipsets in old Intel processors experience problems with this due to a combination of bad hardware and drivers. One problem is that some hardware doesn't support a new enough version even though the chip was released after 2006. Another problem is that the latest driver that Intel provides doesn't support OpenGL 2.1 even though the hardware does. In these cases, installing the latest driver does little to help the situation (Linux drivers usually does supports all of what the hardware supports though).

If you have installed the latest driver but the issue persists, then the solution is to put the Mesa3D DLL next to the Rymdport binary to make it load a more mature software renderer.

Virtual machines

Another issue that comes up on Windows quite often is that many virtual machines have graphics acceleration turned off by default and only use software rendering. As noted above, the software rendering driver on Windows does not support OpenGL 2.1 and the application fails to launch because of this. The solution is usually to enable 3D acceleration in the virtual machine settings. As explained above, you can also put the Mesa3D DLL next to the Rymdport binary to make it load a more mature software renderer.

Operating Systems

The operating systems listed below are supported. Specific versions that are supported vary depending on which Go version is used to compile Rymdport. The oldes supported compiler version is currently Go 1.19.

  • Linux
  • macOS
  • Windows
  • FreeBSD
  • NetBSD
  • OpenBSD