Skip to content
View Google Calendar events in Alfred
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
icons Add supports for multiple accounts. Closes #2 Jan 24, 2019
.gitignore
LICENCE.txt
README.md Add supports for multiple accounts. Closes #2 Jan 24, 2019
TODO.taskpaper Use Go modules Nov 9, 2018
account.go
alfredenv.sh
auth.go Add supports for multiple accounts. Closes #2 Jan 24, 2019
cmd_calendars.go
cmd_config.go
cmd_dates.go
cmd_dates_test.go Use local image generation instead of web service Jan 20, 2019
cmd_events.go
cmd_open.go
cmd_reload.go Keep day entries in schedule listing Jan 22, 2019
cmd_server.go Add supports for multiple accounts. Closes #2 Jan 24, 2019
cmd_set.go Add supports for multiple accounts. Closes #2 Jan 24, 2019
cmd_update.go
events.go
go.mod Add supports for multiple accounts. Closes #2 Jan 24, 2019
go.sum
icon.png
icons.afdesign
icons.go
info.plist
magefile.go Properly match calendars to accounts. Closes #11 Mar 7, 2019
magefile_alfred.go
magefile_images.go Use local image generation instead of web service Jan 20, 2019
magic.go Add supports for multiple accounts. Closes #2 Jan 24, 2019
main.go Add supports for multiple accounts. Closes #2 Jan 24, 2019
modd.conf Add event location to display. Closes #5 Jan 23, 2019
preview.html Use Go modules Nov 9, 2018
reload.png Animated reload spinner Jan 20, 2019
secret.go

README.md

Google Calendar for Alfred

View Google Calendar events in Alfred. Supports multiple accounts.

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). You can alter the active calendars or add/remove Google accounts in the settings using keyword gcalconf.

  • gcal — Show upcoming events.
    • <query> — Filter list of events.
    • — Open event in browser or day in workflow.
    • ⌘↩ — Open event in Google Maps 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.
    • Add Account… — Add a Google account.
      • — Open Google login in browser to authorise an account.
    • your.email@gmail.com — Your logged in Google account(s).
      • — Remove account.
    • Open Locations in Google Maps/Apple Maps — Choose app to open event locations.
      • — Toggle setting between Google Maps & Apple Maps.
    • Workflow is up to Date / An Update is Available — Whether a newer version of the workflow is available.
      • — Check for or install update.
    • Open Locations in XYZ — Open locations in Google Maps or Apple Maps.
    • — Toggle between applications.
    • 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 lists of calendars and events.

Date format

When viewing dates/events, you can specify and jump to a particular date using the following input 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
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.
APPLE_MAPS Set to 1 to open map links in Apple Maps instead of Google Maps. This option can be toggled from within the workflow's configuration with keyword gcalconf.

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 or based on Font Awesome and Weather Icons (both SIL).

You can’t perform that action at this time.