Ticklet Support

Tracking Tasks

Ticklet lives in your macOS menu bar. Click the menu bar icon to open the task list, then type a task name into the 'Add a task' field, and press return or click the green plus button.

Creating a task starts timing it immediately. When you select another task, Ticklet stops the current task, saves its elapsed time, and starts the task you clicked.

Pausing and Resuming

Use the orange pause button to pause the active task. Click it again to resume the most recently paused task.

In the About and options window, you can turn on 'Pause when display locked or off' so Ticklet pauses automatically when your Mac display locks, sleeps, or turns off, then resumes when your display is active again.

Managing Tasks

• Review totalsEach task row shows its cumulative tracked time and when that total started or was last reset.
• Reset one taskRight-click a task and choose Reset Time to clear that task's cumulative total.
• Delete a taskRight-click a task and choose Delete Task to remove it from Ticklet.
• Reset all timersOpen the gear button and choose Reset all timers to clear every task total.
• Quit TickletUse the red power button when you want to quit the menu bar app.

CSV Export

Click the blue save button to export a CSV file. The file includes each task name, its start date/time, and its cumulative tracked time.

Ticklet remembers the folder you used for the most recent export and uses it again the next time you save a CSV.

AppleScript Interface

Ticklet can be controlled from AppleScript by automation tools, launchers, and other Mac apps. Commands are sent to the running Ticklet application. Here is an example of a script:

tell application "Ticklet"
    list tasks
    create task "Writing"
    set active task "Writing"
    pause timer
    start timer
    start timer "Reading"
end tell

Ticklet AppleScript Commands

• list tasks Returns task names as a list of text values, ordered the same way Ticklet presents them.
• create task "Name" Creates a task without starting it. If a matching task already exists, Ticklet reuses it and returns its name.
• set active task "Name" Switches to an existing task and starts timing it. The command returns the active task name.
• start timer Continues the active task, or resumes the most recently paused task. Ticklet reports an error if there is no active or paused task.
• start timer "Name" Starts timing the named existing task and returns the active task name.
• pause timer Pauses the current task. Ticklet reports an error if there is no active task to pause.

Automation Notes

Task-name matching is case-insensitive and diacritic-insensitive, and task names are trimmed when they are created.

AppleScript errors are returned when Ticklet is not ready, a required task name is missing, a named task cannot be found, or a timer command has no task to work with.

For Ticklet support, email Hexela with a short description of the issue and the macOS version you are using.

If you are reporting a bug, it helps to include what you expected to happen, what happened instead, and the steps you took before the problem appeared.

Before You Write...

• Menu bar icon missingCheck macOS menu bar spacing and any menu bar management apps.
• Task time looks wrongStop the current timer, restart Ticklet, and check the task again.
• App will not openConfirm Ticklet is in your Applications folder and that macOS allows it to run.