STELLARIUM(1)
NAME
stellarium - A real-time realistic planetarium
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.
- -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.
/ 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.
SEE ALSO
NOTES
Sources of more information:
- Websites
- Main website: <http://stellarium.org/>
- Wiki: <http://stellarium.org/wiki/>
- Forums: <http://sourceforge.net/forum/forum.php?forum_id=278769>
- Downloads:
<https://sourceforge.net/project/showfiles.php?group_id=48857> - Support Requests:
- Bug Tracker:
- The Stellarium User Guide
- Visit the downloads page to get a PDF copy of the Stellarium User
Guide.
BUGS
Please report bugs using the bug tracker link in the NOTES section of
this page.
AUTHOR
Fabien ChA~Xreau, Rob Spearman, Johan Meuris, Matthew Gates, Johannes
Gajdosik, Nigel Kerr, Andras Mohari.
- x14817