TimeHover - Timezone Tooltip Extension

Automatically converts timezone references to your local time on any webpage.

The frustration caused when I looked at sites using different timezones and had to google/convert it to IST motivated me to create this tool.
Using the tool-

✨ Features

• Zero-click conversion: Hover over times with timezones to see local equivalent
• Universal compatibility: Works on GitHub, Gmail, news sites, event pages, forums
• Multiple formats supported:
  • 3:00 PM EST, 2:00PM EDT, 9am PST
  • 14:30 UTC, 09:00 JST, 16:00 CET
  • 2:30 a.m. EST, 11:59pm PST
• Smart detection: Avoids false matches (won't convert "ERROR 404" or "CPU 2.4GHz")
• Lightweight: No account needed, no data collection

🎯 Supported Timezones

US/Canada: EST/EDT, PST/PDT, CST/CDT, MST/MDT, ET, PT, CT, MT
International: UTC, GMT, CET/CEST, JST, IST
Future: More zones based on user feedback

🚀 Installation

1. Download or clone this repository
2. Open Chrome/Edge → Extensions → Developer mode
3. Click "Load unpacked" → Select the TimeHover folder
4. Visit any webpage with timezone references and hover to test

📋 Examples

Original Text	Hover Tooltip (if you're in PST)
Meeting at 3:00 PM EST	12:00 PM PST
Event 2:30 PM (EDT)	11:30 AM PST
Server restart 14:30 [UTC]	6:30 AM PST
Workshop 9am JST	4:00 PM PST (previous day)

⚠️ Limitations

Sites where it won't work:

• PDF files opened in browser
• Text rendered in images/canvas
• Closed Shadow DOM content
• Browser internal pages (chrome://, about:)
• Cross-origin iframes

Timezone limitations:

• Generic abbreviations default to Standard Time: ET → EST (not EDT)
• Ambiguous abbreviations not supported: CST could mean Central/China/Cuba
• No DST auto-detection: Uses fixed offsets, not calendar-aware
• Relative times not supported: "in 3 hours EST", "next Tuesday 9 AM PST"

Format limitations:

• Requires explicit timezone: Won't convert "3:00 PM" without timezone
• Space required between time and timezone: "3:00PMEDT" (no space) won't match
• English only: Non-English timezone names not supported

Special formatting support:

• ✅ Hyperlinks: <a href="#">Meeting at 3:00 PM EST</a>
• ✅ Timezone in parentheses: 3:00 PM (EST) or 14:30 [UTC]
• ✅ Superscript timezone: Meeting 2:00 PM<sup>(PST)</sup>
• ✅ Mixed formatting: Links with <a href="#">Event 9am (EDT)</a>

🔧 Future Improvements

High Priority:

• Add more timezone abbreviations (AEST, NZST, etc.)
• Handle ambiguous CST (Central vs China) with user preference
• Support tight spacing: "2:00PMEDT" format
• Add settings panel for timezone preferences

Medium Priority:

• ISO 8601 timestamp support (2025-10-06T14:00:00Z)
• Numeric offset support (GMT+5:30, UTC-8)
• Better visual indicator (small clock icon vs dotted line)
• Relative time parsing ("in 2 hours EST")

Low Priority:

• Non-English timezone names
• Calendar-aware DST handling
• Custom timezone mapping
• Right-click context menu for manual conversion

🐛 Known Issues

• MLH event pages: Some tight formatting may not be detected
• Dynamic content: Rapidly changing content may miss updates due to throttling
• Performance: Large pages with many time references may have slight delay

📝 Contributing

Most helpful contributions:

1. Report unsupported timezone formats you encounter on real websites
2. Test on different sites and report compatibility issues
3. Suggest common timezone abbreviations missing from the list

📄 License

MIT License - Feel free to modify and distribute.

---