Installing OpenSpace

This guide has information about installing the downloadable application from the OpenSpace website.

Note

If you wish to download the source code and build the application, please see Compiling.

Hardware Requirements

OpenSpace is designed for use on a wide array of devices ranging from laptops to state-of-the-art planetarium domes. However, its ability to create complex scenes demands graphics power to run efficiently.

Minimum Requirements

  • i5 processor (Apple’s M-chip is not supported)

  • NVIDIA 1060 GTX GPU (or comparable) (AMD cards work with some issues)

  • 8 GB RAM

  • 4 GB VRAM

  • 25 Mbps internet connection is recommended (the default profile requires an internet connection)

Optimal Specs

  • Windows 10 or above

  • 16 GB RAM (or more)

  • 6 GB VRAM (or more)

Installation

To install OpenSpace, follow these steps:

  1. Download OpenSpace according to the instructions on the OpenSpace website for your operating system.

  2. Unzip or extract the resulting file.

  3. Place the resulting unzipped folder anywhere you like. OpenSpace is self-contained. We recommend a location inside your user folder or home directory.

Tip

Multiple versions of OpenSpace may be installed beside one another without conflict.

  1. Continue below for your particular operating system:

Windows Installation Video

Visual Transcript

Video time

Description

0:00

Download the zip file from the OpenSpace website.

0:30

Get the zip file from your downloads and extract the OpenSpace folder.

0:50

Find the .exe inside the extracted folder and create a desktop shortcut.

1:04

Running the application for the first time, you will get a Windows protection pop-up. Click “More info” then “Run Anyway.”

1:13

When the Launcher opens, start OpenSpace with the start button.

1:15

You will be presented with more Windows protection pop-us, this time for the firewall. Click “Allow access” on each.

1:35

OpenSpace is started and you can use the application.

Error: “VCRUNTIME140_1.dll was not found

If you receive this error, you will need to download and install Microsoft Visual C++ Redistributable for Visual Studio 2022.

Network Access Pop-ups

Upon running OpenSpace for the first time, it will ask for permission to access the internet via two pop-up windows. If you do not give OpenSpace that permission, some important features, such as the user interface, will be inaccessible.

Slow Performance—Low Frame Rate Issue

If your frame rate is low (the FPS number in the top left corner), please ensure that OpenSpace is using your dedicated graphics card. If the frame rate is debilitatingly slow, OpenSpace is probably using your system’s integrated graphics card.

You can set which graphics OpenSpace uses via the following procedure:

Windows 11

In Windows 11, these setting are found in Window’s Settings App under System ‣ Display ‣ Graphics.

Windows graphics settings

  1. Under Add an app, browse to choose the OpenSpace.exe file in the OpenSpace/bin/ folder in your main OpenSpace folder.

  2. Click on the resulting OpenSpace entry in the list of apps, and click the Options button.

Windows graphics settings options

  1. Choose High performance and save.

Windows 10

In Windows 10, assuming you have an NVIDIA card, you must use the NVIDIA Control Panel to set which application explicitly uses the NVIDIA card. Access the NVIDIA Control Panel through these steps:

  1. Right click on the desktop to bring up the contextual menu.

Windows context menu

Windows Desktop contextural menu.

  1. Select NVIDIA Control Panel.

NVIDIA control panel

NVIDIA Control Panel.

  1. Select Manage 3D settings from the left navigation menu.

  2. Search for the dropdown menu called Preferred graphics processor.

  3. These settings should indicate Integrated graphics. Double-click that setting to choose High-Performance NVIDIA processor.

  4. Relaunch OpenSpace.

Linux Installation

Binary versions - AppImage and deb files for Ubuntu - exist on the volunteer-run Github repo OpenSpace-AppImage.

All other Linux platforms will require you to build the application. Please see Compiling.

Uninstalling OpenSpace

Because OpenSpace is self-contained, all the files it needs to run are in the OpenSpace folder where you installed it. Uninstalling is as easy as deleting the OpenSpace folder.

Getting Help

If you encounter any errors with installing OpenSpace, please reach out to us on Slack.

Or, for the code-savvy, create an issue on OpenSpace’s GitHub.