Is it time yet? user guide

"Is it time yet?" is a web application that displays countdown timers for your upcoming Google Calendar events. This guide will help you understand and use all the features of the application.

Landing page: https://isittime.app
App/Login page: https://isittime.app/web/

Table of contents

1. Getting started
2. Main interface
3. Event display
4. Countdown customization
5. Notifications
6. Room booking
7. Settings
8. Cloud sync
9. Security & privacy

Getting started

Signing in

1. Open "Is it time yet?" in your web browser at https://isittime.app/web/
2. Click the "Sign in with Google" button
3. Select your Google account
4. Grant all the required permissions

First-time setup

PIN creation (security)

After signing in for the first time, you'll be prompted to create a PIN:

• Your PIN must be at least 4 characters long
• You can use any characters (letters, numbers, symbols)
• This PIN encrypts your authentication data for security
• Important: If you forget your PIN, you'll need to re-authorize the app and create a new PIN

Calendar selection

1. After signing in, you'll see a list of your available calendars
2. Select which calendars you want "Is it time yet?" to display events from
3. You can change this selection anytime from the settings menu

Main interface

Event list

The main screen displays your upcoming calendar events in chronological order. Each event card shows:

• Event title (bold for upcoming/ongoing events)
• Countdown timer showing time until the event starts (or time remaining if ongoing)
• Event time (start and end times)
• Room information (if a room is booked)
• Calendar name (optional, can be shown/hidden in settings)
• Action buttons for meeting links and event details

Event states

Events are color-coded based on their proximity. Event cards have a white background by default, with colored tint overlays that appear as events approach:

• White background: Event is far in the future (beyond the countdown growth period)
• Blue tint: Event is upcoming (within the countdown growth period, but not yet in warning state)
• Yellow/Amber tint: Event is approaching (warning state)
• Red tint: Event is ongoing or overdue

The countdown text also grows larger and changes color as events approach, making them more prominent.

Event actions

Each event card has action buttons in the top-right corner:

• Info button (blue): Opens the event in Google Calendar
• Meeting link button (green/blue icon): Opens Google Meet, Zoom, or other video conference links
• Menu button (three dots): Opens a menu with additional options:
  • Info: View event details in Google Calendar
  • Book room: Book a meeting room for this event (if enabled)
  • Unbook room: Remove a booked room from this event
  • Fast room booking: Quickly book the first available room (if enabled)

Hiding events

• Swipe left or right on an event card to hide it from the list
• Events are automatically hidden when they end
• Hidden events won't reappear unless you refresh the calendar

Countdown customization

Access countdown settings from the main menu → Settings → Countdown.

Countdown size

• Fit countdown text to screen: Automatically adjusts countdown size to fill available screen space
• Manual size control: If auto-sizing is disabled, use the slider to set countdown size (1.0x to 10.0x)

Countdown behavior

• How fast should the countdown grow?: Controls how quickly the countdown text increases in size as events approach (slow to fast)
• How fast should the color become intense?: Controls how quickly the background color intensifies as events approach (slow to fast)

Countdown timing

• When should the countdown start growing?: Set when the countdown begins to grow in size (5 minutes to 24 hours before the event)
• When should the color become a warning one?: Set when the background color changes to yellow/amber (0 to the growth start time, in minutes)

Notifications

Screen flash

The app can flash your screen when events are approaching:

1. Go to Settings → Other settings
2. Expand "When do you want the screen to flash?"
3. Add time durations (e.g., "5 minutes", "1 hour") when you want the screen to flash
4. Set how many times the screen should flash (1-5 repetitions)
5. Use the "Test" button to preview the flash effect

Note: Screen flash only works for events you've accepted or are the organizer of (configurable in countdown settings).

Audio ping

The app can play a sound when events are approaching:

1. Go to Settings → Other settings
2. Expand "When do you want to hear a ping?"
3. Add time durations when you want to hear the ping sound
4. Adjust the ping volume using the slider (1% to 100%)
5. Use the play button to test the ping sound

Note: Audio ping only works for events you've accepted or are the organizer of (configurable in countdown settings).

Room booking

"Is it time yet?" can help you book meeting rooms directly from your calendar events. This feature requires Google Workspace.

Enabling room booking

1. Go to Settings → Room booker
2. Enable "Enable room booking"
3. The app will load available rooms from your organization
4. Configure which rooms you want to use (see below)

Room configuration

Grouping options:

• Group by building: Organize rooms by building
• Group by floor: Organize rooms by floor

Room selection:

• Expand buildings, floors, and rooms to see the full list
• Check/uncheck individual rooms to enable or disable them
• Use "Expand all" or "Collapse all" to manage the list view
• Each room shows its location and capacity

Fast room booking:

• Enable "Always book first available room" to skip the room selection dialog
• When enabled, the app automatically books the first available room from your enabled list

Booking a room

From an event card:

1. Click the menu button (three dots) on an event card
2. Select "Book room"
3. Choose from available rooms (or it will auto-select if fast booking is enabled)
4. You can select multiple rooms if needed
5. The room will be added to your event

Fast room booking (multi-select mode):

1. Click the flash icon in the app bar to enter fast booking mode
2. Select multiple events by checking the boxes on event cards
3. Click the checkmark to confirm
4. The app will automatically book the first available room for each selected event
5. Rooms are intelligently assigned to avoid double-booking

Unbooking a room:

1. Click the menu button on an event with a booked room
2. Select "Unbook room"
3. If multiple rooms are booked, select which ones to unbook
4. The room(s) will be removed from your event

Note: You can only book/unbook rooms for events where you are the organizer or have edit permissions.

Settings

Access settings from the menu button in the top-right corner of the app bar.

Countdown settings

Size & appearance:

• Auto-size countdown text
• Manual countdown size
• Growth speed
• Color intensity speed

Timing:

• When countdown starts growing
• When warning color appears

Event filtering:

• Display events: Choose which event response statuses to show (accepted, declined, needs action)
• Emphasize events: Which events should have larger, bold countdown text
• Alter background color: Which events should have color-coded backgrounds
• Flash screen: Which events should trigger screen flashes
• Play ping: Which events should trigger audio pings

Other settings

Interface text size:

• Adjust the overall text size of the interface (1.0x to 3.0x)

Calendar days:

• Set how many days ahead to load events (1 to 14 days)

Screen flash:

• Configure when and how often the screen flashes

Audio ping:

• Configure when and how loud the ping sound is

Additional options:

• Copy links to clipboard: When enabled, meeting links are copied instead of opened directly
• Keep screen alive: Prevents your device from going to sleep (if supported)
• Force dark mode: Always use dark theme regardless of system settings
• Show calendar name in events: Display which calendar each event belongs to

Room booker settings

• Enable/disable room booking feature
• Configure room grouping (by building, by floor)
• Enable/disable individual rooms

Fast room booking settings

Access from Settings → Fast room booking:

• Enable fast room booking: Turn on one-click room booking feature
• Room priority: Drag and drop rooms to set booking priority order
• Enable/disable rooms for fast booking: Control which rooms are used for fast booking (separate from general room booking)
• Grouping options: Configure grouping by building and/or floor
• Reset order: Restore default room ordering based on capacity

Cloud sync

"Is it time yet?" can sync your settings across multiple devices using cloud storage.

Setting up cloud sync

1. Go to Settings → Other settings
2. Expand "Sync settings in cloud"
3. Select a sync slot (1-8) or choose "Don't sync"
4. Your settings will be saved to the cloud

Using cloud sync

• Multiple devices: Use the same sync slot number on all devices to share settings
• Multiple profiles: Use different slot numbers for different sets of settings
• Restoring settings: When you sign in on a new device, you'll be prompted to restore settings from a sync slot

Important notes:

• If you select a slot that's in use by another device, your current settings will overwrite the other device's settings
• To restore settings from another device, sign out and sign in again, then click "Restore" when prompted
• Each sync slot can store a complete set of settings independently

Security & privacy

PIN-based encryption

"Is it time yet?" uses client-side encryption to protect your Google authentication data:

• Your refresh token is encrypted using a PIN you create
• All encryption happens on your device (in your browser)
• The encrypted data is stored in the cloud, but cannot be decrypted without your PIN
• Your PIN is never sent to any server

Data storage

• Local storage: Some settings are stored locally in your browser
• Cloud storage: Encrypted authentication data and synced settings are stored in Firebase
• No server access: All Google API calls happen directly from your browser
• In-memory tokens: Decrypted authentication tokens only exist in your browser's memory during your session

Permissions

"Is it time yet?" requests the following Google permissions:

• userinfo.email: To identify your account
• calendar.readonly: To read your calendar events
• admin.directory.resource.calendar.readonly: To view available meeting rooms (if using room booking)
• calendar.events: To modify events when booking rooms
• calendar.freebusy: To check room availability

Forgetting your PIN

If you forget your PIN:

1. You'll need to re-authorize the app
2. Create a new PIN
3. Your old encrypted data will be replaced with new encrypted data

Tips & tricks

Keyboard shortcuts

• Use your browser's refresh button to manually refresh calendar data
• The app automatically refreshes every 5 minutes

Best practices

• For meetings: Enable screen flash and audio ping 5-10 minutes before important meetings
• For room booking: Enable fast room booking if you frequently need rooms for multiple events
• For multiple devices: Use cloud sync to keep settings consistent across devices
• For privacy: Use a strong PIN and don't share it

Troubleshooting

Events not showing:

• Check that you've selected calendars in settings
• Verify the "Calendar days" setting includes your event dates
• Check event filtering settings (accepted/declined/needs action)

Room booking not working:

• Ensure you have Google Workspace (not just personal Google account)
• Verify you have permission to book rooms in your organization
• Check that rooms are enabled in room booker settings

Screen flash/ping not working:

• Verify the feature is enabled in settings
• Check that the event response status matches your notification settings
• Ensure your browser allows audio/notifications

Settings not syncing:

• Verify you're using the same sync slot number on all devices
• Check your internet connection
• Try signing out and signing back in

Support

For issues, feature requests, or questions, you can:

• Email: Contact
• In-app feedback: Use the "Can we help you?" option in the settings menu to send feedback directly from the app