google-calender-widget

An unofficial Google Calendar desktop widget for Windows, macOS and Linux. It sits on your desktop, stays out of the way, and shows your real calendar — built with Electron.

Agenda View + Dark mode

Tray menu

Features

• Your real Google Calendar — logs into your own account, no third-party middleman
• Dark mode and an agenda view that stays readable
• Tray menu — show, hide, always-on-top and quit without hunting for the window
• Remembers its position and size between launches
• Windows, macOS and Linux builds from the same codebase

How to install

Download the installer for your OS from the latest release, install and run.

How to use

1. Open the app
2. Login using Google
3. Done!

Build from source

git clone https://github.com/p32929/google-calender-widget.git
cd google-calender-widget
npm install
npm start          # run in dev with auto-reload

npm run dist:win   # build a Windows installer
npm run dist:mac   # build for macOS
npm run dist:linux # build for Linux

Todos

• Automatic deployment via Github actions
• Convert to TypeScript
• Let me think...

License

MIT License — Copyright (c) 2023 Fayaz Bin Salam. See LICENSE for the full text.

Contributing

Contributions are warmly welcomed and greatly appreciated! Whether it's a bug fix, new feature, or improvement, your input helps make this project better for everyone.

Before submitting a pull request, please:

1. Create an issue describing the feature or bug fix you'd like to work on
2. Wait for discussion and approval to ensure alignment with project goals
3. Fork the repository and create your feature branch
4. Submit your pull request with a clear description of changes

This approach helps avoid duplicate efforts and ensures smooth collaboration. Thank you for considering contributing!

Share

Sharing this repository with your friends is just one click away from here

---

Support

If this saved you time, you can buy me a coffee — it keeps these projects maintained and free.

Sponsor a mention — $499 one-time: your name + link in this section for 3 months. $1,200 one-time: featured placement at the top of this section, plus a pinned mention on my X profile, for 3 months. Email [email protected] for an invoice.

---

💼 Using this at a company?

I do fixed-price delivery work on my own projects. One invoice, one date, no hourly billing:

White-label build — this project rebranded, extended and deployed as yours	$6,500 · 3 weeks
Custom app from scratch on my own stack, signed and auto-updating	$12,500 · 6 weeks
Production-hardening sprint — 72 hours on this project, for your load and your security review	$999
Ongoing capacity — one project-week of my time reserved every month	$9,000 / month

Full details → p32929.github.io/hire · Email [email protected] — scoping and quotes are free and I answer within one business day.