SnapCal Setup

Please complete these steps using your Computer (PC/Mac).

🛡️ Our Privacy Promise: You Own Your Data

Unlike other smart devices, SnapCal does not use a central server to read your schedule. Instead, we guide you to create your own personal backend. While this setup takes a few extra minutes, it guarantees that only you and your SnapCal can access your calendar. Your data security and privacy are our highest priorities.

💻 Step 1
1

Create Your Backend

We need a free Google Script to process your calendar and weather data.

Click to Create Script

Google will ask you to "Make a copy". Click it to open your setup sheet.

💻 Step 2
2

Configure Settings

1. In the Google Sheet that opened, click Extensions → Apps Script.

Click Extensions then Apps Script

2. In the code editor, locate the USER_CONFIG section. You will need to replace the default timezone and location with your own.

Change timezone and location in code

🔍 Search for your city below to auto-generate your codes:

⏰ 1. Timezone (Line 19)

Click the blue box to copy, then paste it into Line 19:

"Detecting..."

📍 2. Location (Line 23)

Click the green box to copy, then paste it into Line 23:

"Detecting..."

💡 Global Support: Type your city in ANY language (e.g., 中文, 日本語). We will auto-translate it to English and find the correct timezone!

Remember to click the 💾 Save icon after editing the code.

💻 Step 3
3

Deploy & Get URL

Now, let's put your script online:

  1. Click Deploy (top right) → New deployment.
  2. Click the gear icon ⚙️ → Select Web app. Select Web app
  3. Set Who has access to Anyone.
  4. Click Deploy.
🛡️ Security Authorization (Why am I seeing a warning?)

During deployment, Google will ask for permission to access your data. Click Authorise access.
Authorise access button If you see a scary "Google hasn't verified this app" screen, please do not panic! Here is why:

Because you made a copy of the script in Step 1, it now lives securely in your own Google account. To Google's automated system, this looks like an "unverified" custom program. Even though you are both the developer and the user (you will see your own email listed), Google still shows this red warning to be strictly safe.

Rest assured, your data is exclusively authorized to your own private URL. No one else will ever have access to it.

To proceed: Click Advanced ➔ Go to ... (unsafe) ➔ Allow. Google hasn't verified this app warning
  1. Click Copy to copy the Web App URL.
⚠️ You MUST select "Anyone" in step 3, or SnapCal will not be able to read your calendar!

✅ Check your URL: A valid Web App URL always ends with /exec and looks like this:

https://script.google.com/macros/s/AKfycbx_ExampleRandomString123456789/exec
🔌 Step 4
4

Connect SnapCal

For first-time use, we need to power on the device and activate setup mode:

  1. Plug in your SnapCal via USB to ensure it has sufficient power.
  2. Press the Refresh button on the device. It will now broadcast its setup network.
  3. On this computer, click the WiFi icon and connect to: SnapCal-Setup.
  4. A setup page will open automatically.
    (If not, type 192.168.4.1 in your browser)
  5. Click Configure WiFi.
  6. Select your home WiFi, enter the password, and PASTE the Web App URL you copied in Step 3 into the "Script URL" box.
  7. Click Save.

See the visual guide below for reference:

① Click Configure WiFi

Click Configure WiFi

② Select WiFi, Paste URL & Save

Select WiFi, Paste URL and Save

🎉 Your computer will return to your home WiFi, and SnapCal will begin updating!

© 2026 SnapCal. Designed for simplicity.