Celestia/Command Line

Introduction

Celestia can be started either by clicking on its icon or by typing a command into a terminal window. Under Windows, the terminal window is often called a DOS window or CMD window.

A typical command to run Celestia might be

cd Celestia
./Celestia

The command line can optionally include the following qualifiers. These qualifiers are different depending on which command interface Celestia was built for. Each command qualifier (aka switch) should be prefixed by two hyphens

Windows command qualifiers

• --dir <path>

Change root celestia directory to <path>

• --fullscreen

Start Celestia in fullscreen mode

• --once

Send the command line to a running instance of Celestia. If no running instance exists, a new one is started.

• --url <url>|<filename>

Start in the given <url> or if the parameter is the name of a script file, execute <filename>.

• --verbose >    <filename>

Write debug messages to <filename> (Although --verbose can only write to a file, the redirection > is required.)

gtk command qualifiers

• --conf

Use alternate configuration file

• --dir

Use alternate installation directory

• --extrasdir

Use additional "extras" directory

• --fullscreen

Start full-screen

• --nosplash

Disable splash screen

• - v [0|1]

Enable debug mode.

KDE command qualifiers

• --conf

Use alternate configuration file

• --dir

Use alternate installation directory

• --extrasdir

Use additional "extras" directory

• --fullscreen

Start full-screen

• --nosplash

Disable splash screen

• +[url]

Start and goto URL

• <url>

Start in the given url/execute script file.

• - - help

Command-line help