michaelvillar / timer-app

A simple Timer app for Mac

A simple Timer app for Mac

Download here

Drag the blue arrow to set a timer. Release to start! Click to pause.

When the time is up, a notification will show up with a nice sound.

Create new timers with CMD+N.

Install as a brew cask via

brew install --cask michaelvillar-timer

Inspired by the great Minutes widget from Nitram-nunca I've been using for years. But it wasn't maintained anymore (non-retina) + it was the only widget in my dashboard :)

Timer requires macOS 10.11 or later.

Build

make

Keyboard Shortcuts

Enter digits to set minutes. A decimal point specifies seconds so 2.34 is 2 minutes and 34 seconds.

backspace or escape to edit. enter to start or pause the timer. cmd+n to create a new timer. r to restart with the last timer.

timer-app's Issues

Naming a timer

Are you interested in a new feature allowing for naming a timer?
Timer name would be set below the clock control and its name would show up in the notification when the time's up.

I have never programmed in Swift, but this can be a good way to learn, if you'd be willing to merge this feature.

How about add stop watch function?

when timer is stopped, click timer (central circle) to start stop watch;
when stop watch started, click timer to tag a time, and print out the tag ticket from bottom of the app;
put a stop/reset button to the right bottom corner to stop (when stop watch running) or reset (when stop watch stoped).

Reusing your assets for an elementary OS clone?

Hi Michael,

I switched recently to elementary OS and I really miss your awesome timer app. Have to admit I fell in love with it on macOS. That's why I just started cloning it: https://github.com/marbetschar/timer

Unfortunately I'm more of a programmer than a designer. And as I really like your design, I wanted to ask you if you're cool if I reuse your assets for a dedicated elementary OS clone, programmed in Vala?

To be fully transparent here, I also plan to release this Timer clone to the elementary OS AppCenter, a Pay-What-You-Want App Store. I'll probably publish it there with a suggested one-time price of 1 or 2 USD.

Dark Mode

I was just messing around with the code, to get started with #21, and since you've asked dark menu support, wouldn't it be gorgeous to have a dark skin as well?

Called "Skins" the ticket because this can be just a dark skin or a customisable skins enhancement. Just some raw ideas:

• Dark skin (automatic with dark menu)
• Customizable skins: get rid of the image sets or add some layer on top of them

Some quick samples:

Shortcuts

Honestly, the timer app is great! Thanks for putting in the work Michael!

Do you have any plans or think it might be useful to add "time adjustment shortcuts" like just typing a number and the timer automatically sets its minutes?

Mojave Bug: Transparent "Watchface" in passive mode

Hello guys,
first of all... i love this app! Thank you!

I switched to Mojave on Monday, so I noticed this bug. As soon as the timer window is no longer active/focused, the "watchface" becomes transparent. But if I click on the timer window and make it to my active / current window, everything looks good again. Strange.

Thank you,
Max

Option for shortcut

since cmd + n is a shortcut for a lot programmes. E.g. new Tab in browser, I want to be able to set a other shortcut to open a timer.

the triangle, is something wrong?

the translucent circles do not cover the triangles.

IOS maybe?

Can you make this available for ios devices?
I really like the simplicity of this app.

OS maybe?

Make a release

The last release was on May 18, 2016. In homebrew cask there is the same version 1.1. This version doesn't have 'stay on top' feature.

Can you release a new version or provide an instruction in the README.md how to build the app from source?

Cannot run timer after using `brew cask install michaelvillar-timer`

Describe the bug

MacOS security preventing timer from running after install via brew cask install michaelvillar-timer

To Reproduce

Steps to reproduce the behavior:

1. Open Terminal
2. Run command brew cask install michaelvillar-timer
3. After install finishes hit CMD+Spacebar and type timer to bring up the timer app installed in step 2. Press enter.
4. A dialog appears preventing the app to run.

Expected behavior

Timer app would start in a usable state.

Screenshots

Desktop (please complete the following information):

• OS version: [e.g. macOS 10.15.4]
• Version [e.g. 22]

Additional context

Add any other context about the problem here.

Drop support for anything before macOS 10.13

Apple stopped supporting 10.12 and earlier.

Should we stop supporting anything less than macOS 10.13?

This would allow us to write cleaner code since there has been a lot of new code features in 10.13 and above.

I'd like to hear everyone's views.

Tag and release 1.5.0

Hey @michaelvillar,

Would it be possible to build a new release for the changes since 1.4?

1.4...master

If you're super busy, I'm willing to join the project and do basic stuff like making releases, keeping a changelog, and testing.

Countdown timer starts with 00:00 after 24 hours

Issue: when the main timer (the black one) is set to more than 24 hours, the coundown timer (the red one) resets and starts counting up from 00:00 (see the screenshot). Even if this doesn't break the work of the timer, this is confusing.

Suggestion: remove the countdown timer's 24-hour display limit and let it display time intervals exceeding 24 hours, for example 32:24.

[Feature request] Is it possible to save a timer?

First of all, great app! Clean design, nice to use, thank you!

Personally, I use 25min and 50min timer a lot, I wonder if it's possible to save a timer so I don't need to set it up for 50min every time I use it, instead, just a simple click.

doesn't work on yosemite

I am still on yosemite

Update mac osx doc icon with actual time

It would be awesome if the app also updated the dock icon with actual time left so I wouldn't have to click the icon to know how much time has passed.

Use a fixed-width font and leading zeros for less jank

Hi

Is your feature request related to a problem? Please describe.
I notice little movements of the timer's contents—aka "jank"—out of the corner of my eye which is distracting

Describe the solution you'd like

• Use a fixed width font, please, so that, e.g., 51" → 50" doesn't move around
• Use leading zeroes, please, so that, e.g., 10" → 9" doesn't move around (it would be 10" → 09")

Describe alternatives you've considered
Hiding the Timer window, but when screen sharing that would make it hard for all participants to be aware of our current interval

Cheers!

Add logs

Is your feature request related to a problem? Please describe.
It is difficult for me to record every timer i set up when i focus on a task.

Describe the solution you'd like
It can export logs for today or this week's timers status.

Notarize Timer for macOS

Timer is currently not notarized, which means that it is difficult to run on modern macOS versions like Catalina due to enhanced security features.

• Notarizing macOS Software Before Distribution
• Apple Developer Program Membership Fee Waivers

Play/pause issues on Big Sur

Play/pause button becomes unclickable like it doesn't exist. The same happens to the blue dragging thingy that sets the time. Once the timer is set and running. It cannot be changed nor paused.

Further there is now a white border at the bottom. (See screenshot)

(On Big Sur beta running on Macbook Air 2017)

1. Open the timer
2. Set the timer
3. Let it run for 5 sec then try to pause. Nothing happens
4. Try to drag the blue thingy around. Nothing happens

Desktop

• OS version: macOS 11 beta]
• Version: 1.5.5

Timer goes off even when closed

Don't know if this is a bug or feature but when I close a timer and don't quit the app, it doesn't invalidate the timer and the timer goes off.

If you can confirm this isn't a feature then I can try and implement a solution to this?

[DELETE]

N/A

Timer skips seconds

Describe the bug
The timer skips seconds from time to time ^{(pun intended)}. For example, it may go from 53 to 51 without seeing 52.

To Reproduce
Steps to reproduce the behavior:

1. Set timer to 1 minute
2. Watch it count down and observe it skipping numbers

Expected behavior
It shouldn't skip numbers.

Desktop (please complete the following information):

• OS version: macOS 10.15.5
• Version: 1.5.4

elementary clone: Math issues

Hi Michael,

Thanks again for providing the design for the elementary clone of your Timer App! I made quite some progress, but right now I'm struggling with the math part.

If you have some time, it would be awesome if you can tell me what the following lines exactly do.
My main question here is: What exactly are location.x, location.y, center.x and center.y?:

timer-app/Timer/MVClockView.swift

Lines 627 to 635 in b877c37

	var location = self.convert(theEvent.locationInWindow, from: nil)
	location = self.convert(location, to: self.superview)
	let dx = (location.x - center.x) / center.x
	let dy = (location.y - center.y) / center.y
	var angle = atan(dy / dx)
	if (dx < 0) {
	angle = angle - .pi
	}
	var progress = (self.progress - self.progress.truncatingRemainder(dividingBy: 1)) + -(angle - .pi / 2) / (.pi * 2)

I tried to implement the logic, but for some reason the arrow item jumps straight to 6 o'clock:

Here's how I tried to implement the functionality:

https://github.com/marbetschar/timer/blob/63a2169922ebc3a3fc7ee88d7a886fbf57c55ce7/src/Widgets/Arrow.vala#L78-L97

The app fails to start on macOS Catalina

Describe the bug
The app isn't signed or notarized thus it fails to start.

To Reproduce
Steps to reproduce the behavior:

1. Download the app using the link in the description or using brew cask.
2. Run the app.

Expected behavior
Start up successfully.

Screenshots

Desktop (please complete the following information):

• macOS Catalina 10.15.6

12-hour support

Can we have 12-hour mode with an AM/PM symbol?

Perhaps a setting, which allows to toggle between 12hour/24hour mode

keep on top

Is your feature request related to a problem? Please describe.
Not a problem

Describe the solution you'd like
I wish there was an option to keep the timer on top of all windows. I am using this in a presentation where I show instructions for a hands on lab and would love to also show how much time is left in the lab.

Describe alternatives you've considered
Ive looked at a lot of timers, but this is perfect because its so simple.

Add option to disable timer sound

Scares me every time when my volume is set high! 😝

remove the icon in dock

Describe the bug
Right-click and uncheck the "show in dock" cannot remove the icon in dock. And if I quit and reopen the app, the "show in dock" menu item will be checked again, so It won't remember my decision.

Screenshots

Desktop (please complete the following information):
macOS 10.15.4
Version 1.5.1

Additional context
Am I doing it wrong?

Resizable window

Is your feature request related to a problem? Please describe.

Describe the solution you'd like
Hi, I'd like to have the window resizable.

Describe alternatives you've considered

Additional context

Distribute by homebrew

Great app. Would love to see a homebrew cask install option, that'd be cool.

Might even get round to it myself.

Menu Bar Support

Would be great if timer could make use of the menu bar instead of having an always open window.

Add build instructions and release

Hey @michaelvillar, I love this simple app. I use it daily.

Can you cut a new release with the recent changes?

Also, it would be nice to have build instructions somewhere. I used the following in terminal.

xcodebuild -quiet clean build CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO

Then the app is within build/Release.

Drag a calendar event and create a new timer?

I found it's useful to use a timer for counting down before a calendar event (e.g. a meeting event).

One possible way to create a new timer is by accepting a calendar file (.ics) and create a new timer.

#22 suggests naming a time. This could be useful as well.

[Feature Request] Always on Top

Love to see this, if I have time (cough) after uni semester, I'll give it a crack.

Missing hover state

There's no visual indicator that you can click to drag in the UI. If you changed the cursor on hover, it would make it more clear.

Window without timer controls

Steps to Reproduce:

1. Clone rep;
2. Open project in Xcode (my Version 11.3.1 (11C504));
3. Build project (I just set up "Signing -> Development Team" in "Build Settings", fix or not swift warnings - irrelevant);
4. Build success, but app without timer controls:
   

But installed from brew (brew cask install michaelvillar-timer) works fine:

Create Preference Window

Now that there are a few other simple features/settings requested, we should have a preferences window option.

Add ability to send timer via command line

I want to issue a command on the terminal like so $ timer 10 and the timer starts or resets to 10 minutes.

Sound choice

Hey,

Anyone wants to add the possibility to choose the sound of the alarm? (A menu or preference would be enough).
Someone (Ralph, not sure if you want your full name here) sent me sounds he created and it's pretty sweet.

alert-sound1.zip
alert-sound2.zip

Buggy mouse control

Describe the bug
Hard (or even unable) to drag the blue triangle near diagonal positions.

To Reproduce

• Open a timer
• Set time to one of the following: 5 min (top-right), 20 min (bottom-right), 35 min (bottom-left) or 50 min (top-left)
• Try to drag the blue triangle again

Expected behavior
The blue triangle should be dragged.

Actual behavior
The whole window is dragged.

Desktop (please complete the following information):

• OS version: macOS 10.14.6
• Version 1.5.0

Black border around app when in Dark Mode

Describe the bug
There is a black border around the app when in dark mode.

To Reproduce
Steps to reproduce the behavior:

1. Switch macOS to "Dark Mode"
2. Load Timer App
3. See dark border

Expected behavior
There should be either no dark border or the app should have an actual dark mode. Related to #24

Screenshots
Dark mode on:

Dark mode off:

Desktop (please complete the following information):

• OS version: macOS 10.15.4
• Version 1.4 (6)

Website

It would be amazing to have a simple website for this app. Not everyone that uses this app is tech-focused and GitHub can be intimating.

No notification / no sound

Running macOS Catalina V10.15.3

Minimize / Hide the timer, Dark interface

Would love a minimize button so it's not distracting anymore as it can be annoying at times.
Also it would be awesome if the center interface was also dark, maybe grey-ish.

That would be awesome

If this is something you are not looking into adding, feel free to let me know I'm ready to fork!!

Great job BTW <3

Sound/Volume is very faint

Hello. As noted in the issue title sound at the end of the time period seems extremely faint. Are oters experiencing this. Could it be fixed and perhaps an option to allow or not sound and at what level. Thank you.

Remove notification alert after it has been clicked on

I set the timer to have a notification alert (so that it doesn't go away after a few seconds). I usually keep the Timer app on another desktop (or "space") so that I can easily go to that desktop by clicking on the notification. However, after doing this, the notification alert stays on the screen until I manually dismiss it.

Is it possible to make it dismiss when it finds out that it has been clicked?

Question: timer persistence across suspend?

Hi there, first of all thanks for making this awesome app! I use it often.

I've noticed that sometimes it seems like the timer has issues persisting across suspensions (e.g. set timer for 10 minutes, suspend for 5, and have 5 left when the computer wakes). I haven't been able to reproduce it, but just curious if this app is expected to work in that case or not.