.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "STELLARIUM 1"
.TH STELLARIUM 1 "2022-07-16" "0.22.2" "\ "
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
stellarium \- A real\-time realistic planetarium
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
stellarium [\fB\s-1OPTIONS\s0\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Stellarium is a free \s-1GPL\s0 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.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-v, \-\-version\fR" 4
.IX Item "-v, --version"
Print program name and version and exit.
.IP "\fB\-h, \-\-help\fR" 4
.IX Item "-h, --help"
Print a brief synopsis of program options and exit.
.IP "\fB\-c, \-\-config\-file\fR \fIfile\fR" 4
.IX Item "-c, --config-file file"
Use \fIfile\fR for the config filename instead of the default \fIconfig.ini\fR.
.IP "\fB\-u, \-\-user\-dir\fR \fIdir\fR" 4
.IX Item "-u, --user-dir dir"
Use \fIdir\fR instead of the default user data directory (\fI\f(CI$HOME\fI/.stellarium/\fR
on *nix operating systems).
.IP "\fB\-\-verbose\fR" 4
.IX Item "--verbose"
Even more diagnostic output in logfile (esp. multimedia handling).
.IP "\fB\-t, \-\-fix\-text\fR" 4
.IX Item "-t, --fix-text"
May fix text rendering problems.
.IP "\fB\-\-scale\-gui\fR \fIscale factor\fR" 4
.IX Item "--scale-gui scale factor"
Scaling the \s-1GUI\s0 according to scale factor.
.IP "\fB\-d, \-\-dump\-opengl\-details\fR" 4
.IX Item "-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.
.IP "\fB\-f, \-\-full\-screen\fR \fIyes|no\fR" 4
.IX Item "-f, --full-screen yes|no"
With argument \fIyes\fR or \fIno\fR 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.
.IP "\fB\-\-screenshot\-dir\fR \fIdir\fR" 4
.IX Item "--screenshot-dir dir"
Set the directory into which screenshots will be saved to \fIdir\fR, 
instead of the default (which is \f(CW$HOME\fR on *nix operating systems).
.IP "\fB\-\-startup\-script\fR \fIscript\fR" 4
.IX Item "--startup-script script"
Specify name of startup script.
.IP "\fB\-\-home\-planet\fR \fIplanet-name\fR" 4
.IX Item "--home-planet planet-name"
Specify observer planet. \fIplanet-name\fR is an English name, and should 
refer to an object defined in the \fIssystem.ini\fR file.
.IP "\fB\-\-altitude\fR \fIalt\fR" 4
.IX Item "--altitude alt"
Specify the initial observer altitude, where \fIalt\fR is the altitude in 
meters.
.IP "\fB\-\-longitude\fR \fIlon\fR" 4
.IX Item "--longitude lon"
Specify the initial observer longitude, where \fIlon\fR 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 \f(CW\*(C`\-\*(C'\fR.
.IP "\fB\-\-latitude\fR \fIlat\fR" 4
.IX Item "--latitude lat"
Specify the initial observer latitude, where \fIlat\fR 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 \f(CW\*(C`\-\*(C'\fR.
.IP "\fB\-\-list\-landscapes\fR" 4
.IX Item "--list-landscapes"
Print a list of landscape names and exit.
.IP "\fB\-\-landscape\fR \fIname\fR" 4
.IX Item "--landscape name"
Start Stellarium using landscape \fIname\fR.
Refer to \fB\-\-list\-landscapes\fR for possible names.
.IP "\fB\-\-sky\-date\fR \fIdate\fR" 4
.IX Item "--sky-date date"
Specify sky date in format yyyymmdd.
.IP "\fB\-\-sky\-time\fR \fItime\fR" 4
.IX Item "--sky-time time"
Specify sky time in format hh:mm:ss.
.IP "\fB\-\-fov\fR \fIfov\fR" 4
.IX Item "--fov fov"
Specify the field of view (\fIfov\fR degrees).
.IP "\fB\-\-projection\-type\fR \fIp\fR" 4
.IX Item "--projection-type p"
Specify projection type, \fIp\fR.  Permitted values of \fIp\fR are: equalarea, 
stereographic, fisheye, cylinder, mercator, perspective, and orthographic.
.IP "\fB\-\-restore\-defaults\fR" 4
.IX Item "--restore-defaults"
Delete existing config.ini and use defaults.
.SH "RETURN VALUE"
.IX Header "RETURN VALUE"
.IP "0" 4
Completed successfully.
.IP "not 0" 4
.IX Item "not 0"
Some sort of error.
.SH "FILES"
.IX Header "FILES"
Note: file locations on non\-*nix operating systems (include \s-1OSX\s0) may vary.  
Please refer to the Stellarium User Guide for more details, as well
as information on how to customise the Stellarium data files.
.IP "\fI/usr/share/stellarium/\fR" 4
.IX Item "/usr/share/stellarium/"
This is the Installation Data Directory set at compile-time.
.IP "\fI\f(CI$HOME\fI/.stellarium/\fR" 4
.IX Item "$HOME/.stellarium/"
This is the User Data Directory, which may be over-ridden using command line 
option \fB\-u\fR.  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.
.IP "\fI\f(CI$HOME\fI/.stellarium/config.ini\fR" 4
.IX Item "$HOME/.stellarium/config.ini"
The default main configuration file is \fIconfig.ini\fR. Refer to \fB\-c\fR above to
use a different filename and to \fB\-u\fR to use a different User Data Directory.
.IP "\fI\f(CI$HOME\fI/\fR" 4
.IX Item "$HOME/"
The default screenshot directory. Refer to \fB\-\-screenshot\-dir\fR to use a
different path.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBcelestia\fR\|(1).
.SH "NOTES"
.IX Header "NOTES"
Sources of more information:
.IP "Websites" 4
.IX Item "Websites"
Main website: <http://stellarium.org/>
.Sp
Wiki: <http://stellarium.org/wiki/>
.Sp
Forums: <http://sourceforge.net/projects/stellarium/forums>
.Sp
Downloads: <http://sourceforge.net/projects/stellarium/files/>
.Sp
Support Requests: <https://answers.launchpad.net/stellarium>
.Sp
Bug Tracker: <https://bugs.launchpad.net/stellarium>
.IP "The Stellarium User Guide" 4
.IX Item "The Stellarium User Guide"
Visit the downloads page to get a \s-1PDF\s0 copy of the Stellarium User Guide.
.SH "BUGS"
.IX Header "BUGS"
Please report bugs using the bug tracker link in the \s-1NOTES\s0 section 
of this page.
.SH "AUTHOR"
.IX Header "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
.PP
x14817