This document describes each screen of Tyme 2 for Mac and iOS. If you have a specific issue please check the FAQ.  If you encounter bugs or have any problems please don’t hesitate to contact us.

First steps

In order to track your working times it is mandatory to create at least a project and a task in the ‚Projects‘ view. Categories (e.g. Client xy) and ‘subtasks’ are optional, but may be helpful managing your project list.

  • Mac: Right click anywhere and select ‘Add category’ or ‘Add project’ and then ‘Add task’.
  • iOS: Touch the button ‘+Category’ or  ‘+Project’ and then swipe the project to the left, touch the ‘+’ icon and select ‘Add task’.

After you created a task you can start tracking your time by pressing ‘play’.

Happy tracking!

The Main Navigation

The Right Click Menu

At almost every screen of Tyme you find all the important options in the right click menu.

For those who don’t use the right click, all these options are also available via your Macs menu bar.

On iOS there are several gestures to access your options: e.g swiping to the left or to the right or pulling down from the top. 


 The project list

The project list shows all your current projects. Tyme offers categories, projects, timed tasks, subtasks, mileage tracking and expenses to track your work, but you don’t have to use the entire hierarchy. This is also the place where you start and stop a timer.

Mandatory: When you first start Tyme the project list will be empty. Start by creating a category (e.g. Client xy) or a project.


Create & edit – Categories (e.g. Client xy) can be used to cluster your projects. Categories are sorted alphabetically.

On your Mac create a category by right clicking and select  ’Add category’On iOS pull the list down and select ’+ Category’.


Create & edit – Projects are used to group tasks.

On your Mac create a project by right clicking and select ’Add project’. On iOS swipe the project to the left, touch the ’+’ icon and select ’Add project’.

  • Default hourly rate All tasks that you create within this project will have that rate pre-filled, but can change the hourly rate for each task individually if needed.
  • If you have a planned budget or a planned time for your project, set it here.
More right click options:
  • Show revenue – Use this option to display revenue instead of time and vice versa.
  • Sort projects & tasks by – Choose between different sorting options or choose custom to sort by yourself using drag’n’drop’. On your Mac just drag a project or task anywhere you like. On iOS hold the finger still over a project or task until it “pops” out of it’s row.
  • Duplicate tasks into new project – This option duplicates the selected project and all its tasks and copies them to a new project. This way you can use projects as templates.
  • Archive – Projects can be archived. If you archive a project, it is removed from the active project view. The project is visible in the archive where you can un-archive it if needed. On iOS swipe the project to the right and touch the “✔︎” icon.
  • Archive completed tasks – This option moves completed tasks of this project to the archive. If you have an ongoing project with many tasks, this option can be useful to clean up your project view.


Create & edit – Tasks are used to track the time while you work.

On your Mac create a task by right clicking a project and select ’Add task’On iOS swipe the project to the left, touch the ’+’ icon and select ’Add task’.

  • Billable / Non billable – Each task can be set ton ‘billable’ or ‘non-billable’. Non-billable tasks and time entries have a striped background.
  • You can set a due date, change the hourly rate or set the planned time. Set the rounding type and method.
More right click options:
  • Mark as competed – If you’re done with a task, mark it as completed. The task is still visible until you select ‘archive completed tasks’ for your project. On iOS swipe the project to the right and touch the “✔︎” icon.
  • Geofencing on iOS: You can set up an automatical tracking for a task when entering a certain location (e.g. your workplace). Set an address and a radius. The timer will start automatically as soon as you enter that area and stop when you exit it. Tip: Don’t set the radius too small, GPS won’t work well inside buildings, so the radius should cover at least some wall-free area.


Create & edit – Maybe it’s necessary to split your tasks into subtasks. Perhaps your task is ’Screen Design’, but you want to be more precise, e.g. define subtasks like ’Homepage’ or ‘Subpage’, etc.

On your Mac create a subtask by right clicking a task and select ’Add subtask’On iOS swipe the task to the left, touch the ’+’ icon and select ’Add subtask’.


Create & Edit – If you have expenses that are related to your project, you can enter them here. Set the price, the quantity and the purchase date.

On your Mac create an expense by right clicking a project and select ’Add expense’On iOS swipe the project to the left, touch the ’+’ icon and select ’Add expense’.

Mileage tracking:

Create & Edit – Set your kilometer or mileage rate and give the task an name. After creating a mileage tracking task you can add trips to it, just like adding time entries to regular tasks.

On your Mac add a mileage tracking task by right clicking a project and select ’Add mileage tracking’On iOS: Swipe the project to the left, touch the ’+’ icon and select ’Add mileage tracking’.

  • Note: Automatic mileage tracking is only available on iOS. On your Mac you’re only able to add trips manually.


 The time entry list

Use the time entry screen to see the times you’ve tracked each day. You can add, editor delete entries. If you forgot to track your time, have a look at what’s missing and create an entry manually.

On your Mac: Right click and choose ’Add time entry‘ or ’Add mileage record‘iOS: Scroll up the list and touch ’+ Entry’.

  • Changing the time period – On your Mac choose between year, month, week, day or a custom time frame by using the top left drop down menu or arrow buttons.
  • Mark as billed / paid – You can mark all entries as billed (e.g. when exporting your data). Use the ’billed’ filter to see what’s billed and what’s not. You can mark mark entries as billed / paid by selecting them, then right click and choose ‘mark as paid / billed’. The billed or paid sums per task or project are visible in the project view when revenues are shown.

Note for iPhone: Billing information and notes are only visible in landscape mode (Rotate your iPhone by 90 degrees).


 The statistics view

The statistics screen functions as a review of your time spent on tasks. See how much money you’ve made. Analyse your workload and plan your next weeks.

  • Changing the time period viewOn your Mac choose between year, month, week, day or a custom time range by using the top left drop down and arrow buttons.

    On iOS: Open the filter menu (the top right ‘looking glass’ icon) to select the time range. Then swipe the screen from right to left or left to right to switch to the next or previous time frame.
  • Main chart – This chart displays all recorded times for the selected time frame. When you don’t have a filter active, the chart displays the total for each project for each day. If a filter is active, individual tasks are displayed. Hover / touch over a row to see the respective sum.
  • Breaks chart – This chart displays the total number and duration of breaks you’ve taken each day. A gap between two time entries that is at least one minute and max. two hours long is considered as a break. Use it to monitor your efficiency and workload.
  • Total hrs worked – Displays the total of worked hours for the selected time frame, broken down to individual projects or tasks.
  • Hrs per day – The average hours you’ve worked per day.
  • Breaks per day – The average duration of breaks you’ve taken per day.
  • Worked days – The total number of worked days.
  • Total overtime – How much overtime did you work? Please Note that under worked days are counted against the overtime days.
  • Your average work hours – When did you start and stop working?
  • Started / finished tasks – The number of started and finished tasks.
  • Non billable hours – The total hours of all non billable tasks you’ve worked on.
  • Traveled distance – The total distance you’ve traveled.
More right click options:
  • Show forecast – If you’ve set a deadline for your projects or tasks, you’ll see the estimated workload that is left for each day until your deadline. Note that the forecast only shows up for the month or week date range.
  • Show revenue – Use this option to display revenue instead of worked times.
  • Show tasks – When enabled, the statistic drills deeper and shows tasks instead of projects.


 The archive

Projects can be archived. If you archive a project, it is removed from the active project view. The project is visible in the archive where you can un-archive it if needed.

On your Mac right click the archived project and select un-archive. On iOS swipe a project to the right and touch the ‘un-archive’ icon.


 Import (macOS only)

You can import data from the following sources into Tyme:
Choose to merge all data or replace the existing data with the imported data. To view the AppleScript commands that are supported by Tyme, start the AppleScript Editor, then drag onto the editor’s dock icon.



You can export your data in different formats with various options. If you just need a time sheet for your client you can generate a simple PDF file. If you want to process the data in other programs choose CSV or JSON as export format. If you want to do it your way you can use AppleScript to write your own exporter. To view the AppleScript commands Tyme supports, start the AppleScript Editor, then drag onto the editor’s dock icon.

You can also export the Tyme 2 database as a backup file.




  • Allow multiple timers – This option will enable more than one timer at a time.
  • Launch Tyme at login (macOS) – Launches Tyme right after booting up your Mac.

Tracking Mode

  • Slot – For each timer, a new time entry including start- and end times is created.
  • Cluster – Recorded times of the same task are merged into one sum per day.

Menubar (macOS)

  • Show running time – Displays the elapsed time of the current running task.
  • Show daily total – Displays the total of worked hours for today.
  • Show active task – Displays the name of the active task


  • Deadlines, times & budgets – Shows notifications if you’re about to hit a deadline, your planned hours or your remaining budget.
  • Working day start & stop – Shows notifications if no timer is active or if a timer is still active after your regular working day has ended. No need to specify your regular working day – Tyme learns your habits.

Show Tyme in … (macOS)

  • Dock & Menubar – Displays Tyme in the Dock and the Menubar.
  • Menubar only – Displays Tyme only in the Menubar. Note that Tyme is not visible in the task manager (⌘+Tab) when you user this option.
  • Dock only – Displays Tyme only in the dock and hides it in the Menubar.

Idle timeout after … (macOS)

You can set an ‘idle timeout’ in case you don’t use your Mac for a while. Tyme then offers you the following options when you get back (popup dialog):

Note dialog

You can add notes to your time entries when you start or stop tasks.


  • Working day length – Specify your working day length. That information is used in the statistics to give you insights about your workload.
  • Number of working days – Specify the number of working days per week. That information is used in the statistics to display your current and forecasted workload.
  • Time format – Choose between different time format options.
  • Currency – Choose the currency that should be displayed all over Tyme.

Hotkeys (macOS)

You can set your own additional hotkeys for a couple of actions.

  • Show Tyme – Shows Tyme’s main window.
  • Show Menu – Show Tyme’s menubar.
  • Start / stop last task – Starts or stops the timer for the last used task.
  • Edit notes on active task – If a timer is active, this hotkey lets you edit the notes for the running time session.


Cloud Sync – Tyme can sync your data across your devices. You can choose between iCloud or Dropbox for syncing.

The iCloud sync uses the latest CloudKit technology from Apple, which means that changes will be pushed to your devices in the background. So everything is always up to date. When you choose Dropbox, the sync will trigger at defined intervals.

  • iCloud – To enable the iCloud sync, you have to be logged in into iCloud on your Mac or on your iOS device and activated ’Documents & Data’ for Tyme 2 in iCloud Drive. You can verify the current settings in your System preferences > iCloud > iCloud Drive > Tyme 2.
  • Dropbox – To enable Dropbox sync, you need to have a Dropbox account which has some free storage space. You can create a free account here.
  • Calendar Sync – Tyme can also sync time records to your calendar. A new calendar named ’Tyme 2’ will be created to store the events. You can also drag events around or edit notes. Tyme will sync your changes back to your time entries.

Plugins (macOS)

GrandTotal – If you want to sync your recorded times to the popular accounting app GrandTotal and create bills there, you can activate the sync by clicking ’activate’. Download the Tyme-GrandTotal plugin here and install it by double clicking the installer in the Finder. In ’GrandTotal’ you’ll see a ’Tyme’ section in the left column on the overview page.