Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
STELLARIUM(1)							   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).

     --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 con-
	 fig 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 re-
	 fer to an object defined in the ssystem.ini file.

     --altitude alt
	 Specify the initial observer altitude, where alt is the altitude in me-
	 ters.

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

     --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 in-
     formation on how to customise the Stellarium data files.

     /usr/local/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 pro-
	 vided 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 Direc-
	 tory.

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

SEE ALSO
     celestia(1).

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.

BUGS
     Please report bugs using the bug tracker link in the NOTES section of this
     page.

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

     x14817

24.4.0				   2026-08-01			   STELLARIUM(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=stellarium&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help