Setting Up

Choose a topic below. (click to view)


WorldWide Telescope can be launched in a Kiosk mode, which is designed for unfacilitated use in museums or other informal learning environments. There are two general ways this can be done. One is to show a narrative presentation in the form of a tour. The other mode is to allow free exploration.

Unless you go to great lengths to harden your kiosk computer by installing software to intercept certain windows keyboard commands, you should not have a publically-accessible keyboard connected. A connected keyboard gives the user the ability to Control-Alt-Delete to get task manager, which could break out of WWT and give access to the computer. For administration purposes, museum staff will want to be able to connect a keyboard or remote desktop to the computer to do this.

Kiosk Tour

  1. Create the tour in WWT. Save it to a file at a folder on your PC.
  2. On the last slide of your tour Right-click and choose “Set Next Slide.” This will bring up a dialog box click the first slide of the tour. Clicking the slide will also check the box “Link to Slide (Selected below).” Click Ok.
  3. Create a shortcut.
    1. Right-click at the location you want the shortcut to live and select “New/Shortcut”
    2. This will open a dialog box to type the location of the item. You can browse to the WWT install or if it is a standard installation, you can enter "C:\Program Files (x86)\Microsoft Research\Microsoft WorldWide Telescope\WWTExplorer.exe". Don’t forget that the entire path should be enclosed in double quotes.
    3. Following the location for WWTExplorer.exe (which is the WWT application), you should put the location of the Kiosk Tour you created in the first step. In this example, the tour (named “Kiosk Tour.wtt”) is on the desktop for the user named Exhibit and the full path to the tour "C:\Users\Exhibit\Desktop\Kiosk Tour.wtt”.
    4. Following the path to the tour, put the flag that puts the application into the kiosk mode “-kiosk”.
    5. For the above example, the entire entry for the location of the item would be: "C:\Program Files (x86)\Microsoft Research\Microsoft WorldWide Telescope\WWTExplorer.exe" "C:\Users\Exhibit\Desktop\Kiosk Tour.wtt” -kiosk. When you are finished you might want to change the name of the shortcut to something relating to the tour, such as “Run Cool WWT Kiosk Tour,” otherwise it will default to the name “WWTExplorer.exe”.
    6. You can always change this by right-clicking on the shortcut and selecting “Properties”. In the dialog box that comes up you can edit the Target field.

Interactive Kiosk Tour

In all cases you should consider what interaction you want with the public to have with WWT. Possibilities are:

  • Mouse/trackball
  • Xbox controller
  • Touch screen

Auto-start the Tour on Startup

  1. Setup auto-login for user running WWT.
  2. Setup shortcut to be executed on login
  3. Links to tools for timed startup and shutdown.

WorldWide Telescope can be used to produce and deliver experiences for planetarium domes. WWT is currently being used at several planetaria, from small inflatable domes all the way to large domes, such as the 20-projector Grainger Sky Theater at the Adler Planetarium in Chicago. In addition to multi-projector domes, WWT can be used to drive multiple monitor systems for flat or curved large format tiled displays. WWT has built-in support for coordinating multiple servers as well as the warps and blends necessary to create the correct projection for specific display layouts.

Instructions on how to setup and calibrate multi-channel systems can be found here.

Currently, WorldWide Telescope (WWT) can be controlled by a variety of controllers. Custom mapping can be done for MIDI and Xbox controllers, connected by USB to the computer running WWT as well as configurable virtual buttons.

MIDI Controller

Any MIDI controller can be used to control WorldWide Telescope. You can re-use mapping of WWT functions created by someone else. You can also create your own or edit a previously-created mapping. Start by selecting “Settings/Controller Setup...” This brings up a dialog window where you can select a file containing the mapping functions. For the Numark DJ2Go you can download a standard mapping file.

Numark DJ2Go

You can save and load different files with different mappings.

Highlighting a device in the list of MIDI devices on the left and clicking “Properties” below will bring up Controller Properties window that present the status of the controller and location to the image file used for mapping. Note, that this image can be specified as a URL, such as

or it can point to a local file, such as


To remove an existing binding, select it in the list and click the “-” button. A box will come up to ask you to confirm the removal of the control.

To remove an existing binding, select it in the list and click the “-” button. A box will come up to ask you to confirm the removal of the control.

To add a new binding, click the “+” button. This will bring up a box saying that WorldWide Telescope is listening to the controller waiting for you to manipulate a control that has not been previously mapped. When such a control is moved, it will ask for the control type; select one of:

  • KeyPress — detects that a key has been pressed and does some action.
  • KeyUpDown — this sets up two actions, one when the key goes from Down to Up and the other from Up to Down. These can be defined separately.
  • Slider — linear slider from one value to another
  • Knob — rotating know from one value to another
  • Jog — jog dial that can be move spun repeatedly, often used in advancing time

Once you have selected the control type it will be added to the list of control bindings with the Control Name the same is the ID number. You can then define what you want to happen when you manipulate the control. When you select a control binding the properties are shown below the list and you can change or set the following properties:

  • Binding Target Type pull-down — Categories of actions that can be sent to WWT.
  • Bind Type pull-down — Ways to bind the controller to WWT.
  • Property pull-down — Specific properties controlled.
  • Repeat checkbox — If this is checked, holding down will continuously send the same command. This makes sense for actions like zooming.

A full list of potential bindings is available in an Excel spreadsheet here.

The labels for the functions can be placed on the position of the corresponding knob on the image for the controller. In the case of the default map this has already been done. Click the function in the list and hold and drag onto the image. Release your mouse when the label is at the desired location. Note that when the “Monitor” box is checked and the key is pressed on the controller the label changes from white to yellow.

Xbox Controller

WWT can be controlled by a PC version of an Xbox Controller. This is an excellent interface to use in a planetarium or presentation environment because the controller is portable and the buttons can be distinguished in the dark.

WWT comes with a standard binding of functions. This default is for the left/right triggers to zoom out/in. The right bumper steps through objects in the context menu (at the bottom of WWT screen). The left thumbstick pan and scroll and the right thumbstick rotates the view. The Back key steps backwards and the Start key steps forwards through LookAt modes (Sky, Earth, SolarSystem etc.). The ABXY keys are defined in the table below.

  Look At Earth Look At Sky Look At Solar System
A   Equatorial Grid Asteroids
B   Constellation Boundaries Milky Way Model
X Clouds Ecliptic Overview Planetary Orbits
Y Clouds Constellation Figures 3D Stars

Default mappings appropriate for print or reference is available here.

In order to define your own settings select “Settings/Xbox Controller Setup...” This brings up a dialog window where you can select a file containing the mapping functions. Check the “Use Custom Mappings” box and you can see the default mapping and change any of them. You can control the properties in the same way as the MIDI controller, described above. Checking the “Use Mode Dependent Mappings” allows a different mapping to be used depending on the mode.

A full list of potential bindings is available in an Excel spreadsheet here.

You can save, load and share custom mappings files (extension .wwtxm) from this dialog box.

Virtual Buttons

Clicking the View button will show the View controls at the top of the WWT window. The blank area to the right of the control – identified by the green box in the image below – is a place where you can define and place custom virtual buttons. These buttons can have the same bindings as the MIDI and Xbox controllers.

Numark DJ2Go

Clicking the “+” key brings up a binding dialog box. You can give the button a “Name,” select “Button Type,” “Binding Target Type,” “Bind Type,” and “Property,” just like the MIDI controller, described above.

In the example above I have defined a Longitude and Latitude slider. Clicking the “E” enters an editing mode for the buttons. When in edit mode, you can rearrange the buttons. Right clicking on a button will allow you to toggle the button editing mode, change the binding properties or delete a virtual button.


WorldWide Telescope (WWT) is a great tool with access to Petabytes of image data from the cloud, but in some educational contexts the internet may not be available but it is desirable to use WWT as a tool on a stand-alone basis. WorldWide Telescope already can operate off-line when the internet is available, and browse any data previously viewed by that user on that machine. In a new installation, there is no cache history for a user to rely on and the experience is not acceptable.

To solve this issue we have created a tool that will allow for the creation of curated cache content that would be installed from a DVD or thumb drive along with the WWT client to allow a disconnected or poorly connected machine to run most of WWT features without ever having to connect to the internet.


WWT already has existing tools for basic cache management. With the Eclipse release WWT adds several new tools to help curate the cache contents. This is a combined list of both the new and old tools.

  • Cache measurement/purge utility in the Settings tab
  • Cache Management Menu from Right click menu item in explore/context tabs.
    • Cache Image Tile Pyramid
    • Show Cache Space Used
    • Remove from Image Cache
  • Playing a tour caches all data it views.
  • Playing tours with “Play all” option will play and repeat tours in a collection
  • Browsing collections will add images you view to the cache.
  • Play collection as slideshow will go from image to image and cache data as it goes.
  • Editing the cache directory manually thru Windows explorer.
    • C:\Users\{user name here}\AppData\Local\Microsoft\WorldWideTelescope
  • Setting up WMS servers, and caching data they use.
  • Running WWT in Solar System mode with Multi-Resolution planets will load in base maps need for that mode.
  • Save the Cache in Settings…Advanced..Save Cache as Cabinet File…
  • Load the Cache in Settings…Advances…Restore Cache from Cabinet File…


  1. Ensure your WWT instance has a fresh, clean cache.
  2. Use the cache tools to load data you thing is important .
  3. Measure the cache size as you go budgeting for the data sets you need.
  4. Use the UI or manual cache management in Explorer to trim excess if needed.
  5. Save The Cache file to a cabinet file.
  6. Move the cabinet file to a fresh non-internet connected machine.
  7. Install a fresh WWT install.
  8. Restore the Cabinet file.
  9. Verity operation and note any missing data.
  10. Repeat the above steps as necessary until the cache meets the educational requirements.


In the final Eclipse release the setup will detect the presence of a cache cabinet file and offer to install it automatically. This file should be named “WwtFileCache.cabinet” and be placed next to the WWTSetup.3.x.x.msi file. After installation WWT will use this cache transparently as if it actually visited all the data already.

WorldWide Telescope (WWT) can playback an SMPTE timing track to provide timing control of off-board audio or other SMPTE-controller effects. SMPTE provides a flexible, easy-to-implement control solution; this flexibility makes it possible to setup things in various ways. This document will provide a description of two potential scenarios, but more can be created if these don’t map to your facility.

Simple Audio Using Embedded Audio File in WWT Tour

The easiest way to setup a system is for the Master Server to output audio, via analog or digital audio output. The mono or stereo audio tracks are created for narration and music on per-slide or Master-slide basis in the tour – see LINK: Authoring/Dealing with Audio and LINK: Authoring/Editing Audio. Then direct connections between the Master Server and hardware sound system (amplifiers and speakers) takes care of the audio. This is a simple case with few pieces, but is limited by the number of audio channels and potentially the quality of the underlying audio files.

Note: For all WWT cluster implementations, Tours that are distributed to Projector Servers have the audio stripped out, to reduce file size and speed updating.

Multi-Channel Dome with SMPTE-controlled Audio Server

At some planetaria, such as the Grainger Sky Theater at the Adler Planetarium, they have a configuration with three types of servers: Master, Projector and Audio.

The Master Server controls any number or Projection Servers over the network via WWT and WWT Remote. These controls include:

  • Power control of Projection Servers from Master.
  • Updating Tour and Data from Master to Projection Servers.
  • Synchronization of playback on multiple Projection Servers.

For audio, audio tracks (mono, stereo or multi-channel) are loaded onto a dedicated Audio Server. On the WWT Master Server the normal audio track is replaced with a SMPTE timing track. This is usually done with a short-duration slide at the beginning of the tour that is a master and has the SMPTE track as MP3 or WAV format. The analog audio output of the Master Server is connected to an input port on the Audio Server. Once the appropriate audio track(s) are loaded on the Audio Server and the Audio Server is setup to be controlled by input SMPTE timing from Master (via analog audio connections), the audio and video are synchronized via the Master Server.

Note: Currently, the timing of WWT cannot be controlled by an external SMPTE source, such as a stand-alone SMPTE generator or Audio Server.

WorldWide Telescope (WWT) works with Oculus Rift virtual reality headset as a special stereo mode. You can use this mode by following these steps.

  1. Make sure you are running WorldWide Telescope 5.0, which is available here:
  2. Connect the Oculus to the computer.
  3. Turn the Oculus on. The Oculus will appear as a secondary monitor. If you look through the Oculus without WWT running you should see a desktop similar to what you see if you connected a secondary monitor.
  4. Note, you should try to put the Oculus over your eyeglasses.
  5. Start WWT.
  6. Enable Oculus Rift mode. Open the menu under View and select Stereo/Oculus Rift. See screenshot below.
    Enable Oculus Rift mode
  7. The scene should be visible in the Oculus. Note the menu items are still on the primary display and the main window in the primary will go blank when outputting to Oculus.