HTWind v0.2.0

Added

• Added manifest-based widget package support through htwind.widget.json.
• Added support for importing packages that contain multiple widgets from a single manifest.
• Added support for asset-backed widgets that ship with local CSS, JavaScript, images, fonts, and other static files.
• Added widget export support so a managed widget can be packaged and shared more easily.
• Added workspace export support so the current widget setup can be exported as a package-oriented bundle.
• Added the htwind.widget.schema.json schema file to document and validate the manifest structure.
• Added an example multi-widget package under HTWind/Templates/examples/multi-widget-package.

Improved

• Improved widget import workflows so standalone HTML widgets and manifest packages can be handled through the same application flow.
• Improved package portability by explicitly modeling widget entry files, relative paths, and declared assets.
• Improved permission identity handling for packaged widgets so decisions can be associated with the widget package root.

Documentation

• Expanded the README with detailed English documentation for single-file widgets, asset-backed widgets, and multi-widget manifest packages.
• Added a dedicated landing page section that explains manifest packages, schema usage, import/export workflows, and package structure.

HTWind v0.1.8

Full Changelog: v0.1.7...v0.1.8

HTWind v0.1.7

performance optimization: implement environment release methods for editor and widgets
Full Changelog: v0.1.6...v0.1.7

HTWind v0.1.6

feat: update version to 0.1.6, enhance HomePage with visibility and sorting filters, and improve widget window management to render multiple widgets without freezing the app.

Full Changelog: v0.1.5...v0.1.6

HTWind v0.1.5

feat: widgets are now asking for permissions when needed, and permission decisions are remembered; also redesigned risk consent dialog with clearer information hierarchy and added extra information to help users make informed decisions.

impovement: risk consent dialog UI and behavior

Full Changelog: v0.1.4...v0.1.5

HTWind v0.1.4

Adds multi-file widget import, a searchable virtualized widget library, a global "reset all widgets" action, and several UI/UX and wiring fixes so widget card commands and editor behaviors work reliably.
Keeps changes backward-compatible with existing public APIs; adds a few small service interface members.

Full Changelog: v0.1.3...v0.1.4

HTWind v0.1.3

Full Changelog: v0.1.2...v0.1.3

HTWind v0.1.2

Full Changelog: v0.1.1...v0.1.2

HTWind v0.1.1

Full Changelog: v0.1.0...v0.1.1

HTWind v0.1.0

HTWind

HTWind is a highly customizable, HTML-based widget manager that brings your favorite web tools and system helpers directly to your Windows desktop.
It also supports running PowerShell commands when you need quick system actions.

Highlights

• Native PowerShell script execution support for system automation and quick tasks
• Desktop HTML widgets with lock/unlock interaction modes
• Built-in widget library (clock, weather, system tools, file helpers, and more)
• Widget code editor with live preview (hot reload)
• Tray integration (show/hide app, background workflow)
• Pin-on-top, visibility toggle, and persisted widget geometry/state
• Startup toggle (HKCU\Software\Microsoft\Windows\CurrentVersion\Run)
• Localization infrastructure (resx + LocExtension)

Built-In Widgets

HTWind currently ships with these built-in templates:

• clock
• weather
• tictactoe
• system-monitor
• app-launcher
• visualizer
• search-box
• quick-links
• clipboard-studio
• system-time
• memory-stats
• environment-info
• network-tools
• process-manager
• file-explorer
• text-file-editor
• app-info
• media-controls
• dns-lookup
• file-actions
• drive-roots
• powershell-console

Template source files live in HTWind/Templates.

Releases

This repository includes automated release workflow at:

• .github/workflows/release.yml

When you push a tag like v1.0.0, GitHub Actions builds:

• installer (HTWind-setup-*.exe) via Inno Setup
• portable archive (HTWind-portable-*.zip)

Both are uploaded to the GitHub Release page.

Installation

Option 1: From GitHub Releases (recommended)

1. Open Releases in this repository.
2. Download one of the assets:

• HTWind-setup-<version>.exe (installer)
• HTWind-portable-<version>.zip (portable)

1. For installer mode, run the setup executable and follow the wizard.

Option 2: Run from source

Prerequisites:

• Windows 10/11
• .NET SDK 10.0+

Commands:

dotnet restore HTWind/HTWind.csproj
dotnet build HTWind/HTWind.csproj
dotnet run --project HTWind/HTWind.csproj

Uninstallation

If you are using the installed version of HTWind, you can uninstall it from Windows Settings > Apps > Installed apps.

Important

Uninstalling HTWind will delete all widgets and data stored in %LocalAppData%\HTWind. If you are uninstalling the app to perform a clean update, make sure to take a backup of this folder before proceeding.

How To Use

1. Launch HTWind.
2. Add a widget (Add Widget) from an HTML file.
3. Use per-widget controls:

• Visible to show/hide
• Locked to switch between interaction and move/resize mode
• Pin on top to keep above other windows
• Edit to open the code editor

1. Use tray icon actions for quick show/exit behavior.

Widget Development

You can build custom widgets using plain HTML/CSS/JavaScript.

Host Bridge API

Widgets can call:

• window.HTWind.invoke("powershell.exec", args)

Supported args include:

• script (required)
• timeoutMs
• maxOutputChars
• shell (powershell or pwsh)
• workingDirectory

Important:

• Only powershell.exec is currently supported.
• Output is clipped by maxOutputChars for safety.
• Scripts are executed with -NoProfile -NonInteractive -ExecutionPolicy Bypass.

Security and Responsibility Notice

• HTWind allows widgets to execute PowerShell commands via powershell.exec.
• Running commands can modify files, processes, registry entries, and network/system settings.
• All command execution risk is owned by the user running HTWind.
• On first launch, HTWind requires explicit acceptance of this risk before the app opens.

Share Widgets Via GitHub Discussions

Use repository Discussions to share reusable widgets with the community.

Suggested post format:

1. Title: [Widget] <name>
2. Summary: what it does
3. Preview: screenshot or short GIF
4. Code: attach .html file or paste source
5. Notes: permissions, external APIs, and known limitations
6. Version: compatible HTWind version

Suggested categories:

• Widget Showcase
• Widget Requests
• Widget Help

Users can copy the shared HTML file and add it through Add Widget inside HTWind.

Contributing

See CONTRIBUTING.md for the full contribution guide.

Support

• Issues: https://github.com/sametcn99/HTWind/issues
• Discussions: https://github.com/sametcn99/HTWind/discussions

If you find a bug, please include reproduction steps, expected behavior, and environment details.

License

This project is licensed under the GPL-3.0 License. See the LICENSE file for details.

Full Changelog: https://github.com/sametcn99/HTWind/commits/v0.1.0