---
name: "kstars"
section: "1"
platform: "linux"
package: "kstars"
version: "5:3.0.0-1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/kstars"
---

# kstars(1)

KDE Desktop Planetarium

## NAME

kstars - KDE Desktop Planetarium

## SYNOPSIS

**kstars** *\[Qt-options\] \[KDE-options\] \[options\]*

## DESCRIPTION

**KStars** is a desktop planetarium for KDE, depicting an accurate graphical simulation of the night sky, from any location on Earth, at any date and time. The display includes 130,000 stars, 13,000 deep-sky objects, all 8 planets, the Sun and Moon, and thousands of comets and asteroids.  It includes tools for astronomical calculations and can control telescopes and cameras.

## OPTIONS

- **--dump**

  Dump sky image to file.

- **--script**

  Script to execute.

- **--width**

  Width of sky image \[640\].

- **--height**

  Height of sky image \[480\].

- **--filename**

  Filename for sky image \[kstars.png\].

- **--date**

  Date and time.

- **--paused**

  Start with clock paused.

## GENERIC OPTIONS

- **--help**

  Show help about options.

- **--help-qt**

  Show Qt specific options.

- **--help-kde**

  Show KDE specific options.

- **--help-all**

  Show all options.

- **--author**

  Show author information.

- **-v, --version**

  Show version information.

- **--license**

  Show license information.

- **--**

  End of options.

## QT OPTIONS

- **--display *\<displayname\>***

  Use the X-server display \`displayname'.

- **--session *\<sessionId\>***

  Restore the application for the given \`sessionId'.

- **--cmap**

  Causes the application to install a private color map on an 8-bit display.

- **--ncols *\<count\>***

  Limits the number of colors allocated in the color cube on an 8-bit display, if the application is using the QApplication::ManyColor color specification.

- **--nograb**

  Tells Qt to never grab the mouse or the keyboard.

- **--dograb**

  Running under a debugger can cause an implicit -nograb, use -dograb to override.

- **--sync**

  Switches to synchronous mode for debugging.

- **--fn, --font *\<fontname\>***

  Defines the application font.

- **--bg, --background *\<color\>***

  Sets the default background color and an application palette (light and dark shades are calculated).

- **--fg, --foreground *\<color\>***

  Sets the default foreground color.

- **--btn, --button *\<color\>***

  Sets the default button color.

- **--name *\<name\>***

  Sets the application name.

- **--title *\<title\>***

  Sets the application title (caption).

- **--visual TrueColor**

  Forces the application to use a TrueColor visual on an 8-bit display.

- **--inputstyle *\<inputstyle\>***

  Sets XIM (X Input Method) input style. Possible values are *onthespot*, *overthespot*, *offthespot* and *root*.

- **--im *\<XIM server\>***

  Set XIM server.

- **--noxim**

  Disable XIM.

- **--reverse**

  Mirrors the whole layout of widgets.

## KDE OPTIONS

- **--caption *\<caption\>***

  Use \`caption' as name in the titlebar.

- **--icon *\<icon\>***

  Use \`icon' as the application icon.

- **--config *\<filename\>***

  Use alternative configuration file.

- **--nocrashhandler**

  Disable crash handler, to get core dumps.

- **--waitforwm**

  Waits for a WM\_NET compatible windowmanager.

- **--style *\<style\>***

  Sets the application GUI style.

- **--geometry *\<geometry\>***

  Sets the client geometry of the main widget.

## SEE ALSO

More detailed user documentation is available from **help:/kstars** (either enter this URL into **konqueror**, or run \`khelpcenter help:/kstars').