Time Out

Posts about Dejal Time Out.

What are the differences between the direct, Mac App Store, and Setapp editions of Time Out?

The direct edition (available from this site), the Mac App Store edition, and the Setapp edition are very similar, but there are a few minor differences:

Download

The direct edition can be downloaded from this site.

The Mac App Store edition can be downloaded from the App Store app.

The Setapp edition can be downloaded from the Setapp app.

Installation

The direct edition will download to your Downloads folder, so simply drag it into your Applications folder to install.

The Mac App Store edition will be downloaded directly into the Applications folder.

The Setapp edition will be downloaded directly into the Setapp subfolder within the Applications folder.

Updates

The direct edition can be updated via an in-app updater.

The Mac App Store edition can be updated via the App Store app.

The Setapp edition can be updated via the Setapp app.

Beta releases

The direct edition supports beta releases to help test new updates.

The Mac App Store and Setapp editions are not updated until the general release.

Purchase

The direct edition offers optional in-app purchases via FastSpring (or from this site).

The Mac App Store edition offers optional in-app purchases via your Apple ID (Apple iCloud account).

The Setapp edition doesn’t offer any purchase; all features are always available as part of your Setapp subscription.

Proceeds

The direct edition provides 91% of the purchase price to me, the developer (after FastSpring’s cut).

The Mac App Store edition provides 85% of the purchase price to the developer (after Apple’s cut).

The Setapp edition provides a portion of your Setapp subscription to the developer, based on the number of people using it each month.

Sandbox

The direct and Setapp editions are not sandboxed, to enable updating, though they act with the same limitations as a sandboxed app.

The Mac App Store edition is sandboxed, requiring extra steps to approve keyboard usage detection and install action scripts.

Data location

The direct edition stores its data in the path “~/Library/Group Containers/6Z7QW53WB6.com.dejal.timeout/”, where “~” means your home folder.

The Mac App Store edition stores its data in the path “~/Library/Group Containers/6Z7QW53WB6.com.dejal.timeout.free/”, where “~” means your home folder.

The Setapp edition stores its data in the path “~/Library/Group Containers/6Z7QW53WB6.com.dejal.timeout-setapp/“, where “~” means your home folder.

Your choice

That’s about it. None of the differences are all that significant, so you are welcome to use whichever edition you prefer. Downloading and updating are about as easy for each, and purchasing the direct and Mac App Store editions are similar, it just depends on whether you want to buy with your credit card or PayPal account, or your Apple ID. Of course, purchasing is optional; you can use it for free if you don’t want to become a supporter. And if you have Setapp, it makes sense to use that edition, since it’s included in your Setapp subscription.

I get a warning of another copy of Time Out

Look in your Dock and menu bar; does Time Out appear more than once?

If it’s in the Dock more than once, you can long-click or right-click on the Dock icon to display the Dock menu for the app, then choose Options ▸ Show in Finder to reveal the app in the Finder. Do this for each to find the one that shouldn’t be there — it could be in your Downloads folder, or in a subfolder of Applications if you installed both from the Dejal site and the Mac App Store.

Once you find the duplicate, quit that app (by double-clicking the app icon to bring it to the front, then press ⌘Q), then move it to the Trash and empty the Trash.

Can I move the Time Out break controls, or change the buttons?

Yes, the control panel with the progress bar and buttons, that appears during breaks, can be freely moved anywhere on the screen. The position will be remembered for next time.

Having difficulty with self control, skipping breaks too often?

No problem: you can disable the buttons during the break. Simply go to the Break Appearance page, and you’ll find checkboxes to enable or disable each button, and change the number of minutes for the two postpone buttons.

There are also options to disable the buttons for a few seconds, to give you a chance to decide if you really want to skip the break. And to limit the number of times they can be used, if you need a little more help.

Break controls

No Time Out break appears when I try to start one

If no break appears when you manually start one, or as scheduled, there are a few possibilities.

  1. Firstly, look in the sidebar; it should indicate why a break didn’t occur.
  2. You should restart your Mac. That often fixes wackiness.
  3. If that doesn’t help, make sure you don’t have more than one copy of Time Out.
  4. If still no luck, there may be a permissions issue.

To fix a permissions issue, try this:

Make sure Time Out is in your Applications folder.

Paste the following command into Terminal:

xattr -d -r -s com.apple.quarantine /Applications/Time\ Out.app

If this gives a permissions error (e.g. “xattr: [Errno 13] Permission denied”), try it again with sudo before the command, to elevate the privileges. You’ll need to enter your Administrator password. This command is safe to use with sudo:

sudo xattr -d -r -s com.apple.quarantine /Applications/Time\ Out.app

What are natural breaks in Time Out, and how do I configure them?

“Natural breaks” are when the Mac is not being used; idle.

By default, Time Out will wait briefly then count backwards when you are having a natural break, to give you credit for not using your computer.

If you do a lot of reading on-screen, that doesn’t cause keyboard or mouse activity, you can change the app to disable this behavior by choosing Continue Countdown from the popup menu on the Break Appearance page of the settings.

Or if you’d prefer to have it just pause the countdown, instead of counting backwards, or reset the timer, those are also options.

Are older versions of Time Out available for download?

Yes. I recommend that you always use the latest version of Time Out if you can, as it has the latest improvements and fixes. But if your Mac isn’t using a recent OS version, you’re curious what older versions were like, or you have some other reason to want an older version, they are still available. Just download the latest release that supports your OS version.

Time Out 2.9 released

[This post was recovered from the old blog, thanks to being cross-posted on Reddit.]

I’m pleased to announce the general release of an update of Time Out, my popular break reminder tool.

Version 2.9 includes several great enhancements, including a status message in the sidebar to indicate why a break was skipped etc, the ability to schedule and exclude breaks using calendar events, support for Monterey focus, an option to hide the Pause function, new break options to pause or reset an individual break, and much more.

Read on for details.

Added a status message to the breaks in the sidebar

  • The break items in the sidebar now display a status message, e.g. to indicate that the break has been postponed or skipped.

  • When a break is skipped or postponed due to an app exclusion, the app name is included.

  • So if you ever wonder why a break didn’t occur as expected, look at this status message.

Sidebar

Added the ability to schedule breaks using calendar events

  • A new Calendar option is now available in the From pop-up menu on the Break Schedule page.

  • If chosen, a pop-up menu of your calendars, and a field to filter on event text is displayed.

  • The first time this is chosen, the app will prompt for permission to access your calendars.

  • When using this option, Time Out will look at the specified calendar for events containing the specified text, and start a break at the start of the event, and finish at the end.

  • If the event text filter field is left blank, all events will be used; specify something else to use the same calendar for multiple breaks.

  • Multiple values can be entered in the filter field, separated by commas, e.g. “break, lunch, snack”.

  • A reload button is available to reset the due date, if you edit the events.

  • Since the calendar controls the duration, frequency, and availability of the break, those controls are disabled.

  • This feature is available as a reward for current supporters; others can try it for an hour at a time.

Calendar schedule

Added an Exclusions option to skip breaks when busy on the calendar

  • A new Also skip breaks during calendar events option is now available on the Exclusionspage.

  • If chosen, a pop-up menu of your calendars, and a field to filter on event text is displayed.

  • The first time this is chosen, the app will prompt for permission to access your calendars.

  • When using this option, Time Out will look at the specified calendar for events containing the specified text, and skip a due break if it would fall within an event.

  • As with calendar scheduling, if the event text filter field is left blank, all events on that calendar will be used; specify something else to only skip some of the events.

  • Multiple values can be entered in the filter field, separated by commas, e.g. “meeting, 1-on-1, planning”.

  • This feature is available as a reward for current supporters; others can try it for an hour at a time.

Calendar exclusion

Support for Monterey focus

  • Renamed the Exclusions option to skip breaks during Do Not Disturb to focus, Apple’s new name for it in Monterey.

  • The first time this option is enabled, the app will prompt to get permission to look at the focus state.

  • If declined, you can enable it via System Preferences ▸ Security & Privacy ▸ User Availability.

  • This feature will still work with the old Do Not Disturb state from previous macOS versions.

Focus exclusion

Added an Advanced option to hide the Pause function

  • Sometimes it can be very difficult to resist the temptation to pause Time Out to avoid breaks, even though you know you shouldn’t.

  • So for people who don’t want the Pause function, there is now an option on the Advanced page to hide it.

  • This feature is available as a reward for current supporters; others can try it for an hour at a time.

Hide pause

New break options to pause or reset an individual break

  • Added a Pause Break or Resume Break command to the break options menus. So a break can be paused independent of other breaks.

  • The Pause Break menu item can be chosen to pause indefinitely, or choose a shorter time from the submenu.

  • This is of course not included if the new Advanced option to hide pause is active.

  • Also added a Reset Break command to these menus. This will start the work period again from now, just for this break.

Pause

But wait, there’s more!

  • Fixed the Flash Screen break action on Apple silicon Macs. It now uses the built-in screen flash, so doesn’t have color or duration options.

  • Fixed the Fadeout Sound break action not showing the fade out time interval field.

  • Updated the Stop Screensaver break action script.

  • Breaks due on future days are no longer adjusted when having a natural break (idle).

  • When resetting a From: Fixed Time break, the next due time now respects the fixed time.

  • Break names are now cleaned up to avoid invalid characters that can cause saving the break to fail.

  • Updated the Exclusions to remove DVD Player, and change FaceTime, Photo Booth, and QuickTime Player to include “System” in their paths.

  • For new folks, the exclusions for Zoom are now When Frontmost, to avoid a common support query. Existing data is not changed, in case you like them When Open.

  • The Pause All Breaks menu item can now be chosen to pause indefinitely, instead of needing to choose that from the submenu.

  • When paused indefinitely, the status item text now shows “–“.

  • Improved the highlighting of the status item rows.

  • Hidden a couple of rarely-used diagnostic logging options.

  • Fixed a performance issue where the app could use more CPU than it should in some unusual circumstances.

  • Time Out now requires a minimum of macOS Catalina (10.15).

Want to try it?

If you are using the Mac App Store edition, you can update via the App Store app.

Similarly, if you are using the Setapp edition, it will handle that update for you.

If you are using the direct edition, you can use the Check for Updates feature in the app to update.

Otherwise, download Time Out 2.9 now!