Support

Getting help with Cosminova

Questions, problems and feature requests all go to the same place: email the developer at su.grant.x@gmail.com. Many common questions are answered below — the function keys in particular, which macOS takes for itself before any app sees them.

Contact support

Email: su.grant.x@gmail.com — every message is read by the person who wrote the app, and you can expect a reply within two business days.

Or, in public: open an issue at github.com/Cosminova/info/issues if you would rather the question and its answer be visible to everyone.

What makes a report answerable: your macOS or iOS version and device model, what you were looking at when it happened, and whether it happens every time. If the picture is wrong rather than missing, a screenshot settles in one second what a paragraph cannot.

What it needs to run

macOS

iOS

Common questions

The function keys do nothing

This is macOS rather than the app, and it catches nearly everyone. By default F1–F12 are brightness, Mission Control and volume, and the system consumes the keystroke before any application is offered it. An app cannot take them back for itself.

Three ways round it, and the last one always works:

How do I turn the music off?

macOS: Menu bar → Interface → Music, or F12. In the app itself it is in the Display panel (F9) under Effects. The setting is remembered, so it stays off next time.

iOS: Tap the Interface panel, then toggle Music under Effects. The setting is remembered, so it stays off next time.

How do I move around?

macOS: Drag to swing the view around whatever you have arrived at, and scroll to close in — all the way down to standing on the surface. Pick somewhere to go from the Navigation panel (F4), or search for it with F2.

The Navigation panel also has the four camera modes. Orbit circles what you selected, Track follows it, Fly takes you to it, and Roam hands you W A S D and lets you move through open space with nothing to orbit and nowhere you cannot go.

Press F1 at any point for the full list of controls.

iOS: Drag to swing the view around whatever you have arrived at, and pinch to close in — all the way down to standing on the surface. Pick somewhere to go from the Navigation panel, or search for it with the search button. Tap and hold on any body to rotate around it, or swipe to explore in Roam mode.

The window is black, or the frame rate is poor

macOS: A black window that never fills in means the GPU could not give the app a WebGL2 context. Restarting the app is worth trying first, since a context can be lost when a Mac wakes from sleep.

For frame rate: the scene is doing real work, and the two settings that buy the most back are in the Display panel (F9) — turn Bloom off under Effects, and lower the label density. A smaller window helps more than either, because the cost is per pixel.

iOS: A black screen that never fills in means the GPU could not initialize. Try restarting the app. For frame rate: the scene is doing real work. In the Display panel, turn Bloom off under Effects, and lower the label density. Using the app on iPad rather than iPhone, or in landscape orientation, can improve performance.

I closed the window. How do I get it back?

macOS: Closing the window leaves Cosminova running, the way most Mac apps behave, so the scene is still where you left it. Choose Window → Cosminova in the menu bar, press ⌘0, or click the Cosminova icon in the Dock. To quit entirely, choose Cosminova → Quit Cosminova or press ⌘Q.

Is a number in the app wrong?

Please report it. Nothing shown is invented: positions and trajectories come from JPL Horizons, planets from the NASA Exoplanet Archive, galaxies from Cosmicflows-3, RC3 and HyperLEDA, and the Moon's relief from Lunar Orbiter Laser Altimeter data. If a figure disagrees with the catalogue it came from, that is a bug worth a report rather than a difference of opinion.

Is there a version for Windows, or for the browser?

Both. Download the Windows installer, or open it in your browser with no install at all — it needs WebGL2 and nothing else.

Privacy

Cosminova collects nothing, and there is no account. The privacy policy says so in the detail Apple asks for.

Still stuck?

Email su.grant.x@gmail.com with your question. There is no question too small.

Last updated 15 October 2026