Running Gaia Sky¶
If you installed the software using an installer or a package manager
deb), you just need to use the standard running
procedures of your Operating System to run the application.
In windows, this means clicking on
Start and then browsing the start
Gaia Sky. You can run the executable from there.
gaiasky in a terminal or use your favourite desktop
environment search engine to run the Gaia Sky launcher.
Locate the launcher using the main search.
Code and pakcage
However, if you are a maverick and do not like installers, you can also
run the Gaia Sky directly from the source code in
Running from source¶
If you want to compile the source code, you will need the following:
- JDK7 or above (JDK8 recommended)
Please, be aware that only
tags are guaranteed to work
branch holds the development version and the configuration files are
possibly messed up and not ready to work out-of-the-box. So remember to
tag version if you want to run it right away from source.
First, clone the repository:
$ git clone https://github.com/langurmonkey/gaiasky.git $ cd gaiasky
Compile and run¶
TGAS catalog files (Gaia data) are not in the repository, so if you want to use TGAS when running
from source you either need to choose
HYG in the Data tab of the configuration dialog or download
tar file corresponding to your version:
- TGAS data, single file (version 1.0.3 or older)
- TGAS data, single file (version 1.0.4)
- TGAS data, multifile (version 1.5.0)
You must extract the contents tarball into the folder
gaiasky/android/assets/data/octree. In the case of the multifile package, you need to keep the directory structure.
Please make sure to get the TGAS data files if you want to use them before running from source. To compile the code and run the desktop version of the application:
$ gradlew desktop:run
Package Gaia Sky¶
To pack the application into a
$ gradlew desktop:createTar
In order to produce the desktop installers for the various systems you
need a licensed version of
$ gradlew desktop:pack
These commands will compile and package the application into a
gaiasky-[version] folder under the
Running from downloaded package¶
If you prefer to run the application from the
tar.gz package, follow the instructions below.
In order to run the application on Linux, open the terminal, uncompress
the archive, give execution permissions to the
run.sh file and then
$ tar zxvf gaiasky-[version].tar.gz $ cd gaiasky-[version]/ $ gaiasky
In order to run the application on Windows, open a terminal window (type
cmd in the start menu search box) and run the
cd path_to_gaiasky_folder gaiasky.bat