Software · Desktop · macOS & Windows

Will the crescent
be visible tonight?

Hilal Ephemeris computes the Moon's altitude and elongation at sunset across the entire planet, then draws the MABIMS and KHGT criteria right onto the map. Precise positions, straight from NASA JPL.

  • v0.0.4
  • GPL-3.0
  • JPL DE440s
Hilal Ephemeris main window showing the MABIMS visibility map of Indonesia for 28 February 2025

Everything for a hilal observation,
in one window

01

Visibility maps

Moon altitude and elongation at sunset, gridded across Indonesia or the whole world. Hover to read values, click any point for the full breakdown.

02

MABIMS & KHGT criteria

Criterion lines and shaded regions drawn straight onto the map. Toggle MABIMS (geocentric or topocentric) and KHGT as layers, with legends included.

03

Sky simulation

Animate the Moon, Sun and planets in a chosen field of view around sunset, then export it as a GIF.

04

Moon–Sun offsets

Plot the azimuth and altitude difference between Moon and Sun for every saved location, against the criterion lines.

05

Choose your kernel

Switch between JPL ephemerides (DE430 through DE442) from inside the app, with year ranges and sizes listed. Out-of-range dates are refused clearly.

06

Locations built in

All 38 provincial capitals ship with BIG coordinates. Edit them or add your own; checked locations are computed with every map and saved to CSV.

Sky simulation

Watch the sky at sunset, minute by minute

Pick a location and a time span. The app animates the Moon, Sun and planets around the setting Sun, with elongation, altitude and illumination in the corner of every frame. Save the result as a GIF for a report or a talk.

Sky simulation of the Moon, Sun and planets over Jakarta at sunset

Precise by construction

Sun and Moon positions come from Skyfield reading JPL Development Ephemerides published by NAIF. Boundaries use Natural Earth. Apparent topocentric coordinates, with optional dip correction from elevation. Every result is saved as a reusable grid, so re-plotting is instant.

Download Hilal Ephemeris

Version 0.0.4, released 6 October 2026. Free to download. What's new

  • macOSApple Silicon · macOS 11 or laterSHA-256 b12bdd2064237738a9cf7125381e0e98cb2f016403b84d8d02e2540f92fc8688
    Download · 159 MB
  • Windows64-bit · installs without administrator rightsSHA-256 7d30af6012853b8532e4807e5e07fc73507375f371a68baa0df4498c4608af3d
    Download · 117 MB
QR code for saweria.co/astronomcupu

Support the project

Hilal Ephemeris is free, and it is built in my precious spare time: evenings and weekends between work and nights at the telescope. If it helps your hilal observations, your support would mean a great deal and keeps new features and kernels coming.

Support on Saweria
First launch on macOS

The app is not notarised by Apple, so macOS may say it cannot verify the developer. Unzip it, then right-click app_ephemeris and choose Open, and confirm. You only need to do this once. Or, in Terminal:

xattr -dr com.apple.quarantine app_ephemeris.app

To check the download, compare its SHA-256 with the value above:shasum -a 256 Ephemeris-0.0.4-macos-arm64.zip

First launch on Windows

The installer is not code-signed, so Windows SmartScreen may show “Windows protected your PC”. Choose More info, then Run anyway. The installer does not need administrator rights. To check the download, compare its SHA-256 with the value above:Get-FileHash Ephemeris-Setup-0.0.4.exe

Changelog

  1. v0.0.4Latest
    • English interface: switch between Indonesian and English in Settings → General, including chart labels and log messages.
    • The user guide opens inside the app from Help → Guide, in both languages.
    • The date picker marks every conjunction from 2000 to 2050.
    • Your map logo now appears on charts and sky-simulation animations; the output folder and logo moved to Settings → General.
    • Results of earlier runs show up again in the Preview and Locations tabs, and Moon–Sun plots are saved automatically.
    • Fixed a clash between two locations named Medan.
  2. v0.0.3
    • New sky simulation: animate the Moon, Sun and planets around sunset with a choice of field of view, true-scale discs and Sun-centred Δaz/Δalt coordinates.
    • New Moon–Sun tool: plot the azimuth and altitude difference at sunset for every computed location, against the MABIMS topocentric and geocentric lines.
    • Each criterion layer (MABIMS geocentric and topocentric, KHGT) has its own legend.
  3. v0.0.2
    • Map layers can be turned on and off one by one.
    • First Windows build, with an installer that needs no administrator rights.
    • User guide with screenshots.
  4. v0.0.1
    • First release: Moon altitude and elongation maps at sunset, for Indonesia or the whole world.
    • Interactive map: hover to read values, click a point for the full breakdown.
    • Location list with decimal or degree–minute–second coordinates.
    • Altitude and elongation over time at one location.
    • Choose and download JPL ephemeris kernels from inside the app.