>_ Home App Labs
Countdown Mini icon

Countdown widget for macOS

The days left. Right on your desktop.

Desktop widgets that count down to the dates you are waiting for.

A trip, a deadline, a birthday. Give each a date, a colour and an icon, and put it on the desktop. No account, no notifications, and not a single network request.

Download for Mac Source on GitHub

Countdown Mini is a Mac app. Send yourself the link and download it there.

Version 1.0.0 · Free · macOS 14 or later · Apple Silicon and Intel · How to install

Three Countdown Mini widgets: 19 days to a trip, 3 days to an exam, and a medium widget with a birthday in 7 days and a launch in 42
1·2·3
One widget, three sizesOne, two or three events, joined into one block.
M–F
Days your wayEvery day or working days only, with or without today.
0
Zero network requestsYour events are a file on your Mac.

Desktop widgets

Small, medium, large.

Small shows one event, medium two side by side, large three. Every widget has its own events: right-click it and choose Edit Widget.

Countdown Mini widgets in small, medium and large sizes, each event in its own colour

The large widget

Room for one, two or three.

With fewer events each one gets more room, so the widget is never half empty.

The large widget three times: with one event, with two and with three

Counting and looks

Every event its own.

Working days for a sprint, a ticking timer in the last 24 hours, and a colour you recognise from across the room.

Four small widgets: 19 days left, 7 working days left, a timer showing 5 hours 24 minutes, and 40 days to New Year

Also in the box

19 days
7 days

A bar that means something

It shows the time left on a scale you choose, so 19 days looks different from 7.

Gradients or a picture

20 gradients, two colours of your own, or a photo from your Mac.

⌘S

Nothing changes by accident

Edits reach the widgets when you press Save. Browsing your events never touches them.

125:24:00Today

Down to the last hour

Days first, a ticking timer in the last 24 hours of a timed event, then "Today".

events.jsonimages/

Your data, your Mac

One file in one folder. No account, no sync, no analytics.

Install

Download, allow once, add the widget.

Countdown Mini is free and not signed with a paid Apple developer certificate, so macOS asks you once to confirm that you trust it.

  1. Download Countdown-Mini.pkg and open it. macOS shows a warning. Click Done.
  2. Open System Settings, then Privacy & Security, scroll down and click Open Anyway.
  3. Run the installer. Countdown Mini lands in your Applications folder and opens. Add your first event and press Save.
  4. Right-click the desktop, choose Edit Widgets, search for Countdown Mini and drag a size onto the desktop.

See every step with pictures. Prefer no installer? Take Countdown-Mini.zip and move the app yourself, or build it from the source.

Questions and answers

Is Countdown Mini free?

Yes. It is free to download and use, with no in-app purchases, no subscription and no ads. The source code is public under the MIT licence.

Which Macs does it run on?

Any Mac with macOS 14 (Sonoma) or later, both Apple Silicon and Intel. There is no version for Windows, Linux, iPhone or iPad.

How do I put the widget on the desktop?

Open Countdown Mini once after installing. Then right-click the desktop, choose Edit Widgets, search for Countdown Mini, pick a size and drag it onto the desktop.

How do I choose which event a widget shows?

Right-click the widget and choose Edit Widget. There are three places: Event 1, 2 and 3. The small widget uses the first, the medium the first two, the large all three. Places you leave empty take the next events from your list.

Can I have several widgets with different events?

Yes. Add as many widgets as you like and choose the events for each of them separately.

Can it count only working days?

Yes. Each event counts either every day or Monday to Friday only, and you decide whether today is included. Public holidays are not known to the app and count as ordinary days.

What does the bar show?

The time left, on a scale you choose for the event: 7, 30 or 90 days, or a year. On the 30-day scale an event 15 days away fills half the bar, and the bar empties as the day comes closer.

I changed an event and the widget did not change. Why?

Edits reach the widgets when you press Save, or Command-S. Until then the event has an orange dot in the list. macOS may also take a few seconds to redraw a widget.

Why is the widget pale when a window is open?

macOS fades all desktop widgets while an app is in front, and shows them in full colour when you click the desktop. You can change this in System Settings, Desktop & Dock, Widgets.

After renaming an event, Edit Widget still shows the old name.

The widget keeps following the renamed event, and what it draws is up to date. Only the list in Edit Widget shows the name it was chosen by. Choose the event again there if you want the list to match.

Does it send notifications or sit in the menu bar?

No. It is a window for editing events and widgets for the desktop, nothing else: no notifications, no menu bar icon, no calendar import.

Does it need an internet connection?

No. The app makes no network requests. There is no account, no sync and no analytics.

Why does macOS say it cannot verify the app?

Apple shows that message for every app whose maker has not paid for a developer certificate. Countdown Mini is a free hobby project and is not signed that way. You allow it once in System Settings, Privacy & Security, with the Open Anyway button. The install guide shows each step.

Where is my data stored?

In the folder ~/Library/Application Support/Countdown Mini: the events as one JSON file, and scaled-down copies of the pictures you chose. Nothing is sent to Home App Labs.

Was it really made with AI?

Yes. The code was written by an AI coding assistant, directed, tested and used every day by a human. More about how the apps are made.

How do I report a problem or suggest something?

Use the Contact us button on this site: it opens a short form and needs no account, only an email address for the reply. If you prefer, open an issue in the GitHub repository.

More from the workbench

Other apps from Home App Labs

Same idea each time: one small job, done well, free and open source.

Contact us

What is it about?