FullScreenNotification

A macOS menu bar app that monitors your Google Calendar and displays full-screen notifications for upcoming events.

Features

• Full-screen alerts — immersive overlay notification with event details and a countdown timer
• Google Calendar integration — connects via OAuth 2.0, polls for events every 30 seconds
• Configurable timing — trigger notifications 1–15 minutes before events
• Video call quick-join — detects Google Meet links and opens them in one click
• Menu bar UI — lightweight, runs without a dock icon

Setup

Prerequisites

• macOS 15 (Sequoia) or later
• Xcode 16+
• XcodeGen
• A Google Cloud project with the Calendar API enabled

Google OAuth credentials

1. Go to the Google Cloud Console
2. Create an OAuth 2.0 Client ID (choose iOS/macOS as the application type)
3. Note your client ID — it looks like 123456789-abcdef.apps.googleusercontent.com

Build

# Clone the repo
git clone https://github.com/YOUR_USERNAME/full-screen-notification.git
cd full-screen-notification

# Create your local config
cp project.local.example.yml project.local.yml

Edit project.local.yml with your values:

targets:
  FullScreenNotification:
    settings:
      base:
        DEVELOPMENT_TEAM: YOUR_TEAM_ID
        GOOGLE_CLIENT_ID: YOUR_CLIENT_ID.apps.googleusercontent.com
        GOOGLE_REDIRECT_SCHEME: com.googleusercontent.apps.YOUR_CLIENT_ID

Then generate the Xcode project and build:

xcodegen

# Build from the command line
xcodebuild -project FullScreenNotification.xcodeproj -scheme FullScreenNotification build

# Run
open ~/Library/Developer/Xcode/DerivedData/FullScreenNotification-*/Build/Products/Debug/FullScreenNotification.app

# Or open in Xcode and hit Cmd+R
open FullScreenNotification.xcodeproj

License

MIT