v1.2.0

What Changed?

Update the existing script by running:

curl -L https://raw.githubusercontent.com/niraletter/waybar-timer/main/timer.sh -o ~/.config/waybar/scripts/timer.sh

Additions

• Add proper syncing across multiple waybar instances - reported by @theharmy #9

Fixes

• Fix first click activation not working #9
• Fix singleton kill block terminating other monitor's daemon on startup #9

Full Changelog: v1.1.3...v1.2.0

v1.1.3

What Changed?

Additions

• Add POMO_ENABLED config to disable Pomodoro mode for simple scroll-adjustable timer use (#6)

Fixes

• Fix first preset on right-click in standard timer mode—now correctly selects 60s instead of skipping to 5m (#7)

New Contributors

• @louisbranch made their first contribution in #6 & #7

Full Changelog: v1.1.2...v1.1.3

v1.1.2

What changed?

Fixes

• Fix multiple processes piling up in background on Waybar reload
• Fix inconsistent scroll behavior and tooltips for Standard/Pomodoro modes reported by @vaskark #5

Full Changelog: v1.1.1...v1.1.2

v1.1.1

What Changed?

Add few CLI arguments, Pomodoro skip functionality, and notification urgency fixes.

Additions

• CLI Arguments for Keyboard Shortcuts suggested by @BibekBhusal0 #4
  • toggle - Toggle play/pause
  • pause - Force pause timer
  • resume - Force resume timer
  • reset - Reset timer to idle
  • skip - Skip current pomodoro session
• Pomodoro Skip with Right Click - Right-click during active pomodoro sessions to skip current work/break period

Fixes

• Fix notification persistence issue where timer completion notifications became sticky in certain notification daemons (changed from critical to normal urgency)

Usage Examples

# Start a timer
./waybar-timer.sh 25m

# Bind these to keyboard shortcuts in your WM/DE
./waybar-timer.sh toggle    # Pause/resume
./waybar-timer.sh skip      # Skip current session (pomodoro only)
./waybar-timer.sh reset     # Reset timer

Pomodoro Skip Behavior

• Right-click during work session → Skip to break
• Right-click during break → Skip to next work session (or complete if last session)
• Tooltip shows "Right Click: Skip Session" when available

Upgrade Steps

Simply update your script:

curl -L https://raw.githubusercontent.com/niraletter/waybar-timer/main/timer.sh -o ~/.config/waybar/scripts/timer.sh && \
chmod +x ~/.config/waybar/scripts/timer.sh

No configuration changes needed if you're upgrading from v1.1.0.

Full Changelog: v1.1.0...v1.1.1

v1.1.0

What Changed?

Major rewrite with event-driven architecture, add sound effects, and Pomodoro mode.

New Features

• Add full Pomodoro support with editable work, break, and session durations
• Add desktop notifications with optional sound support
• Add new CLI arguments for timer and Pomodoro control
• Add persistent state so the timer survives restarts and syncs across instances

Improvements

• Reduce CPU usage to 0% when idle or running by switching to an event-driven FIFO model
• Remove click latency with instant UI updates

Bug Fixes

• Fix delayed UI updates from sleep polling
• Fix excessive CPU usage from constant wakeups
• Fix sound path expansion with ~ character
• Fix state loss on Waybar crash (now persists)

Upgrade Steps

Update your Waybar config - remove interval and signal, add update mouse event handlers:

// Remove: "interval": 1, "signal": 42

// Add:
"on-click": "~/.config/waybar/scripts/timer.sh click",
"on-click-right": "~/.config/waybar/scripts/timer.sh right",
"on-click-middle": "~/.config/waybar/scripts/timer.sh middle",
"on-scroll-up": "~/.config/waybar/scripts/timer.sh down",  // previously up
"on-scroll-down": "~/.config/waybar/scripts/timer.sh up",  // previously down
"return-type": "json",
"format": "{}",
"tooltip": true,
"escape": true

Then run:

mkdir -p ~/.config/waybar/scripts ~/.config/waybar/sounds && \
curl -L https://raw.githubusercontent.com/niraletter/waybar-timer/main/timer.sh -o ~/.config/waybar/scripts/timer.sh && \
curl -L https://raw.githubusercontent.com/niraletter/waybar-timer/main/sounds/timer.mp3 -o ~/.config/waybar/sounds/timer.mp3 && \
chmod +x ~/.config/waybar/scripts/timer.sh

This adds new sounds directory with an audio file timer.mp3 in your ~/.config/waybar/sounds.

Full Changelog: v1.0.0...v1.1.0

v1.0.0 - Initial Release

First public release of waybar timer.