Skip to content

chrisgrieser/alfred-reminders-today

Repository files navigation

Alfred Reminders today

GitHub downloads Alfred Gallery downloads Version number

Display reminders due today, add new reminders, and show today's events.

Showcase

Table of contents

Usage

  • Display reminders due (or overdue) today via the keyword rem. Configure the hotkey for faster triggering.
    • : Complete the reminder.
    • ⌘⏎: If the reminder has a URL in title or notes, open it in the default browser. Otherwise, copy the reminder's title & notes to the clipboard. Afterward, complete the reminder.
    • ⇧⏎: "Snooze" the reminder by changing its due date to tomorrow.
    • ⌥⏎: Edit the reminders title and body in Alfred's Text View. The first line is the reminder's title, the remaining lines the notes.
    • ⌃⏎: Display completed reminders due today as well. Using on a completed reminder marks it as uncompleted. The other modifiers work the same as with uncompleted reminders. Use ⌃⏎ once more to hide completed reminders again.
    • ⌘C: Copy the reminder title & notes.
    • ⌘L: Display the reminder details in Large Type.
    • ⌘Y: Quick Look the URL, if there is one.
    • (on an event): If the location is a URL, open the URL. Otherwise, open the location on Google Maps or Apple Maps.
  • Quickly add a new reminder due today the keyword qq.
    • The command supports simple parsing of a due time with the format hh:mm or hh.mm at the start or end of the input.
      • For instance, 19:00 buy milk or buy milk 19.00 will set the due time to 19:00 and the reminder title to buy milk.
      • 12-hour time like buy milk 3:00pm or buy milk 3pm is also supported.
      • Alternative, you can specify a relative time like buy milk in 2h or in 2 minutes buy milk.
    • A priority can be specified by adding the respective number of ! at the start of end. For example, buy milk!! or !!buy milk will result in a reminder title buy milk with a medium priority (! = low, !! = medium, !!! = high).
    • You can use alternative keywords to create new reminders with other due dates:
      • qn no due date
      • q1 tomorrow
      • q2 in two days
      • qm next Monday
    • If the input is a bare URL, will move the URL to the reminder body and fetch the reminder title from the URL.
    • Configure the hotkey to create a reminder due today from the current selection.

Installation

Requirement: macOS 15 (Sequoia) or higher

➡️ Download the latest release of this workflow.

Troubleshooting

  • Xcode command line tools are required. Alfred automatically prompts you to install them, if they are not available on your device, but in case there are problems with that, you can install them manually via xcode-select --install in the terminal.
  • Alfred will automatically request access to you reminders. If there are issues with that, for instance if you manually removed access, you can re-grant access via System Settings > Security & Privacy > Reminders. (If you are including events, you need to enable access to the calendar as well.)
  • The workflow requires at least macOS 15 (Sequoia) or higher.

Limitations

Apple's EventKit API does not offer access to various Reminder metadata, which is why this workflow cannot support the following features:

  • The URL field of a reminder is not accessible, so only URLs in the title or notes are supported.
  • A reminder's tags, attachments, and flag-status are also not available.
  • The macOS Reminders widget shown at the notification center or desktop do not update when reminders are added or changed via this workflow.

iOS Shortcut for creating new task

You can use this shortcut to create a new task for today due today. Use it in the Share Sheet or simply run it from the Lock Screen or Control Center. ➡️ Download the shortcut

About the developer

In my day job, I am a sociologist studying the social mechanisms underlying the digital economy. For my PhD project, I investigate the governance of the app economy and how software ecosystems manage the tension between innovation and compatibility. If you are interested in this subject, feel free to get in touch.

If you find this project helpful, you can support me via 🩷 GitHub Sponsors.

About

Display reminders due today, add new reminders, and show today's events.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Contributors