# GCal Help

> Official help for GCal, the Google Calendar app for Mac by Soriian.

These guides cover GCal 4.0.0 for Mac.

GCal is a separate Mac app, not Google Calendar itself. The main Google Calendar window and the connected native agenda have separate setup steps. Feature availability depends on Basic, Classic, or Premium access; consult the purchase guides for the details.

These files contain the same instructions as the website. Each article links to its public HTML page for citation. Check the user’s app version before applying these instructions to an older installation. If the guides do not answer a question, contact [GCal support](mailto:contact@soriian.com).

## Getting started

- [Set up GCal on your Mac](https://soriian.com/help/getting-started/index.md): Open Google Calendar, connect your agenda, and choose how GCal fits into your day.
- [Understand GCal’s two calendar connections](https://soriian.com/help/web-calendar-vs-native-data/index.md): Learn why the Google Calendar window and GCal’s native agenda use separate sign-ins.
- [Use the menu-bar agenda](https://soriian.com/help/menu-bar-agenda/index.md): See upcoming events and tasks, create items, and open GCal from the menu bar.
- [Choose how GCal launches and keeps its window](https://soriian.com/help/window-and-launch-behavior/index.md): Control launch at login, Dock visibility, startup presentation, and window memory use.

## Calendars & accounts

- [Use multiple Google accounts](https://soriian.com/help/multiple-google-accounts/index.md): See events from different accounts in your agenda, or share a calendar into your main Google account.
- [Show iCloud calendars in GCal](https://soriian.com/help/icloud-calendars/index.md): Choose whether you want iCloud events in the native agenda or inside Google Calendar.
- [Show Outlook calendars in GCal](https://soriian.com/help/outlook-calendars/index.md): Choose whether you want Outlook events in the native agenda or inside Google Calendar.
- [Choose which calendars appear](https://soriian.com/help/choose-calendars/index.md): Understand the three places that control which calendars you see.
- [Allow access to calendars on this Mac](https://soriian.com/help/calendar-permissions/index.md): Grant or recover macOS calendar permission for iCloud, Outlook, Exchange, and other system accounts.

## Make GCal yours

- [Change colors and backgrounds](https://soriian.com/help/appearance/index.md): Choose an accent color, use a built-in background, or add your own images.
- [Use Google Calendar enhancements](https://soriian.com/help/calendar-enhancements/index.md): Personalize calendar views, check availability, and duplicate events with optional enhancements.
- [Add and configure widgets](https://soriian.com/help/widgets/index.md): Keep a calendar or agenda in Notification Center, or on your desktop.
- [Customize the Dock icon](https://soriian.com/help/dock-icon/index.md): Keep the date visible and choose a Dock style that suits your Mac.
- [Set up the browser extension](https://soriian.com/help/browser-extension/index.md): Bring GCal’s calendar appearance and selected enhancements into your browser.

## Everyday workflows

- [Create and switch Calendar Sets](https://soriian.com/help/calendar-sets/index.md): Save groups of Google calendars for work, family, or any other part of your day.
- [Use GCal with macOS Focus](https://soriian.com/help/focus-filters/index.md): Limit menu-bar events and notifications while a particular Focus is active.
- [Show Google Tasks](https://soriian.com/help/google-tasks/index.md): Connect your task lists and choose which tasks appear alongside your events.
- [Join meetings from GCal](https://soriian.com/help/meetings/index.md): Join your next call from the menu bar, an alert, a widget, Apple Shortcuts, or a connected AI assistant.
- [Use GCal with Apple Shortcuts](https://soriian.com/help/shortcuts/index.md): Open dates, switch views, apply Calendar Sets, or find and join your next meeting.
- [Use GCal with an AI assistant](https://soriian.com/help/ai-tools/index.md): Connect your assistant to check your schedule, find free time, prepare events, and more.
- [Add a weather forecast calendar](https://soriian.com/help/weather-calendars/index.md): Create a calendar subscription for the forecast in a city you choose.
- [Use notification actions and snooze](https://soriian.com/help/notification-actions/index.md): Open events, join meetings, email organizers, or snooze supported reminders.

## Troubleshooting

- [Find missing calendars or events](https://soriian.com/help/missing-calendars/index.md): Start with where the event is missing, then check the account, selection, and filters.
- [Fix empty or outdated widgets](https://soriian.com/help/widgets-not-updating/index.md): Check the agenda first, then the widget’s configuration and refresh state.
- [Fix missing notifications](https://soriian.com/help/notifications/index.md): Check GCal’s reminder settings, macOS permission, and the event’s own reminder.
- [Reconnect a Google account](https://soriian.com/help/reconnect-google-account/index.md): Renew a connection or grant missing permissions without removing the account first.
- [Troubleshoot Google Calendar website sign-in](https://soriian.com/help/web-calendar-sign-in/index.md): Resolve sign-in pages, authentication windows, and organization-managed login flows in the main calendar window.
- [Recover GCal calendar data](https://soriian.com/help/background-data-service/index.md): Understand and recover the background service used by native agenda features.

## Purchases & upgrades

- [Which features require Premium?](https://soriian.com/help/premium-features/index.md): Understand what is included with Basic, Classic, and Premium access.
- [Upgrade from Classic to Premium](https://soriian.com/help/classic-to-premium/index.md): Understand your existing paid-app access and where to find your upgrade options.
- [Restore missing Premium or Classic access](https://soriian.com/help/purchase-not-recognized/index.md): Refresh App Store verification when a subscription, lifetime purchase, or previous paid-app purchase is missing.
- [Understand GCal data and AI access](https://soriian.com/help/privacy-and-data/index.md): See which services hold calendar data and what a connected AI assistant can request.