General Usage

Time Sink has been designed to be both simple to use and yet powerful enough to show you exactly how you've been spending your time. With a simple double-click, Time Sink will start tracking your activities, and it won't stop until you quit the app (or stop using your Mac).

There are ways to suspend the timers, which will be covered elsewhere in Help. But in general, if Time Sink is running, it's tracking what you're doing.

Time Sink communicates with you through two windows: the Organizer window and the Reports window, which are both covered below. Time Sink can also be used as either a regular macOS app, or as a menu bar only app. Using Time Sink as a regular macOS app is straightforward, but there are some differences when using it as a menu bar app, so read through the section (in Settings) on menu bar mode as well, if you intend to use Time Sink in that mode.

 

Organizer Window

This is Time Sink's main window; it displays everything happening on your Mac, including summary data for foreground and total running time. Here's a look at that window, complete with some helpful explanatory notes.

Organizer window

Here are some of the ways you can interact with the Organizer window:

 

Combining Windows

Some apps append data to the filename that normally appears in a window's title bar. For example, Adobe's Photoshop app appends the current zoom level. Each time you change the zoom level, Time Sink will create a new entry in the Photoshop section, because the window's title has been changed. For example, if you look at one photo using three zoom levels, you'll see three entries in Time Sink:

This is probably not what you want, as it makes viewing total time spent in one document much harder. But Time Sink has a way to handle apps that do such title window renaming: You can create a window title filter to eliminate these duplicate entries.

To create a window title filter, right-click on the app's name in the Organizer window and select Set Window Title Filter from the pop-up menu. This will pop up the window filter dialog, which will initially be blank. You can fill in whatever text you like, which Time Sink will then use as a truncation point for that apps' windows.

For instance, to solve the above-noted Adobe naming issue, you'd put an at sign (@) in the Truncate at box, like this:

Window title filter

Click Done and Time Sink will check window names (in the selected app) only up to the @ sign, and merge identically-named (using the truncated names) windows.

For even more power, those who know regular expressions can build fancy find/replace queries to combine window titles using all sorts of complex pattern matching. Such exercises are left to the reader.

When you've set a window title filter, Time Sink will display a visual reminder of that in the Organizer view, via a small funnel to the right of the app name:

Filter in place

Each app can only have one window title filter.

 

Activity Report Window

The Activity Report window provides a graphical snapshot of your usage over a given period of time. (By default, the time period is the total duration of Time Sink's history.)

Here's what the Activity Report looks like in its default form, along with some explanatory notes.

Reports

The default format for the report is what Time Sink calls a Time Lapse view. The width of the window covers the time range that Time Sink knows about, and individual bars represent foreground (purple), background (gray), or untracked (black) periods of time for each app or window.

You can easily change this to a "timed used" view (which Time Sink calls Time Portions), and modify many other things about the Activity Report, if you wish. For more detail on how to do that (and more), read the Reports section of Help.

 

Menu Bar Mode

When using Time Sink in menu bar mode (set on the General tab of Time Sink's settings), there is no traditional File menu, and the app itself has no actual windows. Instead, when you click Time Sink's menu bar icon, the main Time Sink window will appear just below the menu bar:

Menu bar mode

The buttons at top left toggle between the Organizer and Activity Report views (Time Sink will open to your last-used view), and the gear icon at top right contains all of the menus needed to use Time Sink.

For instance, to export a report, you'd first click Activity Report, set the date range (if desired) at the bottom of the window, then click the gear icon. In the drop-down menu that appears, navigate to File > Export Snapshot, and you're done.

Similarly, if you decide you'd like to return to full app mode, click the gear icon, then choose Settings, and toggle the app mode in the General tab.

When in menu bar mode, the Time Sink window is attached to the menu bar, so it can't be moved. It can, however, be lengthened and resized by using the narrow strip at the bottom of the window. (The resize corner may be bottom left or bottom right, depending on the position of Time Sink relative to your other menu bar icons.)