Command Reference Menu Commands CommandsMenu <guimenu>File</guimenu> Menu &Ctrl;N File New Window Open another &kstars; window &Ctrl;W File Close Window Close &kstars; window &Ctrl;D File Download Data... Open the Download Extra Data tool &Ctrl;O File Open FITS... Open a FITS image in the FITS Editor tool &Ctrl;I File Save Sky Image... Create image on disk from current display &Ctrl;R File Run Script... Run the specified KStars script &Ctrl;P File Print... Send the current sky map to the printer (or to a PostScript/PDF file) &Ctrl;Q File Quit Quit &kstars; <guimenu>Time</guimenu> Menu &Ctrl;E Time Set Time to Now Sync time to system clock &Ctrl;S Time Set Time... Set time and date Time Start/Stop Clock Toggle whether time passes <guimenu>Pointing</guimenu> Menu Z Pointing Zenith Center the display at the Zenith point (straight up) N Pointing North Center the display above the North point on the horizon E Pointing East Center the display above the East point on the horizon S Pointing South Center the display above the South point on the horizon W Pointing West Center the display above the West point on the horizon &Ctrl;M Pointing Set Focus Manually... Center the display on specific sky coordinates &Ctrl;F Pointing Find Object Locate an object by name using the Find Object Window &Ctrl;T Pointing Engage/Stop Tracking Toggle tracking on/off. While tracking, the display will remain centered on the current position or object. <guimenu>View</guimenu> Menu + View Zoom in Zooms view in - View Zoom out Zooms view out &Ctrl;Z View Default Zoom Restore the default Zoom setting &Ctrl;&Shift;Z View Zoom to Angular Size... Zoom to specified field-of-view angle &Ctrl;&Shift;F View Full Screen Mode Toggle full-screen mode Space View Horizontal/Equatorial Coordinates Toggle between the Horizontal and Equatorial Coordinate Systems <guimenu>Devices</guimenu> Menu Devices Telescope Wizard... Opens the Telescope Wizard, which provides a step-by-step guide to help you connect to your telescope and control it with &kstars;. Devices Device Manager Opens up the device manager, which allows you to start/shutdown device drivers and connect to remote INDI servers. Devices INDI Control Panel Opens up INDI Control Panel, which allows you to control all the features supported by a device. Devices Capture Image Sequence... Acquire images from a CCD camera or webcam device Devices Configure INDI Opens up a dialog to configure INDI-related features such as automatic device updates. <guimenu>Tools</guimenu> Menu &Ctrl;C Tools Calculator... Opens the AstroCalculator Tool, which provides full access to many of the mathematical functions used by &kstars;. &Ctrl;L Tools Observing List... Opens the Observing List Tool, which provide convenient access to some common functions for a list of objects chosen by you. &Ctrl;V Tools AAVSO Light Curves... Opens the AAVSO Light Curve Generator Tool, which allows you to download a light curve for any variable star from the American Association of Variable Star Observers. &Ctrl;A Tools Altitude vs. Time... Opens the Altitude vs. Time Tool, which can plot curves representing the altitude of any object as a function of time. This is useful for planning observing sessions. &Ctrl;U Tools What's Up Tonight... Opens the What's Up Tonight Tool, which presents a summary of the objects which are observable from your location on a given date. &Ctrl;B Tools Script Builder... Opens the Script Builder Tool, which provides a GUI interface for building &kstars; DCOP scripts. &Ctrl;Y Tools Solar System... Opens the Solar System Viewer, which displays an overhead view of the solar system on the current simulation date. &Ctrl;J Tools Jupiter's Moons... Opens the Jupiter Moons Tool, which displays the positions of Jupiter's four brightest moons as a function of time. <guimenu>Settings</guimenu> Menu Settings Info Boxes Hide/Show Info Boxes Toggle display of all three Info Boxes Settings Info Boxes Hide/Show Time Toggle display of the Time Info Box Settings Info Boxes Hide/Show Focus Toggle display of the Focus Info Box Settings Info Boxes Hide/Show Location Toggle display of the Location Info Box Settings Toolbars Hide/Show Main Toolbar Toggle display of the Main Toolbar Settings Toolbars Hide/Show View Toolbar Toggle display of the View Toolbar Settings Statusbar Hide/Show Statusbar Toggle display of the Statusbar Settings Statusbar Hide/Show Az/Alt field Toggle display of the mouse cursor's horizontal coordinates in the statusbar Settings Statusbar Hide/Show RA/Dec field Toggle display of the mouse cursor's horizontal coordinates in the statusbar Settings Color Schemes This submenu contains all of the defined color schemes, including your custom schemes. Select any item to set that color scheme. Settings FOV Symbols This submenu lists the available field-of-view (FOV) Symbols. The FOV Symbol is drawn at the center of the display. You may choose from the list of predefined symbols (No symbol, 7x35 Binoculars, One degree, HST WFPC2 or 30m at 1.3cm), or you may define your own symbols (or modify existing symbols) using the Edit FOV symbols... item. &Ctrl;G Settings Geographic... Select a new geographic location Settings Configure &kstars;... Modify configuration options Settings Startup Wizard... Opens the Setup Wizard, which allows you to easily set your geographic location and download some extra data files. <guimenu>Help</guimenu> Menu &help.menu.documentation; Popup Menu Popup MenuDescription The right click popup menu is context-sensitive, meaning its content varies depending on what kind of object you click on. We list all possible popup menu items here, with the relevant object type [in brackets]. [All] Identification and type: The top one to three lines are devoted to the name(s) of the object, and its type. For stars, the Spectral Type is also shown here. [All] Rise, Transit, and Set times for the object on the current simulation date are shown on the next three lines. [All] Center and Track: Center the display on this location, and engage tracking. Equivalent to double-clicking. [All] Angular Distance To...: In this mode, a dotted line is drawn from the first target object to the current mouse position. When you invoke the popup menu of a second object, this item will read Compute Angular Distance. Selecting this item will display the angular distance between the two objects in the statusbar. You can press the Esc key to exit angular distance mode without measuring an angle. [All] Details: Open the Object Details window for this object. [All] Attach Label: Attach a permanent name label to the object. If the object already has a label attached, this item will read Remove Label. [All] Show ... Image: download an image of the object from the internet, and display it in the Image Viewer tool. The "..." text is replaced by a short description of the image's source. An object may have multiple image links available in its popup menu. [All] ... Page: Display a webpage about the object in your default web browser. The "..." text is replaced by a short description of the page. An object may have multiple web links available in its popup menu. [All Named Objects] Objects in the Sky Internet Links Customizing Add Link...: This allows you to add your own custom links to the popup menu of any object. It opens a small window in which you enter the &URL; of the link, and the text you want to appear in the popup menu. There is also a pair of radio buttons which allow you to specify whether the &URL; is an image or an HTML document, so &kstars; knows whether to launch the web browser or the image viewer. You can use this to add links to files on your local disk, so this feature could be used to attach observing logs or other custom information to objects in &kstars;. Your custom links are automatically loaded whenever &kstars; starts up, and they are stored in the folder ~/.trinity/share/apps/kstars/, in files myimage_url.dat and myinfo_url.dat. If you build an extensive list of custom links, consider submitting them to us, we would like to include them in the next version of &kstars;! Keyboard Commands Commands Keyboard Navigation Keys Navigation Controls Keyboard Arrow Keys Use the arrow keys to pan the display. Holding down the &Shift; key doubles the scrolling speed. + / - Zoom In/Out &Ctrl;Z Restore the default Zoom setting &Ctrl;&Shift;Z Zoom to specified field-of-view angle 0–9 Center Display on a major Solar System body: 0: Sun 1: Mercury 2: Venus 3: Moon 4: Mars 5: Jupiter 6: Saturn 7: Uranus 8: Neptune 9: Pluto Z Center the display at the Zenith Point (straight up) N Center the display above the North point on the horizon E Center the display above the East point on the horizon S Center the display above the South point on the horizon W Center the display above the West point on the horizon &Ctrl;T Toggle tracking mode < Advance the simulation clock backwards by one time step > Advance the simulation clock forwards by one time step Menu Shortcuts Commands Menu Keyboard Shortcuts &Ctrl;N Open a new &kstars; window &Ctrl;W Close a &kstars; window &Ctrl;D Download extra data &Ctrl;O Open a FITS image in the FITS Editor &Ctrl;I Export sky image to a file &Ctrl;R Run a &kstars; DCOP script &Ctrl;P Print the current sky map &Ctrl;Q Quit &kstars; &Ctrl;E Sync the simulation clock with the current system time &Ctrl;S Set the simulation clock to a specified Time and Date &Ctrl;&Shift;F Toggle full-screen mode Space Toggle between the Horizontal and Equatorial Coordinate Systems F1 Open the &kstars; Handbook Actions for the Selected Object Objects in the Sky Keyboard Actions Each of the following keystrokes performs an action on the selected object. The selected object is the last object which was clicked on (identified in the status bar). Alternatively, if you hold down the Shift key, then the action is performed on the centered object instead. D Open the Details window for the selected object L Toggle a name label for the selected object O Add the selected object to the observing list P Open the selected object's popup menu T Toggle a trail on the selected object (solar system bodies only) Tools Shortcuts &Ctrl;F Open the Find Object window, for specifying a sky object on which to center &Ctrl;M Open the Set Focus Manually... tool, for specifying RA/Dec or Az/Alt coordinates on which to center [ / ] Start/End an Angular Distance measurement at the current mouse cursor position. The angular distance between start and end points is displayed in the statusbar. &Ctrl;G Open the Set Geographic Location window &Ctrl;C Open the AstroCalculator &Ctrl;V Open the AAVSO Lightcurve Generator &Ctrl;A Open the Altitude vs. Time tool &Ctrl;U Open the What's Up Tonight? tool &Ctrl;B Open the Script Builder tool &Ctrl;Y Open the Solar System Viewer &Ctrl;J Open the Jupiter Moons tool &Ctrl;L Open the Observing List tool Mouse Commands Commands Mouse Navigation Controls Mouse Moving the mouse The sky coordinates (RA/Dec and Az/Alt) of the mouse cursor are updated in the status bar "Hovering" the mouse A temporary name label is attached to the object nearest to the mouse cursor. Left-clicking Objects in the Sky Identifying The object nearest the mouse click is identified in the status bar. Double-clicking Objects in the Sky Centering Center and track on the location or object nearest the mouse click. Double-clicking on an Info Box will shade it to show/hide extra information. Right-clicking Objects in the Sky Invoking Popup Menu for Open the popup menu for the location or object nearest the mouse cursor. Scrolling the mouse wheel Zoom the display in or out. If you do not have a mouse wheel, you can hold the middle mouse button and drag vertically. Click-and-dragging Dragging the sky map Pan the display, following the drag motion. &Ctrl;+dragging the sky map Define a rectangle in the map. When the mouse button is released, the display is zoomed in to match the field-of-view to the bounds of the rectangle. Dragging an Info Box The Info Box is repositioned in the map. Info Boxes will stick to window edges, so that they remain on the edge when the window is resized.