Skip to content

Repository files navigation

ARCWorks Calendar Widget

ARCWorks Logo

A sleek, translucent desktop calendar widget for Windows with persistent notes and dynamic scaling.

Release License: MIT Platform Electron


🌟 Overview

ARCWorks Calendar Widget is a lightweight, frameless desktop gadget designed for Windows. Featuring an ultra-clean glassmorphic UI with dynamic acrylic backdrop blur, it sits gracefully on your desktop to provide immediate date awareness, quick-jump month/year navigation, and date-based note taking without cluttering your workflow.


✨ Features

  • 🪟 Glassmorphism Aesthetic: Frameless, translucent dark acrylic design with real-time backdrop blur and smooth rounded corners.
  • 📅 Interactive Month Grid: 42-cell calendar grid with seamless date math, day-of-week headers, and month-spanning day displays.
  • 📝 Per-Date Note Taking: Click any date to open an inline note dialog. Save thoughts, reminders, or agendas (up to 5,000 characters per note).
  • 🎨 Visual Highlighting Channels:
    • Today: Distinct electric blue outline and ambient glow.
    • Active Notes: Warm amber tint on dates with saved notes.
    • Weekends: Soft coral red accent for Saturday and Sunday.
    • Adjacent Months: Low-opacity numbers for preceding and succeeding month days.
  • 🔍 Dynamic Window Scaling: Quick size presets (70%, 80%, 100%, 150%) with intelligent screen-boundary clamping.
  • 📌 Always on Top & Position Memory: Toggle window pinning on or off. The widget automatically remembers its exact desktop placement across reboots.
  • System Tray Integration: Stays discreetly alive in the Windows system tray with a context menu to Show, Hide, or Quit.
  • ⌨️ Keyboard Friendly:
    • Ctrl + S — Quick-save note in the editor.
    • Esc — Close note editor, picker popovers, or settings panel.
    • Ctrl + Shift + 0 — Emergency scale reset to 100%.

📥 Installation

Download the latest version from the Releases page:

Package Description
ARCWorks Calendar Widget Setup 1.0.0.exe Standard Windows NSIS installer with desktop & start menu shortcuts.
ARCWorks Calendar Widget 1.0.0.exe Standalone portable executable. No installation required.

⌨️ Keyboard Shortcuts

Shortcut Action
Ctrl + S Save the currently active note
Esc Dismiss note editor / close open panels
Ctrl + Shift + 0 Emergency reset widget scale to 100%

🛠️ Building from Source

Prerequisites

1. Clone the Repository

git clone https://github.com/ARCWorksPH/ARCWorks-Calendar-Widget.git
cd ARCWorks-Calendar-Widget

2. Install Dependencies

npm install

3. Run in Development Mode

npm start

4. Build Distributables

To package both the NSIS installer and the standalone portable binary for Windows:

npm run build

Packaged binaries will be generated in the dist/ directory.


📂 Project Structure

ARCWorks-Calendar-Widget/
├── assets/                    # Application icons, logos, and graphic assets
│   ├── icon.ico               # Windows executable & tray icon
│   └── logo.png               # ARCWorks branding logo
├── data/                      # Local data placeholder (.gitkeep)
├── docs/                      # Documentation assets & screenshots
├── holidays/                  # Holiday dataset directory (.gitkeep)
├── notes/                     # Architecture notes and roadmap specs
├── index.html                 # Main interface DOM structure & dialogs
├── main.js                    # Electron main process (window, tray, IPC, persistence)
├── preload.js                 # ContextBridge security bridge
├── renderer.js                # UI state management & date logic
├── style.css                  # Glassmorphism styling, layout & animations
├── package.json               # NPM scripts, dependencies & electron-builder config
├── CHANGELOG.md               # Version release notes
├── CONTRIBUTING.md            # Guidelines for issues and contributions
└── LICENSE                    # MIT License

💾 Data Persistence

Personal notes and user preferences are automatically saved in the user's local AppData directory:

  • Notes: %APPDATA%\arcworks-calendar-widget\notes.json
  • Settings: %APPDATA%\arcworks-calendar-widget\settings.json

(User data is kept completely local and is never tracked by git).


🤝 Contributing

Contributions, feature suggestions, and bug reports are welcome! Please check out CONTRIBUTING.md for details on how to get started.


📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

Developed with ❤️ by ARCWorks.

About

A sleek, translucent desktop calendar widget for Windows with persistent notes and dynamic scaling.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages