Skip to content

zeitlings/alfred-calendar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

29 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation


Alfred Calendar++

GitHub Release

A feature-rich block calendar workflow with Apple Calendar integration to view, create, and search calendar events, or to check your upcoming agenda.

Setup

  1. Install the SF Pro font from Apple to see the icons
  2. Ensure Alfred has permission to access calendar events1

How to Use

Activate the workflow with the keyword (default: cc) or by using the Hotkey. Quick access keywords for the agenda, creating new events, and the global search are derived from the keyword by appending a, n, or s: cca, ccn, ccs.

Block Calendar

  1. Type
  • the name of a month or year to jump to that month or year2
  • < or > to step through the months
  • ! to see available !bang expansions
  • ? to see the internal configuration
  1. Week Row
  • ↩ to open a selected week in the Calendar app if no events are found
  • ↩ to open the week view listing available events of a selected week
  • ⌘ to view the number of events scheduled for a selected week
  • βŒ˜β†© to open a selected week in the Calendar app

Week View

  1. Type to filter events based on your query
  2. On Weekdays
  • ↩ to open the selected weekday in the Calendar app
  1. On Calendar Events
  • ↩ to open the selected event in the Calendar app
  • βŒƒ to view the exact time of the event or the timeline representation
  • βŒ₯↩ to open a location in Google Maps or join a video call
  • βŒ˜β†© to create a new event after the selected event
  • fn↩ to open a URL associated with the selected event
  • ⌘L to view the digest of a calendar event's info as Large Type
  • ⌘Y (or tap ⇧) to Quick Look preview a location on Apple Maps or a URL associated with the event

Agenda

Quick access keyword: cca

  1. Type to filter upcoming events based on your query
  2. On Calendar Events
  • ↩ to open the selected event in the Calendar app
  • βŒƒ to view the exact time of the event
  • βŒ₯↩ to open a location in Google Maps or join a video call
  • βŒ˜β†© to create a new event after the selected event
  • fn↩ to open a URL associated with the selected event
  • ⌘L to view the digest of a calendar event's info as Large Type
  • ⌘Y (or tap ⇧) to Quick Look preview a location on Apple Maps or a URL associated with the event

New Event

Quick access keyword: ccn

  1. Type to specify the new event.
  • < or > to modify the day
  • + or - to modify the time3
  • (note) to add a note
  • (@location) to add a location
  • (=calendar) to specify a calendar
  • (!title) to ensure that some text is registered only as title
  • !allday to create an all day event
  • https://example.com to add a URL to the event
  1. βŒ₯ to view the cheat sheet
  2. ⌘L to view the info of the new calendar event as Large Type

Note

Date information is automatically parsed from natural language

Search Mask

Quick access keyword: ccs

Type to find events based on your query.

Note

The target time frame is one year: Half a year in the past, half a year in the future.

Symbol Key

  • The event has a URL or the note contains URLs
  • The event has a note
  • The event has attendees
  • The event has a location
  • The event is a recurring event
  • An online meeting is associated with the event

Configuration

After you make changes to the configuration, you need to clear the cache for the changes to take effect immediately. You can view the internal configuration via cc ?.

Acknowledgements

Footnotes

  1. If the access problem persists, try dragging the calpp executable into the list of apps with access (see #2). ↩

  2. For example, cc jan 2025 <<< reveals the block calendar for October 2024. ↩

  3. Only + and - symbols at the very beginning or end will be considered to ensure their normal use everywhere else. ↩