.. role:: grey
.. role:: red
.. role:: green
.. role:: yellow
.. role:: orange
.. role:: blue

.. |start| image:: ../img/ui/iconic-play-circle.png
   :class: filter-invert
.. |download| image:: ../img/ui/iconic-data-transfer-download.png
   :class: filter-invert
.. |minimap| image:: ../img/ui/map-icon.png
   :class: filter-invert
.. |prefsicon| image:: ../img/ui/prefs-icon.png
   :class: filter-invert
.. |logicon| image:: ../img/ui/log-icon.png
   :class: filter-invert
.. |helpicon| image:: ../img/ui/help-icon.png
   :class: filter-invert
.. |quiticon| image:: ../img/ui/quit-icon.png
   :class: filter-invert
.. |time| image:: ../img/ui/iconic-clock.png
   :class: filter-invert
.. |camera| image:: ../img/ui/iconic-video.png
   :class: filter-invert
.. |log| image:: ../img/ui/iconic-map-marker.png
   :class: filter-invert
.. |bookmark| image:: ../img/ui/iconic-bookmark.png
   :class: filter-invert
.. |download-ds| image:: ../img/ui/iconic-arrow-circle-bottom.png
   :class: filter-invert
.. |terminal| image:: ../img/ui/iconic-terminal.png
   :class: filter-invert
.. |exit| image:: ../img/ui/quit-icon.png
   :class: filter-invert
.. |binicon| image:: ../img/ui/bin-icon.png
   :class: filter-invert

.. _qs-dataset-manager:

Dataset manager
---------------

The |download| :guilabel:`Dataset manager` is used to download, update, delete, and enable or disable datasets. It consists of two main tabs:

- :guilabel:`Available for download` — lists datasets available for installation from the remote servers.
- :guilabel:`Installed` — lists the datasets currently stored on your local machine.

Datasets are downloaded via an encrypted HTTPS connection, and SHA256 checksums are automatically used to verify file integrity.

The first time you launch Gaia Sky, you must download at least the :yellow:`Base data pack` (dataset key: ``default-data``). This is a **required** step. The base data pack contains essential components, including the primary Solar System (planets, moons, orbits, and asteroids), the Milky Way, grids, and constellations.

.. figure:: ../img/quickstart/202505_dataset-manager.jpg
    :alt: The dataset manager
    :align: center
    :target: _images/202505_dataset-manager.jpg

    The dataset manager showing the base data pack selection.

You can download any dataset from the :guilabel:`Available for download` tab by clicking the |download-ds| icon. 

The :guilabel:`Installed` tab displays your local library. From here, you can manage your data:

- **Enable/disable:** Use the **checkbox** in the dataset pane. Only enabled datasets are loaded when Gaia Sky starts.
- **Remove:** Right-click a dataset and select |binicon| :guilabel:`Remove` to delete it from your local storage.

.. figure:: ../img/welcome/catalog-selection.jpg
    :alt: The Installed tab in the dataset manager.
    :align: center
    :target: _images/catalog-selection.jpg

    Managing local datasets via the :guilabel:`Installed` tab.

Once you have finished your selection, close the dataset manager and click |start| :guilabel:`Start Gaia Sky`.