ramensoftware/windhawk-mods

What this is

This is the official source collection for Windhawk mods. Each mod is a single .wh.cpp file that describes code and metadata for modifying Windows applications or system behavior. The catalog is maintained for users who want curated mods, and for developers who want to submit or update their own mods through pull requests.

Finding and installing mods

Mods are listed in the online catalog and can be browsed and installed through the Windhawk application. Start by opening the mods catalog, choose a mod, then install it through Windhawk. The repository itself is the submission and review source, not the primary installation interface.

Submitting a mod

A new mod is submitted as a pull request containing exactly one file, mods/<mod-id>.wh.cpp, where <mod-id> matches the ID declared in the mod file. The file's github metadata must point to a GitHub profile matching the pull request author. If the twitter metadata is present, the author must own and be able to verify that profile. Mods without a declared license are accepted under the MIT license, and authors are responsible for licensing third-party code.

To update a mod, change a single mods/<mod-id>.wh.cpp file and bump its version metadata to a newer value. The github metadata must still match the pull request author, so you can only update a mod you originally submitted; changes to someone else's mod should go to that author or be submitted as a new mod. The commit message becomes part of the mod's changelog.

Creating and discussing mods

The guide for writing a new mod is maintained in the Windhawk wiki. General discussion takes place in GitHub Discussions, with a Discord channel available for live conversation.

Constraints

Mods are intended for the Windhawk application on Windows. Submission requires a GitHub identity that matches the mod metadata, and licensing of bundled third-party code is the author's responsibility. The repository does not declare a top-level license; the default MIT terms apply to submitted mods that lack a license declaration.

HotRepo's take

This repository was recorded on the C++ weekly chart for the week of 2026-11-03, with 29 stars gained and a best position of 14. The ratio of 878 forks to 1,090 stars is notable for a mod collection: it suggests many users fork or adapt the source rather than only consuming the catalog. That fits the repository's design as a submit-and-review hub for individual .wh.cpp mods.

Project source and documentation