stellarium - A real-time realistic planetarium
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.
- -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).
- -t, --fix-text
- May fix text rendering problems.
- --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.
- 0
- Completed successfully.
- not 0
- Some sort of error.
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.
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.
Please report bugs using the bug tracker link in the NOTES section
of this page.
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