A lightweight Windows system tray app for Google Calendar and Gmail — built with PyQt6.
Single-click the tray icon for a quick popup of today's events, unread mail, and active alarms. Double-click to open the full window with calendar, inbox, alarms, and settings.
| Tray Popup | Calendar |
|---|---|
 |
 |
| Emails | Settings |
|---|---|
 |
 |
- Calendar — view, create, edit, and delete Google Calendar events
- Gmail — unread inbox awareness, read messages, trash from the tray
- Alarms — standalone and calendar-linked alarms with audio and snooze
- Dark/light theme — with persistent preference
- Windows startup — optional launch at login via registry
- Windows 10/11
- Python 3.13+
- A Google Cloud project with Calendar and Gmail APIs enabled
git clone https://github.com/mnprojects/traypilot.git
cd traypilot
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
- Go to Google Cloud Console
- Create a new project (or use an existing one)
- Enable the Google Calendar API and Gmail API
- Go to APIs & Services → Credentials
- Create an OAuth 2.0 Client ID → Desktop app
- Download the JSON file and rename it
credentials.json - Place it in:
%LOCALAPPDATA%\mn-projects\TrayPilot\credentials.json
On first launch, a browser window will open for Google sign-in. After approval, the token is saved automatically — you won't need to sign in again.
python main.py
To compile your own executable with PyInstaller:
pip install pyinstaller
pyinstaller TrayPilot.spec
The output will be in dist/TrayPilot/.
GNU General Public License v3.0 — see LICENSE for details.
Martinho Costa Neves — mn-projects.eu