🗓️ Glasscal

A glassmorphism desktop calendar widget for Windows — frameless, translucent, and always at your fingertips.

Glasscal lives quietly on your desktop as a Win11-style acrylic glass widget. Click a date to see your day, double-click to add an event, and let toast reminders keep you on schedule.

---

📸 Screenshots

Month view	Day detail (with lunar date)
Frameless acrylic calendar with today highlighted, weekend & holiday coloring, and per-day event dots.	Select a day to expand its schedule — showing the lunar date (음력) and any events.

⚙️ Settings live in the right-click menu: always-on-top, transparency, accent color, run at startup, and update checks.

---

✨ Features

📅 Calendar & Events

• Mini month view with smooth slide animations and mouse-wheel month navigation
• Event management — create, edit, and delete events with title, notes, time, and color labels
• Recurring events — daily / weekly / monthly / yearly with custom intervals and end dates
• Multi-day events rendered across every day they span
• Toast reminders via native Windows notifications, scheduled ahead of each event

🇰🇷 Korean Calendar Intelligence

• Public holidays computed locally — solar holidays, lunar holidays (Seollal, Chuseok, Buddha's Birthday), and substitute-holiday rules, no network required
• Lunar date display (음력) for the selected day, powered by KoreanLunisolarCalendar

🎨 Glass Design

• Win11 system Acrylic backdrop with graceful fallback for older builds
• 6 accent color themes — Blue, Violet, Rose, Coral, Emerald, Graphite — switchable live from the context menu
• Adjustable transparency down to fully invisible (the widget backdrop switches off automatically)
• Holiday-aware day cells with tooltips showing the holiday name

⚙️ Desktop Integration

• System tray — left-click to toggle the widget, right-click for quick actions
• Global hotkey — Ctrl+Shift+C opens quick-add from anywhere
• Run at Windows startup — one toggle in the context menu (HKCU, no admin rights needed)
• Always on top, remembered position/size, and multi-monitor clamping

---

🚀 Getting Started

Download

Grab the latest build from Releases:

Asset	Runtime	Size
Glasscal-vX.Y.Z-win-x64.zip	Self-contained — nothing to install	larger
Glasscal-vX.Y.Z-win-x64-framework-dependent.zip	Requires .NET 8 Desktop Runtime	smaller

Unzip anywhere and run Glasscal.exe. 🎉

Build from Source

git clone https://github.com/BaeTab/windows_widget_calendar.git
cd windows_widget_calendar
dotnet build widget_calendar.sln -c Release

Requirements: Windows 10 1809+ (Win11 recommended for the full acrylic experience), .NET 8 SDK.

---

🕹️ Usage

Action	How
Move the widget	Drag anywhere on the glass
Select a day	Click a date — the day panel expands below
Add an event	Header + button, day panel +, double-click a date, or Ctrl+Shift+C
Change month	Chevrons, mouse wheel over the calendar
Accent color / transparency / always-on-top / autostart	Right-click the widget
Hide / show	Tray icon left-click

---

🏗️ Architecture

widget_calendar/
├── Models/        # CalendarEvent, RecurrenceRule, WidgetState
├── Services/      # EventRepository (LiteDB), ReminderScheduler, ToastService,
│                  # TrayService, HotkeyService, HolidayService, ThemeService, StartupService
├── ViewModels/    # MVVM (CommunityToolkit.Mvvm source generators)
├── Views/         # WidgetWindow, EventEditorWindow, MiniMonthView, DayEventList
├── Styles/        # Design tokens — Colors, Typography, Icons, GlassWindow
└── Utils/         # AcrylicHelper (DWM backdrop), MonitorHelper, converters

• Storage: LiteDB single-file database at %LOCALAPPDATA%\Glasscal\glasscal.db
• Logging: Serilog rolling files at %LOCALAPPDATA%\Glasscal\logs\
• Time model: all comparisons in UTC, all display in local time

---

🔄 CI/CD

Every push to main runs the release workflow:

1. 🧪 Build verification
2. 📦 Publish self-contained & framework-dependent win-x64 binaries
3. 🏷️ Auto-tag v{Version} from the .csproj and publish a GitHub Release — only when the version is new

To ship a release: bump <Version> in widget_calendar/widget_calendar.csproj and push. That's it. ✅

---

🔔 Auto-Update

Glasscal keeps itself current straight from GitHub Releases — no store, no installer service.

• 🛰️ On launch, it quietly asks the GitHub API for the latest release and compares it to the running version.
• ✨ When a newer version exists, a slim banner appears at the top of the widget: "업데이트 v1.3.0 설치".
• 🖱️ One click downloads the self-contained zip, verifies its SHA-256 against the release's SHA256SUMS.txt, swaps the files, and relaunches — all in place.
• 🔕 Prefer manual control? Toggle "실행 시 업데이트 확인" off in the right-click menu, and use "지금 업데이트 확인" whenever you like.

Because the check runs against your existing zip release assets, publishing an update is still just a version bump + push. 🚀

---

📄 License

MIT © BaeTab