stellarium - A real-time realistic planetarium
Contents
Bugs
Please report bugs using the bug tracker link in the NOTES section of this page.
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.
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.
Name
stellarium - A real-time realistic planetarium
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.
Options
-v,--version
Print program name and version and exit.
-h,--help
Print a brief synopsis of program options and exit.
-c,--config-filefile
Use file for the config filename instead of the default config.ini.
-u,--user-dirdir
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-guiscalefactor
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-screenyes|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-dirdir
Set the directory into which screenshots will be saved to dir, instead of the default (which is $HOME
on *nix operating systems).
--startup-scriptscript
Specify name of startup script.
--home-planetplanet-name
Specify observer planet. planet-name is an English name, and should refer to an object defined in the
ssystem.ini file.
--altitudealt
Specify the initial observer altitude, where alt is the altitude in meters.
--longitudelon
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 "-".
--latitudelat
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.
--landscapename
Start Stellarium using landscape name. Refer to --list-landscapes for possible names.
--sky-datedate
Specify sky date in format yyyymmdd.
--sky-timetime
Specify sky time in format hh:mm:ss.
--fovfov
Specify the field of view (fov degrees).
--projection-typep
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.
See Also
celestia(1).
Synopsis
stellarium [OPTIONS]
