Working across regions usually means checking another city before you send a message, schedule a meeting, or wait on a teammate. otak-clock keeps two world clocks and a small alarm controller in the status bar, so timezone checks and reminders stay inside VS Code without opening a browser or a separate clock app.

Quick Start

1. Install from the VS Code Marketplace.
2. Click either clock in the status bar.
3. Select a region such as Americas, Europe, or Asia.
4. Choose the time zone you want to display.

Repeat the same steps for the second clock. Use Swap Time Zones from the Command Palette when you want to switch the two status-bar positions.

The clocks use 24-hour time:

Hover over a clock to see the full date, IANA time zone ID, UTC offset, and DST status.

Alarms

Click the bell icon in the status bar to open the alarm menu:

When an alarm fires, otak-clock shows a notification and flashes the status bar. Notifications repeat every 30 seconds until you stop the alarm.

You can create up to 5 daily alarms. Each alarm can be enabled or disabled independently, fires once per day, and resets at midnight.

Capabilities

• Dual status-bar clocks: show two independent IANA time zones without leaving VS Code.
• Region-based picker: select time zones through a region-first Quick Pick flow.
• Focus-aware refresh: update every second while focused and every minute while unfocused to reduce background work.
• Detailed tooltips: inspect the full date, time zone ID, UTC offset, and DST status.
• Multiple daily alarms: manage up to five alarms from the status bar.
• Snooze and repeat notifications: snooze for 3 minutes, or keep receiving reminders every 30 seconds until stopped.
• Cross-window dismissal: pressing Stop in one VS Code window dismisses the same alarm in other windows.
• Configurable alarm sound: enable or disable sound and choose between classic-alarm and snake-ish.
• Alarm time-zone override: keep auto for each device's current system time zone, or choose a specific IANA time zone for all alarms.
• Settings Sync support: sync selected clocks and alarm configuration through VS Code Settings Sync.
• Localized interface: UI messages follow your VS Code display language.

How It Works

Clock Refresh

otak-clock schedules status-bar updates based on the VS Code window focus state. Focused windows show seconds and refresh every second. Unfocused windows show minute-level time and refresh on minute boundaries.

Alarm Evaluation

In the default otak-clock.alarmTimeZone = auto mode, alarms are evaluated using the current system time zone on each device. If you choose a specific IANA time zone in Settings, every alarm is evaluated against that time zone instead.

Cross-Window Synchronization

otak-clock uses VS Code's shared globalState to coordinate alarm dismissal between windows on the same machine. When you press Stop in one window:

1. The dismissal date is written to globalState.
2. Other windows detect the change on their next alarm tick.
3. Active notification sessions for the same alarm stop automatically.

Settings Sync

Clock selections and alarm configuration are registered for VS Code Settings Sync. Runtime state, such as whether today's alarm has already fired, snooze timers, and dismissal markers, stays local to the current machine.

Status Bar Reference

Settings

Commands

Open these commands from the Command Palette with Ctrl+Shift+P (Cmd+Shift+P on macOS):

Security & Privacy

otak-clock is designed for local use inside VS Code.

• Local processing: clock and alarm logic runs in the extension host.
• Zero network access: the extension does not make network requests.
• No telemetry: no analytics, usage tracking, or external logging.
• No account or API key: nothing to sign in to and no credentials to configure.
• Scoped persistence: settings are stored through VS Code configuration and extension globalState.
• Open source, MIT-licensed: the implementation is auditable on GitHub.

Language Support

The interface follows your VS Code display language:

English · 日本語 · 简体中文 · 繁體中文 · 한국어 · Tiếng Việt · Español · Português · Français · Deutsch · हिन्दी · Bahasa Indonesia · Italiano · Nederlands · Русский · العربية · ไทย · Türkçe

Requirements

• VS Code 1.90.0 or newer

Installation

Install from the VS Code Marketplace, or run:

ext install odangoo.otak-clock

npm install
npm run compile
npx vsce package
code --install-extension otak-clock-1.1.34.vsix

Troubleshooting

• Clocks are not updating: reload the VS Code window and confirm the extension is enabled.
• The time zone label is missing: check that otak-clock.showTimeZoneInStatusBar is enabled.
• An alarm did not fire: confirm the alarm is enabled, verify your system time, and check otak-clock.alarmTimeZone if you configured an override.
• An alarm fired in one window but not another: make sure the extension is active in both windows. Unfocused windows may detect alarms up to about 1 minute later.
• Alarm sound is missing: verify otak-clock.alarmSoundEnabled and your system audio output.

Related Extensions

More VS Code extensions by odangoo:

License

Released under the MIT License.