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
- macOS 13 or later, on Apple silicon or Intel.
- A GPU that supports WebGL2. Every Mac that runs macOS 13 has one. On an Intel Mac with two graphics chips, the app asks for the discrete one, because the scene ray-marches a black hole and the difference is not subtle.
- About 165 MB of disk. The catalogues, imagery and elevation data ship inside the app, which is most of that figure.
- No internet connection. Nothing is streamed and nothing is fetched at runtime. There is also nothing to sign in to.
iOS
- iOS 16 or later, on any iPhone or iPad.
- A GPU that supports Metal. Every device that runs iOS 16 has one.
- About 500 MB of disk. The catalogues, imagery and elevation data ship inside the app, which is most of that figure.
- No internet connection. Nothing is streamed and nothing is fetched at runtime. There is also nothing to sign in to.
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:
- Hold fn while you press the key.
- Turn on Use F1, F2, etc. keys as standard function keys in System Settings → Keyboard, which makes them behave for every app.
- Use the Interface menu in the menu bar. Every panel is on it, and it works no matter what the keyboard is doing.
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.