Quick start guide

Tip

This guide is designed for the latest version of Gaia Sky. Ensure your software is up to date to follow along seamlessly!

The main objective of this guide is to provide a concise “on-ramp” to the Gaia Sky platform, covering its core operations and most common features.

Gaia Sky crash course: For a visual introduction, check out the companion web presentation.

Guide overview:

• Introduction to Gaia Sky:

  • Dataset manager.

  • Controls, movement, and selection.

  • User interface overview.

  • Camera operation and modes.

  • Render modes (3D, Planetarium, 360, Re-projection).

  • Object and type visibility.

  • Visual settings.

  • Managing datasets (loading, filters, and SAMP).

• Scripting:

  • Scripting basics.

  • The API.

  • Showcase scripts.

  • Hands-on session.

• Camera paths:

  • Recording and playback.

  • Keyframe system.

• Output and video:

  • Still frame output mode.

  • Creating video from still frames with ffmpeg.

Before starting…

To follow this guide effectively, you should have Gaia Sky installed locally. If you haven’t installed it yet, please follow the instructions for your operating system in the installation section.

The welcome window

When you launch Gaia Sky for the first time, you are greeted by the onboarding screen:

The onboarding screen offers a choice between a quick-start recommended setup or a fully customized experience.

From this window, you can access global Preferences (), the Help window (), or Exit the program () using the icons in the bottom-right corner.

There are two primary ways to begin:

• Start with recommended datasets — Automatically downloads a curated selection of essential datasets and launches Gaia Sky immediately.

• Customize datasets — Opens the dataset manager, allowing you to manually pick and choose which data to download and enable.

If you choose the recommended option, a progress window will appear. Once the download is complete, Gaia Sky will launch automatically.

If you choose to customize your setup, you will see the following view:

The welcome screen displayed when no local datasets are detected.

From here, you can return to the previous screen by clicking Back, or click Dataset manager to begin your manual selection. This process is covered in detail in the next section.