Skip to content

Ansarissab/whatsapp-web-conversation-timezone-helper

Repository files navigation

🕒 WhatsApp Web Conversation Timezone Helper 🌍

Know what time it is for the person you're chatting with — instantly.

This Chrome extension helps you keep track of your friends’, colleagues’, or clients’ local time right inside WhatsApp Web. No more awkward "Are you awake?" messages or guessing someone’s timezone.


✅ Features

🌎 Set a timezone for each chat manually Just click “🕒 Set Timezone” once, and it will remember it for next time.

🕐 Shows exact local time next to contact name E.g., 🌞 03:20 PM (Sydney, GMT+10)

🌞🌙 Sun/Moon emoji based on time of day See at a glance if it’s day or night in their location.

🔍 Searchable timezone selector Type “Tokyo”, “New York”, or “London” to quickly find the right timezone.

💾 Remembers timezones per contact Set it once per person — it sticks.

🔁 Refreshes automatically every minute Time always stays accurate.

No account or signup needed Everything runs locally in your browser.


📷 Screenshots

➤ Timezone label shown in header


➤ Beautiful searchable timezone selector


🛠️ How to Use

  1. Install the extension (from Chrome Extensions, enable Developer mode and Load unpacked)
  2. Go to WhatsApp Web (Refresh after adding this extension)
  3. Open a chat. You’ll see a 🕒 Set Timezone label near the top (next to the contact name).
  4. Click on the label to open the timezone picker.
  5. Type to search — for example: Sydney, London, Karachi, New York
  6. Select the appropriate timezone from the dropdown.
  7. That’s it! You’ll now see the local time for that contact whenever you chat with them.

🧠 How It Works

  • It watches for chat changes and automatically shows the saved timezone for each contact.
  • Timezones are stored locally using Chrome’s storage — no data leaves your browser.
  • It updates the time every minute, so it always stays in sync.
  • Based on the hour, it shows a 🌞 if it’s daytime (6am–9pm) or 🌙 if it’s night.
  • Currently the benchmark Timezone is GMT

⚙️ Developer Guide (Optional)

If you're a dev and want to improve or contribute:

  1. Clone the repo

    git clone https://github.com/Ansarissab/whatsapp-web-conversation-timezone-helper
  2. Go to chrome://extensions/

    • Enable "Developer Mode"
    • Click “Load unpacked”
    • Select the project folder
  3. Edit content.js to add features or improve styling


💡 Ideas for the Future, Comming Soon!

  • Support Slack, Discord, Gmail, etc.
  • Time difference (e.g. +3h from you)

🙌 Made with ❤️ for anyone who chats across timezones.

About

Whatsapp web conversation timezone helper

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published