stellarium(1)

1STELLARIUM(1)                                                    STELLARIUM(1)
2
3
4

NAME

6       stellarium - A real-time realistic planetarium
7

SYNOPSIS

9       stellarium [OPTIONS]
10

DESCRIPTION

12       Stellarium is a free GPL software which renders realistic skies in real
13       time with OpenGL. It is available for Linux/Unix, Windows and MacOSX.
14       With Stellarium, you really see what you can see with your eyes,
15       binoculars or a small telescope.
16

OPTIONS

18       -v, --version
19           Print program name and version and exit.
20
21       -h, --help
22           Print a brief synopsis of program options and exit.
23
24       -c, --config-file file
25           Use file for the config filename instead of the default config.ini.
26
27       -u, --user-dir dir
28           Use dir instead of the default user data directory
29           ($HOME/.stellarium/ on *nix operating systems).
30
31       --verbose
32           Even more diagnostic output in logfile (esp. multimedia handling).
33
34       -t, --fix-text
35           May fix text rendering problems.
36
37       --scale-gui scale factor
38           Scaling the GUI according to scale factor.
39
40       -d, --dump-opengl-details
41           Dump information about OpenGL support to logfile. Use this is you
42           have graphics problems and want to send a bug report.
43
44       -f, --full-screen yes|no
45           With argument yes or no over-rides the full screen setting in the
46           config file.  The setting is saved in the config-file and as such
47           will be the default for subsequent invocations of Stellarium.
48
49       --screenshot-dir dir
50           Set the directory into which screenshots will be saved to dir,
51           instead of the default (which is $HOME on *nix operating systems).
52
53       --startup-script script
54           Specify name of startup script.
55
56       --home-planet planet-name
57           Specify observer planet. planet-name is an English name, and should
58           refer to an object defined in the ssystem.ini file.
59
60       --altitude alt
61           Specify the initial observer altitude, where alt is the altitude in
62           meters.
63
64       --longitude lon
65           Specify the initial observer longitude, where lon is the longitude.
66           The format is illustrated by this example: +4d16'12" which refers
67           to 4 degrees, 16 minutes and 12 arc seconds East.  Westerly
68           longitudes should be prefixed with "-".
69
70       --latitude lat
71           Specify the initial observer latitude, where lat is the latitude.
72           The format is illustrated by this example: +53d58'16.65" which
73           refers to 53 degrees, 58 minutes and 16.65 arc seconds North.
74           Southerly latitudes should be prefixed with "-".
75
76       --list-landscapes
77           Print a list of landscape names and exit.
78
79       --landscape name
80           Start Stellarium using landscape name.  Refer to --list-landscapes
81           for possible names.
82
83       --sky-date date
84           Specify sky date in format yyyymmdd.
85
86       --sky-time time
87           Specify sky time in format hh:mm:ss.
88
89       --fov fov
90           Specify the field of view (fov degrees).
91
92       --projection-type p
93           Specify projection type, p.  Permitted values of p are: equalarea,
94           stereographic, fisheye, cylinder, mercator, perspective, and
95           orthographic.
96
97       --restore-defaults
98           Delete existing config.ini and use defaults.
99

RETURN VALUE

101       0   Completed successfully.
102
103       not 0
104           Some sort of error.
105

FILES

107       Note: file locations on non-*nix operating systems (include OSX) may
108       vary.  Please refer to the Stellarium User Guide for more details, as
109       well as information on how to customise the Stellarium data files.
110
111       /usr/share/stellarium/
112           This is the Installation Data Directory set at compile-time.
113
114       $HOME/.stellarium/
115           This is the User Data Directory, which may be over-ridden using
116           command line option -u.  It contains the user's settings, extra
117           landscapes, scripts, and can also be used to over-ride data files
118           which are provided with the default install.
119
120       $HOME/.stellarium/config.ini
121           The default main configuration file is config.ini. Refer to -c
122           above to use a different filename and to -u to use a different User
123           Data Directory.
124
125       $HOME/
126           The default screenshot directory. Refer to --screenshot-dir to use
127           a different path.
128

NOTES

133       Sources of more information:
134
135       Websites
136           Main website: <http://stellarium.org/>
137
138           Wiki: <http://stellarium.org/wiki/>
139
140           Forums: <http://sourceforge.net/projects/stellarium/forums>
141
142           Downloads: <http://sourceforge.net/projects/stellarium/files/>
143
144           Support Requests: <https://answers.launchpad.net/stellarium>
145
146           Bug Tracker: <https://bugs.launchpad.net/stellarium>
147
148       The Stellarium User Guide
149           Visit the downloads page to get a PDF copy of the Stellarium User
150           Guide.
151

BUGS

153       Please report bugs using the bug tracker link in the NOTES section of
154       this page.
155

AUTHOR

157       Fabien Chereau, Rob Spearman, Johan Meuris, Matthew Gates, Johannes
158       Gajdosik, Nigel Kerr, Andras Mohari, Bogdan Marinov, Timothy Reaves,
159       Mike Storm, Diego Marcos, Guillaume Chereau, Alexander Wolf, Georg
160       Zotti
161
162       x14817
163
164
165
1660.21.2                            2021-09-27                     STELLARIUM(1)