A curated collection of desktop enhancements, assets, and configurations for the Windhawk platform.
WH Mods Hub is a centralized repository dedicated to custom Windhawk mods and configs. where I store all my mods and configs for Windhawk.
Understanding the layout for seamless navigation:
.
├── assets/ # Raw media, sprites, and audio files
├── Config/ # Exported mod configuration presets (YAML/JSON)
├── mods/ # Production-ready Windhawk source files (.wh.cpp)
├── previews/ # Previews and visual documentation
└── install-config.ps1 # Automated configuration installer (PowerShell)
All mod settings and visual presets are managed in the Config/ directory. For detailed information on each preset and required process inclusions (like SecHealthUI.exe), please refer to the Configuration README.
A PowerShell script is provided to automate the application of all configuration presets via GitHub:
Copy and paste this into an Administrator PowerShell terminal:
iwr -useb https://raw.githubusercontent.com/ciizerr/wh-mods/main/install-config.ps1 | iex- Right-click
install-config.ps1. - Select Run with PowerShell (Administrator privileges are required).
- The script will parse the YAML files from the repository and apply them directly to your Windhawk environment.
Caution
The automated installer modifies the Windows Registry to update mod settings. Ensure you review the configuration files before running the script.
🐱 Neko Desktop Pet
Important
Ensure you have Windhawk installed and running before proceeding.
- Navigate to the
mods/directory. - Open the source file you wish to install (e.g.,
neko-cat.wh.cpp). - Copy the entire content of the file.
- Open Windhawk → Click the Arrow next to the "Mods" tab → Select "Create New Mod".
- Paste the code into the editor, then click "Save and Compile".
Tip
If the mod requires assets, it will automatically attempt to fetch them from this repository. Ensure you have an active internet connection during the first initialization.
🐱 Neko Cat (Virtual Pet)
A modern port of the classic "Neko" desktop pet, optimized for modern Windows environments via Windhawk.
- Dynamic Behaviors: Pathfinding, interactive scratching, and autonomous sleeping.
- Customization: Toggle sound effects, adjust movement speed, and customize trigger zones.
- Low Footprint: Written in clean C++ to ensure zero impact on system performance.
Security and transparency are prioritized in this repository.
Caution
External Assets: Most mods fetch assets from this branch. While this ensures a small installation size, it requires a network connection.
Offline Support: To use these mods without internet access, you must manually download the assets/ folder and update the asset URLs in the source code to point to your local storage.
- Hash Verification: Every asset is served directly from GitHub using HTTPS.
- Zero Third-Party Dependencies: No opaque binaries or external trackers are included.
Need assistance or want to share your feedback?
- GitHub Issues: Track bugs and suggestions
Made with ⚡ by ciizerr
Licensed under the MIT License.
Windhawk is a registered project of its respective owners.