Skip to content

mrrsm/alfred-gcal

 
 

Repository files navigation

Google Calendar for Alfred

View Google Calendar events in Alfred.

Download & installation

Grab the workflow from GitHub releases. Download the Google-Calendar-View-X.X.alfredworkflow file and double-click it to install.

Usage

When run, the workflow will open Google Calendar in your browser and ask for permission to read your calendars. If you do not grant permission, it won't work.

You will also be prompted to activate some calendars (the workflow will show events from these calendars).

  • gcal — Show upcoming events.
    • <query> — Filter list of events.
    • — Open event in browser or day in workflow.
    • ⌘↩ — Open event in Google or Apple Maps (if event has a location).
    • / ⌘Y — Quicklook event details.
  • today / tomorrow / yesterday — Show events for the given day.
    • <query> / / ⌘↩ / / ⌘Y — As above.
  • gdate [<date>] — Show one or more dates. See below for query format.
    • — Show events for the given day.
  • gcalconf [<query>] — Show workflow configuration.
    • Active Calendars — Turn calendars on/off.
      • — Toggle calendar on/off.
    • Workflow is up to Date / An Update is Available — Whether a newer version of the workflow is available.
      • — Check for or install update.
    • Open Documentation — Open this page in your brower.
    • Get Help — Visit the thread for this workflow on AlfredForum.com.
    • Report IssueOpen an issue on GitHub.
    • Clear Cached Calendars & Events — Remove cached data.

Date format

The keyword gdate supports an optional date. This can be specified in a number of format:

  • YYYY-MM-DD — e.g. 2017-12-01
  • YYYYMMDD — e.g. 20180101
  • [+|-]N[d|w] — e.g.:
    • 1, 1d or +1d for tomorrow
    • -1 or -1d for yesterday
    • 3w for 21 days from now
    • -4w for 4 weeks ago

Configuration

There are a couple of options in the workflow's configuration sheet (the [x] button in Alfred Preferences):

Setting Description
APPLE_MAPS Set to 1 to open map links in Apple Maps instead of Google Maps.
CALENDAR_APP Name of application to open Google Calendar URLs (not map URLs) in. If blank, your default browser is used.
EVENT_CACHE_MINS Number of minutes to cache event lists before updating from the server.
SCHEDULE_DAYS The number of days' events to show with the gcal keyword.

Licensing & thanks

This workflow is released under the MIT Licence.

It is heavily based on the Google API libraries for Go (BSD 3-clause licence) and AwGo libraries (MIT), and of course, Google Calendar.

The icons are from Elusive Icons, Font Awesome, Material Icons, Weather Icons (all SIL) and Octicons (MIT), via the workflow icon generator.

About

View Google Calendar events in Alfred

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 84.7%
  • Shell 11.3%
  • HTML 4.0%