Repository navigation
Releases: kamalyaser31/instantTimer
Releases · kamalyaser31/instantTimer
Release list
Instant Timer 2026.2
What's Changed in Instant Timer 2026.2
This is a new version for the NV Access Add-on Store. The 2026.1 package is left unchanged.
Changes
- New layer shortcut:
NVDA+Y(wasNVDA+E), to avoid a conflict with the Instant Access add-on. - Renaming a running timer no longer stops it. Changing only the label keeps the countdown going; changing the duration still resets it. Saving is now announced.
- Report all (
A) now includes the stopwatch when it is running or paused. - Active timers survive an NVDA crash: they are saved on every change, not only when NVDA exits.
- Settings are saved safely:
config.jsonis written atomically, so an interrupted save can no longer wipe your labels and durations. - Reset to factory defaults now warns that running timers will be stopped.
Fixes
- The command layer always closes, even if a command fails, so Space and the other layer keys are never left captured.
- Opening a second duration dialog now focuses the one already open.
- Silencing or resetting no longer cuts off other NVDA sounds; only the alarm is stopped.
- The early warning beep no longer sounds immediately for timers shorter than the warning lead time.
Requirements: NVDA 2024.1 or later (tested up to 2026.2).
Instant Timer 2026.1
What's Changed in Instant Timer 2026.1
Instant Timer is a lightweight, accessible countdown timer and digital stopwatch add-on for the NVDA screen reader, engineered on principles of speed, minimalism, and strict screen-reader accessibility.
Key Features
- Modal Command Layer (\NVDA+Y): Single-entry modal command layer that automatically returns to standard keyboard input after executing any action.
- 5 Preset Independent Countdown Timers:
- \1\ through \5: Query remaining time or start countdown.
- \Shift + 1-5: Reset timer to initial stopped state.
- \Alt + 1-5: Pause or resume countdown.
- \Control + 1-5: Configure duration (hours, minutes, seconds) and optional custom label.
- Ad-Hoc Quick Timer:
- \Q: Query remaining time or start quick countdown.
- \Shift + Q: Reset quick timer.
- \Alt + Q: Pause or resume quick countdown.
- \Control + Q: Open duration dialog and start immediate countdown.
- Lightweight Digital Stopwatch:
- \S: Query elapsed time or start stopwatch.
- \Shift + S: Reset stopwatch to zero.
- \Alt + S: Pause or resume stopwatch.
- \Control + S: Restart stopwatch immediately from zero.
- Layer Control & Status Commands:
- \A: Announce status summary of all timers.
- \Space: Immediately silence ringing alarm.
- \H: Open command layer documentation in browse mode.
- \Escape: Exit command layer silently.
- Configurable Notifications & Lead Times:
- Expiry notifications via sound only, speech only, or sound and speech.
- Pre-expiry warning cue with customizable lead time (1–300 seconds, default 10s).
- Configurable NVDA restart policy (resume, reset, or pause active timers).
- Standalone Local JSON Storage: All settings, durations, labels, and session state are persisted cleanly in \config.json.
- Localization: Full English and Classical Arabic translations and documentation.
- Verification: 48 automated behavioral unit tests passing with 100% test coverage.
Installation
Download \instantTimer-2026.1.nvda-addon\ below and open it in NVDA.