Home · Configuration · The Geocentric in your skin · Translating (i18n) · GitHub project
Install weewx-loopdata 5.0 or later and weewx-skyfield, both per their instructions.
Download weewx-celestial.zip from the
release page,
then:
weectl extension install weewx-celestial.zip
Add the fields the report reads to the fields line of
[LoopData] [[Include]] in weewx.conf. The line must stay a BARE
comma-separated list (no brackets or quotes). Append:
current.dateTime.raw, almanac.sun.az, almanac.sun.alt, almanac.sun.earth_distance, almanac.moon.az, almanac.moon.alt, almanac.moon.earth_distance, almanac.moon.phase, almanac.next_full_moon.unix_epoch.raw, almanac.next_new_moon.unix_epoch.raw, almanac.mercury.az, almanac.mercury.alt, almanac.mercury.earth_distance, almanac.venus.az, almanac.venus.alt, almanac.venus.earth_distance, almanac.mars.az, almanac.mars.alt, almanac.mars.earth_distance, almanac.jupiter.az, almanac.jupiter.alt, almanac.jupiter.earth_distance, almanac.saturn.az, almanac.saturn.alt, almanac.saturn.earth_distance, almanac.uranus.az, almanac.uranus.alt, almanac.uranus.earth_distance, almanac.neptune.az, almanac.neptune.alt, almanac.neptune.earth_distance, almanac.pluto.az, almanac.pluto.alt, almanac.pluto.earth_distance, almanac.proxima_centauri.az, almanac.proxima_centauri.alt, almanac.proxima_centauri.earth_distance
(Entries already present — e.g. current.dateTime.raw — need not be
repeated; weewx-loopdata ignores duplicates.)
Restart WeeWX. The report appears under celestial/ of your web root.
Drop-in: install right over the existing version, then restart WeeWX —
weectl extension install weewx-celestial.zip
No weewx.conf changes; the fields line is unchanged. Note that
upgrading replaces the bundled skin (skins/Celestial/, including its
lang/ files) — local additions and overrides survive upgrades best as
[[[Almanac]]]/[[[Texts]]] entries in the report’s section of
weewx.conf (see Translating).
Uninstall the old version, then install the new one:
weectl extension uninstall celestial
weectl extension install weewx-celestial.zip
Restart WeeWX. (The restart also refreshes the deployed
celestial.css — CopyGenerator re-copies copy_once files on every
report first-run — and the page version-tags the stylesheet URL, so
browsers refetch it too.)
Your existing [LoopData] [[Include]] fields line keeps working as is —
7.x reads a subset of the 6.0 field set plus three new entries, so add
almanac.proxima_centauri.az, almanac.proxima_centauri.alt (the
migration utility adds them too, but for a 6.0 line it is simpler by
hand). The remaining 6.0 entries (rise/sets, twilights, ra/dec,
equinox/solstice, almanac.moon_phase, almanac.moon_index, sun
visible-time) are no longer read by this skin; keep them if your own
pages consume them, or trim them to the list above.
If you still list user.celestial.Celestial under data_services in
[Engine] [[Services]] (a leftover from 2.x that 6.x tolerated with a
stub), remove it now: 7.0 deleted the stub, and a stale entry will
keep weewxd from starting.
6.0 removed this extension’s loop fields (current.sunrise,
current.earthMarsDistance, current.moonWaxing, …); almanac fields
replace them. The sequence matters — the migration utility ships with
this extension, so the new version must be installed before it can run:
Uninstall the old version (required — see the 6.x note above about
data_services):
weectl extension uninstall celestial
weectl extension install over an existing version only overlays
files; it never reverses what the old version registered.
Uninstalling first (while the old install record still exists) removes
the old service registration and the bundled
celestial_de421.bsp/celestial_stars.dat files. If those linger,
delete user.celestial.Celestial from data_services in
[Engine] [[Services]] and remove the two orphaned celestial_* data
files from bin/user by hand.
Install weewx-loopdata 5.0+ and weewx-skyfield if you have not already, then install this version.
Run the bundled utility to rewrite your [LoopData] [[Include]] fields
line — every celestial entry (including pre-3.0 PascalCase names)
becomes its almanac equivalent, rendition suffixes are honored,
non-celestial entries are never touched, and the fields the report
needs are appended. Raw times and durations arrive with pinned units
(almanac.sunrise.unix_epoch.raw, almanac.sun.visible.second.raw),
so they keep the old fields’ fixed meanings — epoch seconds, seconds
of daylight — no matter how loopdata’s target report units are set:
source /home/weewx/weewx-venv/bin/activate
cd /home/weewx/bin # the directory CONTAINING the `user` package
# (~/weewx-data/bin on pip installs)
python -m user.celestial --migrate-loopdata-fields --config /home/weewx/weewx.conf --output /tmp/weewx.conf.migrated
diff /home/weewx/weewx.conf /tmp/weewx.conf.migrated # review, then move into place
(--in-place edits weewx.conf directly after making a
.bak-celestial-7.0 backup; --print-fields-value just prints the
migrated line for cut-and-paste.)
Restart WeeWX.
If your own pages read the old fields, note the three changes with no 1:1 equivalent:
almanac.moon.phase (the moonFullness replacement) is a raw
percent (e.g. 33.6), no longer a formatted string.moonWaxing is gone: the moon is waxing exactly when
almanac.next_full_moon.unix_epoch.raw <
almanac.next_new_moon.unix_epoch.raw (the bundled skin shows the
derivation).The [Celestial] section of weewx.conf (enable, update_rate_secs,
stars) is obsolete and can be deleted. The Skyfield and NumPy libraries
are no longer required by this extension (weewx-skyfield requires them,
and has its own ephemeris and star catalog).