explaingit

damascenorafael/reminders-menubar

★ 3,771SwiftAudience · generalComplexity · 1/5LicenseSetup · easy

TLDR

A small open-source macOS app that puts your Apple Reminders in the menu bar so you can add, check off, and browse tasks with one click, no need to open the full Reminders app. Syncs with iCloud automatically.

Mindmap

mindmap
  root((reminders-menubar))
    What it does
      Menu bar reminders
      Natural language dates
      iCloud sync
    Features
      Browse reminder lists
      Create and edit tasks
      Upcoming view
    Install options
      Homebrew
      ZIP download
    Audience
      Mac users
      Productivity fans
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Add and check off Apple Reminders directly from the macOS menu bar without switching to the full Reminders app.

USE CASE 2

Create a reminder with a natural language due date like 'next Monday' by typing it directly in the menu bar interface.

USE CASE 3

Keep reminders in sync across your Mac, iPhone, and iPad automatically through the existing iCloud Reminders account.

USE CASE 4

Filter your reminder list by a specific list or completion status to focus on what matters right now.

Tech stack

SwiftmacOSiCloud

Getting it running

Difficulty · easy Time to first run · 5min

Requires macOS Big Sur 11 or later and granting Reminders access permission on first launch.

GPL v3.0, you can use, modify, and share this app freely, but any changes you distribute must also be released under GPL v3.

In plain English

Reminders MenuBar is a small macOS application that lives in your menu bar and gives you quick access to your Apple Reminders without opening the full Reminders app. It syncs directly with Apple's own Reminders system, so anything you create or change here shows up in the Reminders app and on any other Apple device where your account is signed in through iCloud. From the menu bar icon, you can browse your reminder lists, create new reminders in any list, and set due dates by typing natural language like "tomorrow" or "next Monday" rather than picking from a calendar picker. You can mark reminders as done or undo that marking, edit the text, delete them, or move them from one list to another. There is also a dedicated view for upcoming reminders so you can see what is due soon at a glance. The list view can be filtered by reminder list or by completion status. The app requires macOS Big Sur (version 11) or later. You can install it through Homebrew with a single terminal command, or download a zip from the GitHub releases page and drag the app into your Applications folder. On first launch, macOS will ask for permission to access your reminders, because the app reads from and writes to the same reminders database the built-in Reminders app uses. The permission can also be managed later through System Settings under Privacy and Security. The interface is available in 19 languages, including English, French, German, Japanese, Korean, Portuguese, Spanish, and others. The project is open source under the GNU General Public License version 3.0.

Copy-paste prompts

Prompt 1
How do I install Reminders MenuBar on macOS using Homebrew and grant it permission to access my Apple Reminders?
Prompt 2
How do I create a reminder with a due date in Reminders MenuBar using natural language like 'tomorrow at 9am'?
Prompt 3
Can I use Reminders MenuBar to move a reminder from one list to another? Show me how.
Prompt 4
How does Reminders MenuBar sync with the built-in Apple Reminders app and my iPhone, do I need to set anything up?
Prompt 5
How do I filter the Reminders MenuBar view to show only incomplete tasks in a specific list?
Open on GitHub → Explain another repo

← damascenorafael on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.