Astrology
Built Configurable
Zodiac signs, planetary retrogrades, and seasons from real ecliptic positions.
| Module type | astrology |
|---|---|
| Default expression ID | astrology |
| Refresh rate | 1 hour |
| Required config | latitudelongitude |
Declaration
<module type="astrology" id="astrology" />Properties
Reference any of these from a template via
{astrology:propertyName}.
| Name | Description | Example | Format arg |
|---|---|---|---|
sign | Current sun sign | Capricorn | — |
signSymbol | Sun sign Unicode symbol | ♑ | — |
signElement | Element (Fire/Earth/Air/Water) | Earth | — |
signQuality | Quality (Cardinal/Fixed/Mutable) | Cardinal | — |
signStart | Start date of current sign | Dec 22 | Yes |
signEnd | End date of current sign | Jan 19 | Yes |
signDay | Days into current sign | 14 | — |
nextSign | Next zodiac sign | Aquarius | — |
nextSignIn | Days until next sign | 16d | — |
prevSign | Previous zodiac sign | Sagittarius | — |
moonSign | Moon's current zodiac sign | Taurus | — |
moonSignSymbol | Moon sign Unicode symbol | ♉ | — |
mercuryRetrograde | Mercury in retrograde | false | — |
venusRetrograde | Venus in retrograde | false | — |
marsRetrograde | Mars in retrograde | false | — |
jupiterRetrograde | Jupiter in retrograde | false | — |
saturnRetrograde | Saturn in retrograde | false | — |
retrogradeCount | Number of planets currently retrograde | 2 | — |
retrogradePlanets | Comma-joined list of retrograde planets | Mercury, Mars | — |
dominantRetrograde | Most notable retrograde planet (empty if none) | Mercury | — |
dayRuler | Traditional planetary ruler of the weekday | Venus | — |
dayRulerSymbol | Day ruler Unicode symbol | ♀ | — |
signRuler | Traditional planetary ruler of the current sun sign | Saturn | — |
signRulerSymbol | Sign ruler Unicode symbol | ♄ | — |
moonMansion | Lunar mansion 1–27 | 14 | — |
sunSignProgress | Continuous 0.0–1.0 progress through current sun sign | 0.47 | — |
moonSignElement | Element of the current moon sign | Earth | — |
season | Astronomical season (hemisphere-aware) | Winter | — |
Events
| Trigger | Description |
|---|---|
| On sign change | Sun enters a new zodiac sign |
| On retrograde start | A planet enters retrograde motion |