v2.6.2.167 Sidereal Time (Astronomical)

Sidereal Time (Astronomical)

• Complete sidereal time system: GMST, GAST, LMST, LAST, ERA
• HA location integration: Uses configured coordinates automatically
• USNO-verified formulas: Accuracy < 1 millisecond
• Nutation correction: Equation of equinoxes included
• Options: Primary display type, format, precision, ERA/JD display
• Example: 19:40:23.47 LMST

v2.5.2.166 - old_english calender plugin added

Changelog - Old English Calendar (Lady Day)

[1.0.0] - 2026-01-05

✨ Added

• New Calendar Plugin: Old English Calendar (Lady Day)
• Historical English calendar with year starting March 25 (used 1155-1752)
• Dual dating support (e.g., "1660/61" for dates between Jan 1 - Mar 24)
• Quarter Days tracking: Lady Day, Midsummer, Michaelmas, Christmas
• Countdown to next Quarter Day
• Regnal year calculation for English/British monarchs (William I to Charles III)
• Historical events display (Magna Carta, Great Fire of London, etc.)
• UK Tax Year relevance (Old Lady Day = April 5)
• Season information based on Quarter Days
• Full multi-language support (12 languages): EN, DE, ES, FR, IT, NL, PL, PT, RU, JA, ZH, KO

⚙️ Configuration Options

• show_dual_date - Toggle dual dating display
• show_regnal_year - Toggle regnal year display
• show_quarter_days - Toggle Quarter Day countdown
• show_events - Toggle historical events
• year_style - Choose: old_style / new_style / both

📋 Technical Details

• Category: historical
• Update Interval: 3600 seconds (1 hour)
• Icon: mdi:crown

📚 References

• [Lady Day - Wikipedia](https://en.wikipedia.org/wiki/Lady_Day)
• [Old Style and New Style dates](https://en.wikipedia.org/wiki/Old_Style_and_New_Style_dates)

Full Changelog: v2.5.2.165...v2.5.2.166

v2.5.2.165 Ge'ez kalender plugin added

new:

Ge'ez (Ethiopian) Calendar 🆕

• Format: 15 መስከረም 2017 or ፲፭ መስከረም ፳፻፲፯
• Features:
  • 13-month calendar (12×30 days + Pagume)
  • Ge'ez/Amharic script support
  • Ge'ez numeral conversion
  • Ethiopian Orthodox holidays
  • ~7-8 years offset from Gregorian
  • Multiple date formats (Full, Short, Ge'ez)
• Update: Hourly

Full Changelog: v2.5.2.163...v2.5.2.165

Solar-System-Plugin

Changelog - Solar System Plugin

Alle wichtigen Änderungen am solar_system.py Plugin für Alternative Time.

---

[1.3.0] - 2026-01-05

🐛 Kritische Bugfixes

Blocking I/O im Event-Loop behoben

• Problem: _write_local_assets() wurde aus extra_state_attributes aufgerufen, was blockierende Datei-Operationen (open()) im Home Assistant Event-Loop verursachte.
• Fehlermeldung: Detected blocking call to open with args ('/config/www/alternative_time/solar_system_map.svg', 'w') inside the event loop
• Lösung:
  • Neue Cache-Variablen eingeführt: _cached_svg, _cached_png_data_uri, _cached_local_paths
  • Visualisierungsgenerierung und Datei-Schreiboperationen in update() verschoben
  • extra_state_attributes verwendet jetzt nur noch gecachte Werte

Falsche Erdposition korrigiert

• Problem: Die Erde wurde im Januar nicht oben (0°) angezeigt, sondern bei ~110° (rechts)
• Ursache: Falscher Referenzwinkel von 100° (fest codiert) statt ~206° (tatsächliche heliozentrische Länge am 1. Januar)
• Lösung: _get_earth_reference_angle() berechnet jetzt dynamisch die Erdposition am 1. Januar des aktuellen Jahres

✨ Neue Features

"Sie sind hier" Marker für die Erde

• Die Erde wird jetzt in der Visualisierung mit einem speziellen Marker angezeigt
• Grüne Umrandung und grüne Beschriftung für bessere Sichtbarkeit
• Mehrsprachiger "Sie sind hier" Text in allen 12 Sprachen

Verbesserte Mehrsprachigkeit

• Neue lokalisierte Texte hinzugefügt:
  • you_are_here: "Sie sind hier" in 12 Sprachen
  • footer: Footer-Text in 12 Sprachen
  • months: Monatsnamen in 12 Sprachen
• Neue Hilfsmethoden: _get_solar_data_text(), _get_month_names()

🗑️ Entfernt

James Webb Space Telescope (JWST)

• Komplett aus dem Plugin entfernt:
  • Aus planets Dictionary entfernt
  • Aus config_options (display_planet) entfernt
  • Aus allen Berechnungen und Visualisierungen ausgeschlossen

🔧 Technische Verbesserungen

Strukturelle Änderungen

• Planetenfarben direkt in den Planetendaten als color Attribut
• Klarere Winkelberechnung mit angle_to_xy() Funktion
• Voyager-Positionen für 2025 aktualisiert (Voyager 1: 163 AU, Voyager 2: 136 AU)
• Pluto als Zwergplanet mit is_dwarf_planet Flag und gestrichelter Orbitlinie

Code-Qualität

• Bessere Fehlerbehandlung in update() für Visualisierungsgenerierung
• Verbesserte Sprachhandhabung (z.B. "de-DE" → "de")
• Konstante AU_TO_KM als Klassenvariable

Unterstützte Sprachen

Alle Texte sind in folgenden Sprachen verfügbar:

Code	Sprache
en	Englisch
de	Deutsch
es	Spanisch
fr	Französisch
it	Italienisch
nl	Niederländisch
pl	Polnisch
pt	Portugiesisch
ru	Russisch
ja	Japanisch
zh	Chinesisch
ko	Koreanisch

---

Visualisierung - Koordinatensystem

              Jan (0°)
                 │
                 ⊕ ← Erde im Januar
                 │
    Okt ─────────☉─────────Apr
   (270°)    (Sonne)      (90°)
                 │
                 │
              Jul (180°)

• 0° (oben): Januar
• 90° (rechts): April
• 180° (unten): Juli
• 270° (links): Oktober
• Bewegungsrichtung: Im Uhrzeigersinn

---

Konfigurationsoptionen

Option	Typ	Standard	Beschreibung
display_planet	select	all	Welcher Planet angezeigt wird
coordinate_system	select	heliocentric	Helio- oder geozentrisch
show_distance	boolean	true	Entfernung anzeigen
show_constellation	boolean	true	Sternbild anzeigen
show_retrograde	boolean	true	Rückläufigkeit anzeigen
show_visibility	boolean	true	Sichtbarkeit anzeigen
enable_visualization	boolean	true	SVG/PNG Karte generieren
visualization_scale	select	logarithmic	Kartenskalierung
observer_latitude	number	0.0	Beobachter-Breitengrad
observer_longitude	number	0.0	Beobachter-Längengrad

v2.5.2.162

Full Changelog: v2.5.1.158...v2.5.2.162

Changelog - Alternative Time Systems

Alle wichtigen Änderungen an diesem Projekt werden in dieser Datei dokumentiert.

Das Format basiert auf Keep a Changelog,
und dieses Projekt folgt Semantic Versioning.

---

[Unreleased]

Hinzugefügt

Neues Plugin: TAI - International Atomic Time (Internationale Atomzeit) v1.0.0

• Kategorie: Technical
• Icon: mdi:atom
• Update-Intervall: 1 Sekunde

Features:

• Berechnung der Internationalen Atomzeit (TAI = UTC + 37 Sekunden)
• Anzeige von GPS-Zeit (TAI - 19 Sekunden) optional
• Anzeige von Terrestrial Time (TT = TAI + 32,184 Sekunden)
• Modified Julian Date (MJD) und Julian Date (JD) Berechnung
• Berechnung der Zeit seit TAI-Epoche (1. Januar 1958)
• Vollständige Schaltsekunden-Historie seit 1972

Konfigurationsoptionen:

Option	Typ	Standard	Beschreibung
show_utc_offset	boolean	true	UTC-Offset anzeigen
show_gps_time	boolean	false	GPS-Zeit anzeigen
time_format	select	iso	Zeitformat (iso/time_only/full)

Übersetzungen: EN, DE, ES, FR, IT, NL, PL, PT, RU, JA, ZH, KO

Technische Details:

• TAI-UTC Offset: 37 Sekunden (seit 1. Januar 2017)
• GPS-TAI Offset: 19 Sekunden (konstant seit 1980)
• TT-TAI Offset: 32,184 Sekunden (konstant)

---

Neues Plugin: UT1 - Universal Time 1 (Universalzeit 1) v1.0.0

• Kategorie: Technical
• Icon: mdi:earth
• Update-Intervall: 1 Sekunde (API-Cache: 1 Stunde)

Features:

• Echtzeit-Berechnung von UT1 (Erdrotationszeit)
• IERS REST API Integration für aktuelle DUT1-Werte
• Intelligentes Caching (konfigurierbar: 5 Minuten bis 24 Stunden)
• Fallback-Wert wenn API nicht erreichbar
• Earth Rotation Angle (ERA) Berechnung
• Greenwich Mean Sidereal Time (GMST) Approximation
• Tage seit J2000 (astronomische Referenz)

IERS API:

• Endpunkt: https://datacenter.iers.org/webservice/REST/timescales/RestController.php
• Parameter: UT1-UTC (DUT1 in Sekunden)
• Automatisches URL-Encoding
• Timeout: 10 Sekunden
• Asynchroner Abruf ohne Blockierung

Konfigurationsoptionen:

Option	Typ	Standard	Beschreibung
show_dut1	boolean	true	DUT1-Wert anzeigen
show_utc_comparison	boolean	true	UTC zum Vergleich anzeigen
time_format	select	iso	Zeitformat (iso/time_only/full)
cache_duration	number	3600	IERS-Cache-Dauer in Sekunden (300-86400)

Übersetzungen: EN, DE, ES, FR, IT, NL, PL, PT, RU, JA, ZH, KO

Technische Details:

• UT1 = UTC + DUT1
• DUT1 wird durch Schaltsekunden zwischen ±0,9s gehalten
• Aktueller Fallback-Wert: +0,1s (Stand Juli 2025)
• Messung durch VLBI mit Präzision < 15 Mikrosekunden

Sensor-Attribute:

# TAI Beispiel
state: "2026-01-05T00:36:52 TAI"
attributes:
  tai_utc_offset_seconds: 37
  total_leap_seconds: 37
  gps_datetime: "2026-01-05 00:36:33 GPS"  # wenn aktiviert
  tt_datetime: "2026-01-05 00:37:24.184 TT"
  modified_julian_date: 60680.026296
  seconds_since_epoch: 2145830212

# UT1 Beispiel
state: "2026-01-05T00:43:31.767 UT1"
attributes:
  dut1_seconds: 0.1
  dut1_display: "DUT1 = +0.100s"
  ut1_utc_relation: "UT1 = UTC +0.100s"
  earth_rotation_angle_deg: 100.1413
  gmst_approx: "06:40:33.94"
  dut1_source: "iers_api"  # oder "cached" / "fallback"
  dut1_last_updated: "2026-01-05T00:00:00+00:00"

---

Beziehungen zwischen Zeitskalen

                    TAI (Atomzeit, kontinuierlich)
                     │
                     │ -37s (Schaltsekunden)
                     ▼
                    UTC (Koordinierte Weltzeit)
                     │
                     │ +DUT1 (±0.9s, variabel)
                     ▼
                    UT1 (Erdrotationszeit)

TAI ──────┬──── +32.184s ────► TT (Terrestrial Time)
          │
          └──── -19s ────────► GPS (GPS Time)

---

Installation

Beide Plugins in den calendars-Ordner kopieren:

custom_components/alternative_time/calendars/
├── tai.py    # International Atomic Time
└── ut1.py    # Universal Time 1

Nach dem Kopieren Home Assistant neu starten oder die Integration neu laden.

---

Abhängigkeiten

TAI Plugin

• Keine zusätzlichen Abhängigkeiten

UT1 Plugin

• aiohttp (für IERS API, optional - Fallback verfügbar)
• Netzwerkzugriff auf datacenter.iers.org (optional)

---

Referenzen

TAI

• Wikipedia: International Atomic Time
• BIPM Time Metrology

UT1

• Wikipedia: Universal Time
• IERS Earth Rotation
• IERS Web Services

v2.5.1.161a

Full Changelog: v2.5.1.160...v2.5.1.161a

v2.5.1.160

✨ New in Version 2.5.1.160

🇯🇵 Japanese Calendar Systems

Three new comprehensive Japanese calendar implementations:

Japanese Era Calendar (和暦, Wareki)

• Traditional era dating: Reiwa, Heisei, Shōwa, Taishō, Meiji
• Multiple display formats: Full kanji, romaji, numeric
• Options:
  • Timezone selection (JST default)
  • Show/hide Gregorian date
  • Display current time in JST
  • Japanese holidays and weekdays
  • Rokuyō (六曜) lucky/unlucky day cycle
• Example: 令和6年12月15日（日）15:30 JST

Japanese Lunar Calendar (旧暦, Kyūreki)

• Traditional lunisolar calendar: Used for festivals and agriculture
• Moon phases: 14 traditional Japanese moon phase names
• Options:
  • Auto language detection (Japanese/English)
  • 24 Solar terms (二十四節気)
  • Traditional events and festivals
  • Zodiac animals (十二支)
  • Display formats (traditional/modern/numeric)
• Example: 旧暦 睦月十五日（満月）子年

🕉️ Hindu Calendar System

Hindu Panchānga (पंचांग)

• Complete Panchānga elements:
  • Tithi (lunar day)
  • Nakshatra (lunar mansion)
  • Yoga (sun-moon combination)
  • Karana (half-tithi)
  • Rashi (zodiac sign)
• Multiple era systems:
  • Shalivahana Shaka (default)
  • Vikram Samvat
  • Kali Yuga
• Options:
  • Display language (Sanskrit/Hindi/English)
  • Individual Panchānga elements toggle
  • Hindu festivals display
  • IST timezone (default)
• Example: शुक्ल पक्ष द्वितीया, आषाढ़ 1946 (शक)

Full Changelog: v2.5.1.158...v2.5.1.160

v2.5.1.149 Solar System Positions Plugin

Changelog
[2.5.1.149]
🪐 Added: Solar System Positions Plugin
New Calendar Plugin

Solar System Real-time Tracker: Complete astronomical calculation system

Tracks all planets, Pluto, Voyager probes, and James Webb Space Telescope
SVG and PNG visualization generation with orbital paths
Heliocentric and geocentric coordinate systems
Planet visibility calculations based on observer location
Distance measurements in AU and kilometers
Zodiac constellation positions for each object
Retrograde motion indicators
Kuiper Belt visualization (30-50 AU)
Three visualization scales: logarithmic, linear, compressed
10 configuration options including display modes and observer location
Updates every 5 minutes

🔧 Fixed: Options Flow Implementation
Options Flow Now Working

Functional Options Flow: Calendar settings can now be changed after installation
Options flow no longer shows "not implemented" message
Live configuration updates without restart required
All calendar options accessible through integration configuration
Configuration changes take effect immediately

🌍 Updated: Translations
Translation Improvements

Options flow interface fully translated in all 12 languages
Solar System plugin includes complete translations
Fixed incorrect "not implemented" messages in translation files
Added missing abort messages and descriptions

Full Changelog: v2.5.1.148...v2.5.1.149

v2.5.1.86

[2.5.1.86]

🎉 Major Update: Complete Config Flow Overhaul

This release brings massive improvements to all fantasy and sci-fi calendars with full configuration options and multi-language support.

✨ Added

New Configuration Features

• Full Config Flow Support: All calendars now have set_options() method for dynamic configuration
• Multi-language Labels: Complete translations for dropdown menus in 12 languages
• No More Abbreviations: All dropdown options now show full, descriptive text instead of abbreviations
• Per-Calendar Options: Each calendar has its own specific configuration options

Enhanced Calendars

🧙 Fantasy Calendars

Shire Calendar (Tolkien)

• Added 4 configuration options: meal display, moon phases, name days, display format
• New display formats: full, short, detailed
• Complete 12-language support for all options
• Hobbit family name days (Baggins, Took, Brandybuck, etc.)

Rivendell Calendar (Tolkien)

• Language mode selection: Quenya, Sindarin, English, or Mixed
• Yén cycle display (144-year periods)
• Elven star signs and constellations
• Moon phases in Sindarin terminology
• Age reckoning selection (First through Fourth Age)

Tamriel Calendar (Elder Scrolls)

• Dual moon phase tracking (Masser & Secunda)
• Khajiit form determination based on moon combinations
• Daedric Prince summoning days
• Guild activity schedules
• Era selection (1E through 5E) with full descriptions

Discworld Calendar

• Death quotes at midnight (IN SMALL CAPS)
• Guild influence tracking
• Ankh-Morpork location display
• L-Space anomaly detection at 3:33
• Century selection (Anchovy, Fruitbat, Garlic, Three Lice)

Warcraft Calendar

• (Previously implemented in 2.5.0)

🚀 Science Fiction Calendars

Star Trek Stardate

• Format Selection with Full Names:
  • "The Next Generation / Deep Space Nine / Voyager" (not just "TNG")
  • "The Original Series / The Animated Series" (not just "TOS")
  • "Discovery / Strange New Worlds" (not just "DIS")
  • "Kelvin Timeline (2009 Movies)" (not just "Kelvin")
• Decimal precision selection (0-4 places) with examples
• Notable event display for nearby stardates
• Rotating Starfleet vessel display with full ship information

EVE Online Time

• NEST label toggle
• Historical event display for YC years
• Empire rotation (Amarr, Caldari, Gallente, Minmatar)
• Trade hub display (Jita, Amarr, Dodixie, Rens, Hek)
• Format options: full, date only, time only, compact
• CONCORD status based on time of day
• Downtime warnings

Star Wars Galactic Calendar

• (Previously implemented in 2.5.0)

Warhammer 40K Imperial Dating

• (Previously implemented in 2.5.0)

🔧 Changed

Configuration System

• All calendar plugins now follow standardized CALENDAR_INFO structure
• Config options include label and description fields for better UI
• Options now support options_label for detailed dropdown descriptions
• Removed hardcoded configuration values in favor of dynamic options

User Interface

• Dropdown menus show complete descriptive text instead of abbreviations
• Each option displays helpful descriptions in user's language
• Configuration wizard shows calendar-specific options
• Better organization of settings by category

Code Structure

• Standardized set_options() method across all calendars
• Consistent option loading from config_entry
• Improved debug logging for configuration changes
• Better separation of concerns between sensor.py and calendar modules

🌐 Improved

Translations

• All calendar options fully translated in 12 languages:
  • English, German, Spanish, French, Italian, Dutch
  • Polish, Portuguese, Russian, Japanese, Chinese, Korean
• Era/Age descriptions with historical context
• Format examples localized for each language
• Option descriptions provide clear guidance

Performance

• Optimized update intervals based on calendar type
• Reduced unnecessary calculations
• Improved state attribute handling
• Better memory management for large option sets

🐛 Fixed

• Config flow not properly passing options to calendar sensors
• Missing translations in dropdown menus
• Abbreviations causing confusion in UI
• Options not persisting after restart
• Calendar sensors not reading config_entry options

📚 Documentation

• Updated README.md with version 2.5.1.0 information
• Added configuration examples for all calendars
• Documented all available options per calendar
• Added troubleshooting section
• Improved developer documentation

🔄 Migration Notes

For Users:

• Existing configurations will continue to work
• To access new options, remove and re-add calendars through UI
• All options have sensible defaults matching previous behavior

For Developers:

• Calendar modules must implement set_options() method
• Use full descriptive text in options_label dictionary
• Include all 12 language translations for new options
• Follow standardized CALENDAR_INFO structure

📊 Statistics

• Calendars Updated: 8 (Shire, Rivendell, Tamriel, Discworld, Stardate, EVE Online + 2 previous)
• Configuration Options Added: 35+
• Languages Supported: 12
• Lines of Code Changed: ~5000+
• Dropdown Options Improved: 50+ (all with full descriptions)

🙏 Acknowledgments

Special thanks to:

• The Home Assistant community for feedback
• Beta testers for finding configuration issues
• Contributors for translation improvements
• Terry Pratchett (GNU Terry Pratchett)

---

[2.5.0]

Added

• Initial Config Flow implementation
• Category-based calendar selection
• Warcraft, Star Wars, and Warhammer 40K calendars
• Basic multi-language support framework
• Plugin architecture for calendars

Changed

• Migrated from YAML to UI configuration
• Restructured calendar modules
• Improved update intervals

Fixed

• Various timezone issues
• Calendar calculation errors
• Memory leaks in update loops

Added

• Roman Calendar
• Islamic (Hijri) Calendar
• Chinese Lunar Calendar
• Hebrew Calendar

Changed

• Improved historical calendar accuracy
• Better date conversion algorithms

Added

• Discworld Calendar
• Egyptian Calendar
• Attic Calendar improvements

Fixed

• Maya calendar calculation errors
• French Revolutionary time display

Added

• Mars time zones
• Darian Calendar
• Julian Date display

Changed

• Optimized real-time calendar updates
• Improved sensor attribute handling

Added

• Tamriel Calendar (Elder Scrolls)
• Rivendell Calendar (Tolkien)
• NATO military time formats

Fixed

• Shire calendar meal times
• Stardate calculation precision

---

[2.0.0]

Added

• Complete rewrite with plugin system
• Shire Calendar (Tolkien)
• EVE Online Time
• Swatch Internet Time

Changed

• Moved to component architecture
• Async update handling
• Standardized calendar format

Removed

• Legacy YAML configuration
• Deprecated time systems

---

[1.0.0]

Added

• Initial release
• Star Trek Stardate
• Unix Timestamp
• Hexadecimal Time
• Maya Calendar
• Basic timezone support

For more information, visit the [GitHub repository](https://github.com/Lexorius/alternative_time)

v2.5.0.37

v2.5.0.37 (Current) 🆕

• added test_debug calendar
• added Mass-Effect (Citadel) calendar)
• added Harptos (Dungons and Dragons calendar)
• fixing config_flow and translation problems
• known issues : problem with recorder interfaces todo: recorder of time has to be disabled

v2.5.0.8

• added ESA Lunar Timesystem
• added Sexagesimal Cycle Calendar (干支 Gānzhī)
• added chinese Lunar calendar

v2.5.0.2

• fixed nato calendar integration

v2.5.0

• ⚡ Complete Architecture Rewrite
• 🎨 Standardized Calendar Format
• 🌍 Multi-language Support (11+ languages)
• 📁 Category-based Organization
• ⚙️ Enhanced Config Flow with plugin options
• 🔧 Per-calendar Configuration
• 📱 Device Grouping by category
• ⏱️ Async Performance improvements
• 🆕 New Calendars:
  • Islamic (Hijri) Calendar
  • Star Wars Galactic Calendar
  • Warhammer 40K Imperial Dating
  • Roman Calendar
  • World of Warcraft Calendar

Previous Versions

• v1.6.0: Tamriel, Egyptian, Discworld calendars
• v1.5.0: EVE Online, Shire, Imladris calendars
• v1.4.0: Mars time systems
• v1.3.0: Asian calendars, Attic calendar
• v1.2.0: NATO time formats
• v1.1.0: Maya calendar, async improvements
• v1.0.0: Initial release

Full Changelog: v2.5.0...v2.5.0.8