# Pandan

Time awareness in your menu bar. Price: Free. Platforms: macOS. Get it from: [App Store](https://apps.apple.com/app/id1569600264). Requires macOS 26 or later. Free older versions for macOS 15, 14, 13, 12, and 11: [download](https://sindresorhus.com/pandan#older-versions). Version 1.18.1, released September 11, 2026. Install it from the terminal with [mas](https://github.com/mas-cli/mas): `mas get 1569600264`, or with this line in a Brewfile: `mas "Pandan", id: 1569600264`. Bundle identifier of the App Store version: `com.sindresorhus.Pandan`.

URL: https://sindresorhus.com/pandan

Pandan shows in the menu bar how long you have been actively using your computer, so you know when it is time to take a break.

It notices when you step away: by default, a session ends after 10 minutes without the keyboard or the mouse. The menu bar shows the time of the current session or the total of today, with or without an icon *([guide](https://sindresorhus.com/guides/mac-usage-time-today.md))*.

It can also give you a gentle reminder at an interval you choose: a popover, a notification, a HUD, or only a change of the menu bar icon, with an optional sound, haptic feedback, or a shortcut that runs.

The “History” window (in the menu) shows your sessions of the last 120 days. Click the “…” button in it to add a session that Pandan did not see, like a meeting away from your Mac, or to export the history as CSV or JSON. Right-click a session to delete it.

## Frequently Asked Questions

### I have a feature request, bug report, or some feedback

Click the feedback button in the app or [send it here.](https://sindresorhus.com/feedback?product=Pandan&referrer=Website-FAQ)

### The app does not show up in the menu bar

[How to make the app show up in the menu bar](https://sindresorhus.com/apps/faq#app-not-showing-in-menu-bar)

### The app randomly quits

If there is no [crash report](https://sindresorhus.com/apps/faq#crash-report), macOS most likely quit the app to free up memory or disk space. Keep at least 10–20 GB of free disk space, and do not use tools that “free up purgeable space”, like CleanMyMac, as they make macOS quit apps too. A restart of the computer can also help. This is a [common problem for macOS apps](https://bitsplitting.org/2022/06/18/purgeable-mac-apps/).

### The menu bar item looks blurry or is not dimmed on my secondary display

[See this answer](https://sindresorhus.com/apps/faq#menu-bar-secondary-display)

### The timer stops while I am on a video call

Pandan knows that you are active from the keyboard and the mouse. If you only listen and talk on a call, it thinks that you are away. In the settings, set “End active session” to “only when Mac is locked or sleeping”. Or increase the “End session when idle for” setting, so a long call does not end the session.

### Can you make the history be further back than 120 days?

The history is intentionally limited. Pandan is about time awareness right now, not analyzing past behavior. If you need more stats and graphs, check out the system [Screen Time](https://support.apple.com/guide/mac-help/set-up-screen-time-for-yourself-mchle4e2edfe/mac) feature.

### Can you make the app available on iOS too?

This is unfortunately not possible as iOS does not let an app continuously check whether the user is idle.

### How can I play a custom sound as a notification?

Make a [shortcut](https://support.apple.com/guide/shortcuts-mac/intro-to-shortcuts-apdf22b0444c/mac) that uses the [`Play Sound` action](https://www.icloud.com/shortcuts/9cfae8edd2dd48f3bf318a3d825b1212) (shortcut “Play Custom Sound”) and then select that shortcut in the Pandan settings.

If you have my [Dato app](https://sindresorhus.com/dato.md) installed (even the free trial), you could use one of the sounds it provides. Find the `Get Sound` action. [Example](https://www.icloud.com/shortcuts/2bf58f1c90134803a4765745f54794f6) (shortcut “Play Goose Sound”)

### How can I show an alert as a notification?

Same as the above, but use the `Show Alert` action instead.

You could also use the “Flash Screen” action from the [Actions app](https://sindresorhus.com/actions.md) to momentarily flash the screen.

### How can I run multiple shortcuts as a notification?

Pandan lets you run a single shortcut as a notification, but a shortcut can run other shortcuts. So make the shortcuts you want to run, make another shortcut that uses the “Run Shortcut” action to run the other shortcuts, and then select this shortcut in Pandan.

### How can I use this as an eye-break reminder?

Set Pandan to [remind you to take a break](https://sindresorhus.com/guides/break-reminder-mac.md). Make a shortcut in the Shortcuts app that uses the “Wait” action and set it to the wanted duration of the break. After this action, you can either add a “Play Sound” or “Show Alert” action to notify you when the break is done. Then select this shortcut in the Pandan settings.

### How can I disable Pandan while using certain apps?

You can use the Shortcuts app for this. Make a shortcut that uses the “Set Enabled State” action that Pandan provides. Shortcuts automations can only run when an app opens or quits, so use the [Shortery](https://apps.apple.com/app/id1594183810) app to run this shortcut when certain apps become active or inactive.

*Note that Pandan already disables itself when you are inactive.*

### How can I show the total active duration today as a countdown?

Get the [“Pandan countdown” shortcut](https://www.icloud.com/shortcuts/fdf0cd45fedb4290bfe14d84a394b601) (requires the [Actions](https://sindresorhus.com/actions.md) and [One Thing](https://sindresorhus.com/one-thing.md) apps) and select it in the Pandan settings. The countdown will update every time Pandan shows a notification. If you want the countdown to update more often, use the [Shortery](https://apps.apple.com/app/id1594183810) app to run the shortcut at an interval.

### How can I start a new session from the command-line?

Make a [shortcut](https://support.apple.com/guide/shortcuts-mac/intro-to-shortcuts-apdf22b0444c/mac) that uses the `New Session` action and [run that shortcut from the command-line](https://support.apple.com/guide/shortcuts-mac/run-shortcuts-from-the-command-line-apd455c82f02/mac).

> [!TIP]
> Shortcuts can be a bit slow sometimes. You can use this command to have it not wait for the shortcut to finish running: `(&>/dev/null shortcuts run ShortcutName &)`

### Why is this free without ads?

I just enjoy making apps. Consider leaving a nice review on the App Store.

### Can you add sync?

No. iCloud sync is unreliable and causes a huge support burden. It’s not worth the effort for this app.

### Can you add another menu bar icon option?

Sure! Find an icon you like in the [SF Symbols app](https://developer.apple.com/sf-symbols/) or on [The Noun Project](https://thenounproject.com/icons/), and send me the name or a link.

### Can you localize the app into my language?

I don’t plan to localize the app.

## Scripting

Pandan comes bundled with actions for the built-in Shortcuts app which you can use to automate Pandan.

> [!TIP]
> You can [run shortcuts from the command-line](https://support.apple.com/guide/shortcuts-mac/run-shortcuts-from-the-command-line-apd455c82f02/mac).

### Use-cases

- [Play custom notification sound](https://sindresorhus.com/pandan#custom-notification-sound)
- [Use Pandan as an eye break reminder](https://sindresorhus.com/pandan#eye-break-reminder)
- [Show an alert as a notification](https://sindresorhus.com/pandan#alert-as-notification)
- Flash the screen as a notification by using the “Flash Screen” action from the [Actions app](https://sindresorhus.com/actions.md)
- [Show a web page as a notification](https://www.icloud.com/shortcuts/0e3914da016b446dbf2fef7aa0341567) (shortcut “Show Web Page”)
- [Lock the screen as a notification](https://www.icloud.com/shortcuts/a3aa4ba2640d4f1b97c85f498e9dd945) (shortcut “Lock Screen”)
- [Invert the screen for 20 seconds](https://www.icloud.com/shortcuts/0710b22b12b74ec1bad0f28b327412fd) (shortcut “Toggle Invert Screen”)
- [Make the screen gray for 20 seconds](https://www.icloud.com/shortcuts/dbdeea0a9a8b41749fa27f15cf3eb6c2) (shortcut “Toggle Grayscale”)
- [Show the total active duration today as a countdown](https://sindresorhus.com/pandan#countdown)

*And you can combine these too.*

## Older Versions

- [1.17.0](https://www.dropbox.com/scl/fi/fcejz5u34afpe9388ivw4/Pandan-1.17.0-macOS-15-1774711134.zip?rlkey=h07yv6twf0glm3u2gjdpkq78w&raw=1) for macOS 15+
- [1.16.0](https://github.com/user-attachments/files/19008473/Pandan.1.16.0.-.macOS.14.zip) for macOS 14+
- [1.15.0](https://github.com/sindresorhus/meta/files/14230031/Pandan.1.15.0.-.macOS.13.zip) for macOS 13+
- [1.13.2](https://github.com/sindresorhus/meta/files/11072195/Pandan.1.13.2.-.macOS.12.zip) for macOS 12+
- [1.9.1](https://github.com/sindresorhus/meta/files/8003835/Pandan.1.9.1.-.macOS.11.zip) for macOS 11+

## Non-App Store Version

A special version for users that cannot access the App Store. It won’t receive automatic updates. I will update it here once a year.

[Download 1.18.0](https://www.dropbox.com/scl/fi/z38d9ejud0mid9tlvk6ax/Pandan-1.18.0-1774710864.zip?rlkey=p73ny62ik1yif3pru812akfzm&raw=1)

*Requires macOS 26 or later*

## Guides

- [How to Get a Reminder to Take a Break on Mac](https://sindresorhus.com/guides/break-reminder-mac.md): See how long you have used your Mac in the menu bar, and get a gentle reminder to take a break, with the free Pandan app, or set a timer.
- [How to See How Long You Have Used Your Mac Today](https://sindresorhus.com/guides/mac-usage-time-today.md): Show the total time that you used your Mac today in the menu bar with the free Pandan app, or see a report of each app in Screen Time.