Skip to content

CEQ151/liquid-memo-widget

Repository files navigation

🪟 Liquid Memo Widget · 液态玻璃桌面备忘

Windows 11 上的「液态玻璃」桌面待办小组件

实时捕获桌面背景并通过 D3D11 折射,半透明玻璃质感悬浮于桌面,集待办、截止日期、日历订阅于一体。

中文 · English

Platform Python Render License


✨ 功能特性

🎨 视觉

  • 实时液态玻璃:基于本地 WindowsLiquidGlass D3D11 引擎,持续捕获窗口下方的桌面区域并折射,呈现玻璃流动、色散、高光效果。
  • 自适应文字对比度:自动采样背景明暗与复杂度,挑选深/浅色文字;背景极其杂乱(如终端、文本页面)时切换到高可见度霓虹色,autoEnhanced 模式还会为文字添加柔和光晕。
  • 可调玻璃质感:在设置中调节窗口色调、玻璃不透明度与液态强度。

✅ 待办

  • 待办为核心:快速添加、勾选完成,完成项可归档或原地淡化(设置中可选)。
  • 截止日期(DDL):每条待办带独立的截止时间列,支持 6-15 23:592026/6/156月15日 等多种写法;临近会变色提醒,逾期高亮。
  • 加急置顶 标记加急,文字变红并自动置顶。
  • 展开 / 折叠:一键展开查看全部,折叠回紧凑方块。

📅 日历订阅

  • ICS / webcal 订阅:在设置中填入订阅链接,自动同步未来若干天(默认 7 天、最多 30 天)的日程,单独显示在「日程」分组。
  • 离线缓存:上次同步结果会持久化,断网重启仍可查看;已勾选的日程跨次同步保持记忆(淡化 + 删除线)。

🖱️ 桌面交互

  • 点击穿透:玻璃区域的点击会穿透到桌面,仅在复选框、按钮等控件上响应,不影响正常使用桌面。
  • 原生拖动⋮⋮ 拖动手柄移动窗口;- 最小化,双击右下角图标恢复。
  • 全局滚轮滚动:内容超出时可用滚轮浏览。
  • 系统托盘:托盘菜单提供设置、历史记录、显示/隐藏、退出。
  • 开机自启:设置中一键切换随 Windows 启动。

⚠️ Windows 专用(Win32 + D3D11),无法在其他平台运行或构建。界面为中文,代码标识符为英文。


🚀 从源码运行

python -m pip install -r .\LiquidMemoWidget\requirements.txt
pythonw .\RunLiquidMemoWidget.pyw    # pythonw 不弹出控制台窗口

🔨 构建

.\Build.ps1

构建产物位于 dist\LiquidMemoWidget


📦 本地打包

先安装 Inno Setup 6,然后运行(将版本号替换为要打包的版本):

.\Package.ps1 -Version <version>

会生成:

  • dist\LiquidMemoWidget-Portable-v<version>.zip(便携版压缩包)
  • dist\installer\LiquidMemoWidget-Setup-v<version>.exe(安装程序)

常用选项:

.\Package.ps1 -Version <version> -SkipBuild        # 跳过构建
.\Package.ps1 -Version <version> -SkipInstaller    # 仅打包 zip
.\Package.ps1 -Version <version> -InnoSetupPath "C:\Program Files (x86)\Inno Setup 6\ISCC.exe"

若省略 -Version,脚本会依次回退到 $env:RELEASE_VERSION、当前提交上的 v* 标签、最后是 0.0.1


🏷️ 发布

推送形如 v0.0.2 的版本标签会触发 GitHub Actions 发布流程:构建 PyInstaller 应用、用 Inno Setup 生成 Windows 安装程序、打包便携版 zip,并将两者发布到 GitHub Releases。


🗂️ 状态文件

应用状态(设置、窗口位置、待办、历史、日历缓存)保存在:

%AppData%\Roaming\DesktopMemo_Pro\liquid-state.json

写入为原子操作(临时文件 + 替换);文件损坏时会备份为 liquid-state.bad-<时间戳>.json 并重置为全新状态。


🙏 致谢

本项目集成并改编了来自 ai12989757/WindowsLiquidGlass 的液态玻璃渲染核心。

WindowsLiquidGlass 提供了 D3D 屏幕捕获、圆角矩形 SDF、GPU 效果渲染器以及 Qt 玻璃组件基础。上游 README 标注其为 MIT 许可;第三方代码与二进制文件保留各自的所有权与许可条款。

详见 THIRD_PARTY_NOTICES.md

About

A Windows 11 desktop memo and todo widget with Liquid Glass visuals, Fluent UI settings, tray controls, and adaptive text contrast.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors