Help for iMaan

Moon and sun (and optionally Earth) travel across your desktop, with proper rise and set times and moon phase for your location on Earth, using it's built-in astronomy calculator. Moon and sun travel across your screen at their natural pace, and natural moon age, but you can speed them up, and make the moon spin very fast. Normally Moon and sun travel in an arc-shaped path, with settable horizon and elevation to match your desktop picture, or you can set the path to a straight line. Or, have them stationary in one location.

Preferences

To change the settings go to the top of the screen, click iSnow in the menu bar, and select "Preferences..." from the menu.
A window is shown where you can can select Moon, Sun, Earth, Displays.

There are very many options to change. If you made choices that you don't like there are buttons labeled "defaults", to reset to the default values.

If iMaan does not startup or crashes at startup: hold down the option-key while starting the application.
This will reset the preferences. Please contact me if you cannot resolve this. [rick.jansen@xs4all.nl]

Moon

The Moon rotates around the Earth in 29.53 days, while keeping one side to us, as it's rotation duration is also 29.53 days. So, we always see the same side of the moon, although there is a slight "wobble". The Moon moves over your desktop, with proper rise and set times for your geolocation on Earth, and actual illumination is shown for the moon age. This is the default behaviour, shown when you have these options selected (see image below, left): With these options selected the moon travels slowly over your desktop, as in the sky.
To change the Moon's behaviour select the options below.

Note on Location Services

This tells whether location services are available to iSnow or now, or if a geolocation was determined before.

Moon trajectory - timing and visibility

Moon trajectory - shape of the path

The Moon path is either an arc, or a straight line, or a single stationary location, depending on the options: Elevation is how high the moon is above the horizon. Here, you can set the horizon and maximum elevation on your screen using the two sliders "Horizon vertical position" and "Max moon elevation".
The red dotted line is the horizon, the blue dotted line the maximum elevation. The black solid line is the Moon trajectory, between horizon and max elevation. The same lines will be (temporarily) shown on your desktop.

Stationary moon (drag with mouse): If you prefer the Moon to not move but stay in one spot on your desktop then select this option. You can drag the little Moon in the box, the Moon on your desktop will follow. (Sorry, you cannot drag the Moon on the desktop itself with the mouse, as it is behind everything.)

Moon phase

As the Moon rotates around the Earth during 29.53 days the illumination by the sun changes from full moon to almost dark, and back.

Moon size

Set the Moon size with the slider. Default it is set to 0.5, so you can have a far bigger or a much smaller Moon on your desktop.

Huge full moon: tick this checkbox if you want a very large full moon. (This size Moon cannot spin.)

Moon color

If you are craving for a Blood Moon, for example, then have a go with the Color sliders. Values are RGB and α, α for transparency.
Brightness, contrast and saturation can be changed with the Brightness sliders.

Current moon data

Displays the current calculated data on the Moon.

No Moon

Oh..
(The moon does not use use any significant CPU, but the when the moon is "just spinning" some meory is used)

Moon defaults

Click this button to reset all settings to the default values.

[top]

Sun

The Earth rotates around the Sun in 365 days, and rotates around its own axis in 1 day. So, we see the Sun traverse the sky, travelling an arc from sunrise in the east, and sunset in the west. The Sun moves over your desktop, between the actual rise and set times for your geolocation on Earth. This is the default behaviour, shown when you have this option selected (see image below): With these options selected the sun travels slowly over your desktop, as in the sky.

To change the Sun's behaviour select the options below.

Note on Location Services

This tells whether location services are available to iSnow or now, or if a geolocation was determined before.

Sun trajectory - timing and visibility

Sun trajectory - shape of the path

The Sun path is either an arc, or a straight line, or a single stationary location, depending on the options: Elevation is how high the sun is above the horizon. Here, you can set the horizon and maximum elevation on your screen using the two sliders "Horizon vertical position" and "Max sun elevation".
The red dotted line is the horizon, the blue dotted line the maximum elevation. The black solid line is the Sun trajectory, between horizon and max elevation. The same lines will be (temporarily) shown on your desktop.

Stationary sun (drag with mouse): If you prefer the Sun to not move but stay in one spot on your desktop then select this option. You can drag the little Sun in the box, the Sun on your desktop will follow. (Sorry, you cannot drag the Sun on the desktop itself with the mouse, as it is behind everything.)

Sun size

Set the Sun size with the slider. Default it is set to 0.5, so you can have a far bigger or a much smaller Sun on your desktop.

Sun color

If you are craving for a differently colored Sun, then have a go with the Color sliders. Values are RGB and α, α for transparency.
Brightness, contrast and saturation can be changed with the Brightness sliders.

Current sun data

Displays the current calculated data on the Sun.

No Sun

Oh..
The Sun does not use use any significant CPU or memory.

Sun defaults

Click this button to reset all settings to the default values.

[top]

Earth

Even though the Earth is not visible in our sky you can have it on your desktop. Default it is stationary, in a location you can drag it to, but it can move, too, like the Moon or the Sun, timing is with the slider.

Earth view

  • Select a view on Earth using the slider.

    Earth size

  • Select a size using the slider.

    No Earth

  • Oh..
    The Earth does not use use any significant CPU or memory.

    Earth defaults

  • Click this button to reset all settings to the default values.

    [top]

    Displays

    iSnow supports multi-monitor systems. Choose: After changing this you needs to restart iSnow.

    Note

    For multi-monitor setups all monitors are added into an encompassing rectangle, where it will snow.
    "Displays have separate spaces" currently is not supported. This is a setting in your System Preferences:

        -> System Preferences -> Mission Control -> Displays have separate spaces (checkbox): OFF

    You need to logout or restart your Mac for this change to have effect.

    [top]

    Geolocation

    The moon and sun trajectories, moon phase, rise and set times can be automatically computed, provided your location on Earth is known.

    This requires that your Mac has location services enabled, and that you allow iSnow to access that location, as it is privacy sensitive information.
    Note that iSnow does not collect any data from you, nothing is shared.

    To enable Location Services click the  menu top left in your screen, in the menu bar:

        -> System Preferences -> Security&Privacy -> Privacy (tab) -> Location Services -> Enable

    Then, in the list of Apps below that, tick the iSnow checkbox.

    It may also be necessary to switch on WiFi, for your location to be determined.

    Again, your location is ONLY used for trajectory calculations, your location is not shared! Once a location is found the location detection is switched OFF.

    You can allow iSnow to access your location just once: if a location is established that location is stored, and used from now on, so you can even disable Location Services.

    [top]


    © 2021 by Rick Jansen, all rights reserved
    [Home page] Other products: [iSnow for macOS] [AutumnLeaves for macOS] [Hanami for macOS] [Xsnow]
    Rick Jansen, rick.jansen@xs4all.nl