stellarium1

Usage

Overview

Stellarium is a free GPL software which renders realistic skies in real time with OpenGL. It is available for Linux/Unix, Windows and MacOSX. With Stellarium, you really see what you can see with your eyes, binoculars or a small telescope.

Options

-v, --version

Print program name and version and exit.

-h, --help

Print a brief synopsis of program options and exit.

-c, --config-file file

Use file for the config filename instead of the default config.ini.

-u, --user-dir dir

Use dir instead of the default user data directory ($HOME/.stellarium/ on *nix operating systems).

--verbose

Even more diagnostic output in logfile (esp. multimedia handling).

--scale-gui scale factor

Scaling the GUI according to scale factor.

-d, --dump-opengl-details

Dump information about OpenGL support to logfile. Use this is you have graphics problems and want to send a bug report.

-f, --full-screen yes|no

With argument yes or no over-rides the full screen setting in the config file. The setting is saved in the config-file and as such will be the default for subsequent invocations of Stellarium.

--screenshot-dir dir

Set the directory into which screenshots will be saved to dir, instead of the default (which is $HOME on *nix operating systems).

--startup-script script

Specify name of startup script.

--home-planet planet-name

Specify observer planet. planet-name is an English name, and should refer to an object defined in the ssystem.ini file.

--altitude alt

Specify the initial observer altitude, where alt is the altitude in meters.

--longitude lon

Specify the initial observer longitude, where lon is the longitude. The format is illustrated by this example: +4d16'12" which refers to 4 degrees, 16 minutes and 12 arc seconds East. Westerly longitudes should be prefixed with "-".

--latitude lat

Specify the initial observer latitude, where lat is the latitude. The format is illustrated by this example: +53d58'16.65" which refers to 53 degrees, 58 minutes and 16.65 arc seconds North. Southerly latitudes should be prefixed with "-".

--list-landscapes

Print a list of landscape names and exit.

--landscape name

Start Stellarium using landscape name. Refer to --list-landscapes for possible names.

--sky-date date

Specify sky date in format yyyymmdd.

--sky-time time

Specify sky time in format hh:mm:ss.

--fov fov

Specify the field of view (fov degrees).

--projection-type p

Specify projection type, p. Permitted values of p are: equalarea, stereographic, fisheye, cylinder, mercator, perspective, and orthographic.

--restore-defaults

Delete existing config.ini and use defaults.

Return value

0

Completed successfully.

not 0

Some sort of error.

Files

Note: file locations on non-*nix operating systems (include OSX) may vary. Please refer to the Stellarium User Guide for more details, as well as information on how to customise the Stellarium data files.

/usr/share/stellarium/

This is the Installation Data Directory set at compile-time.

$HOME/.stellarium/

This is the User Data Directory, which may be over-ridden using command line option -u. It contains the user's settings, extra landscapes, scripts, and can also be used to over-ride data files which are provided with the default install.

$HOME/.stellarium/config.ini

The default main configuration file is config.ini. Refer to -c above to use a different filename and to -u to use a different User Data Directory.

$HOME/

The default screenshot directory. Refer to --screenshot-dir to use a different path.

Notes

Sources of more information:

Websites

Main website: <http://stellarium.org/>

Wiki: <http://stellarium.org/wiki/>

Forums: <http://sourceforge.net/projects/stellarium/forums>

Downloads: <http://sourceforge.net/projects/stellarium/files/>

Support Requests: <https://answers.launchpad.net/stellarium>

Bug Tracker: <https://bugs.launchpad.net/stellarium>

The Stellarium User Guide

Visit the downloads page to get a PDF copy of the Stellarium User Guide.