SYNOPSIS

stellarium [OPTIONS]

DESCRIPTION

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.

--safe-mode

Do not use OpenGL2 features (such as shaders). Useful on systems that report support for OpenGL 2, but its implementation is buggy. Used as a work-around for the ``broken fonts'' bug.

-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).

-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).

--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.

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.

AUTHOR

Fabien Chereau, Rob Spearman, Johan Meuris, Matthew Gates, Johannes Gajdosik, Nigel Kerr, Andras Mohari, Bogdan Marinov, Timothy Reaves, Mike Storm, Diego Marcos, Guillaume Chereau, Alexander Wolf, Georg Zotti

x14817