Repository navigation
Add end-of-timer reminder overlay and caffeine mode, release 0.1.3 - #7
Merged
Merged
Conversation
When a focus session ends, a full-screen glass overlay shows a reminder (stand up, drink water, rest your eyes, stretch, or custom text) with Dismiss and Start Break buttons; when a break ends it offers Start Focus. Caffeine mode holds an IOKit power assertion so the Mac and display stay awake while the timer runs, released when it pauses, stops or finishes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SxiPF75k29ZLVHYLDSZuFz
0nahid
marked this pull request as ready for review
October 18, 2026 21:47
…0.1.3 The overlay panels no longer hide when Matinee loses focus, the app is activated before a panel is made key so Esc and Return reach it, and the backdrop is dimmed and drawn dark so the text stays readable on any wallpaper. A Preview button shows the chosen reminder right away. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SxiPF75k29ZLVHYLDSZuFz
0nahid
changed the title
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Nahid Hassan · project thread
Before: when a phase ended Matinee played a sound and nothing else, and the Mac could go to sleep in the middle of a focus session.
After: when a focus session ends, every screen is covered by a dimmed glass overlay with a reminder (Stand up, Drink water, Rest your eyes, Stretch, or your own text) and Dismiss / Start Break buttons (Esc / Return). When a break ends, it shows "Break's over" with Start Focus. A Preview button next to the reminder picker shows it immediately. A new Caffeine switch in the menu keeps the Mac and display awake while the timer runs. The version goes to 0.1.3, so merging publishes a release and installed copies update.
How:
ReminderSettings(persisted in UserDefaults) picks the reminder;ReminderOverlayputs a borderless key-capableNSPanelat screen-saver level on each screen (withhidesOnDeactivateoff, and the app activated before the main-screen panel is made key) hostingReminderOverlayView.FocusTimergains anonPhaseFinishedcallback wired up inMatineeApp.CaffeineModefollowstimer.isRunningvia observation tracking and holds aPreventUserIdleDisplaySleepIOKit assertion only while enabled and running, so it's released on pause, stop, finish or quit.To test on a Mac: click Preview, try Esc and Return, and check it covers every display; set focus to 1 min and let it run out; turn on Caffeine, start a timer and check
pmset -g assertionslists Matinee, then pause and check it's gone.🤖 Generated with Claude Code
https://claude.ai/code/session_01SxiPF75k29ZLVHYLDSZuFz