Skip to content

Add files via upload#4674

Open
Potassiumuncher wants to merge 1 commit into
ramensoftware:mainfrom
Potassiumuncher:main
Open

Add files via upload#4674
Potassiumuncher wants to merge 1 commit into
ramensoftware:mainfrom
Potassiumuncher:main

Conversation

@Potassiumuncher

@Potassiumuncher Potassiumuncher commented Jul 3, 2026

Copy link
Copy Markdown

Changelog

If this pull request updates an existing mod, describe the changes below:

  • Changelog item 1...
  • Changelog item 2...

Mod authorship

If this pull request introduces a new mod, please complete the section below.

This mod was created by:

    • The submitter, without AI assistance
    • The submitter, with AI assistance
    • Claude
    • ChatGPT
    • Gemini
    • Another AI (please specify):
    • Other (please specify):

Please select the options that best apply. Your selection does not affect the acceptance criteria, but it helps reviewers understand the context of the code and provide relevant feedback.

@m417z

m417z commented Jul 4, 2026

Copy link
Copy Markdown
Member

Thank you for the submission. There are already two mods that implement the genie effect:

The second mod is actively developed. If it has issues or is missing features, it's preferable to work with the mod author on improving it rather than having yet another genie animation mod, which will fragment the mod catalog and confuse users.

@Potassiumuncher

Potassiumuncher commented Jul 4, 2026

Copy link
Copy Markdown
Author

@m417z hi, iam sorry but i have been working on mine for a while. https://www.reddit.com/r/Windhawk/comments/1u8hhke/macos_genie_effect_wip/
this was my post when it was a WIP please dont just reject mine i have spent too long on this
Please sir I beg you, I got everyones hopes up i have been actively improving the mod from the feed back https://www.reddit.com/r/Windhawk/comments/1ulrzsi/finally_got_my_macos_genie_effect_mod_to_a_good/
So far i have added:
-better minimize and restore animations
-better app tracking so it minimizes where the app is located no matter the taskbar layout
-optimaisation for taskbar auto-hide
-lastly taskbar 'unhide' which unhides the taskbar (for taskbar-auto hide) untill the animation is finished (you can change the duration in settings) but i only finished it today it was not ready at the time i uploaded this mod to windhawk

sorry for bad grammer

@Potassiumuncher

Copy link
Copy Markdown
Author

@m417z please reply

@m417z

m417z commented Jul 5, 2026

Copy link
Copy Markdown
Member

My priority for Windhawk is to provide the best experience for users. I hope that you can agree that it's a goal worth perusing. For the genie animation feature, having dozens of different genie animation mods will be counterproductive for users.

It's great that you managed to create another high-quality implementation, and you can use that experience to help the community by improving the existing mod, MacOS Minimize Animation, by @Abdullah-Masood-05.

@Abdullah-Masood-05, will you be open to collaboration with @Potassiumuncher on improving the mod? Is submitting a pull request in your repo the best way to contribute?

Let me know what you both think about a joint effort to create a single high quality genie animation mod.

@Abdullah-Masood-05

Copy link
Copy Markdown
Contributor

@Potassiumuncher I looked closely at your mod and your demo, and credit where it's due — your genie is genuinely well done. The Direct2D mesh warp gives a more authentic macOS curve than mine: the window content stays visible and flows along the funnel instead of narrowing and fading, which is exactly the look people want. Your UI-Automation taskbar-button lookup (matching the window to the actual taskbar element) is also more precise than my cursor-based heuristic, and the auto-hide "unhide until the animation finishes" handling is something users have literally been requesting on my issues. Those three are real advances.

There are also areas where the current published mod is further along, and I'd want to make sure a merge doesn't regress them:

  • App coverage. It hooks ShowWindowAsync, SetWindowPlacement, CloseWindow and SetWindowPos in addition to ShowWindow/WM_SYSCOMMAND, so it catches custom-titlebar apps (Zed, some Electron apps) and UWP/Store apps that never go through ShowWindow. Yours hooks two entry points, so it currently misses those.
  • The translucent-window greying bug in your version (the known issue in your readme) would need to be resolved before it ships.
  • Unload safety. With @include * the DLL can unmap mid-animation in any process, so there's worker-draining in Wh_ModBeforeUninit plus a first-frame sync so windows don't vanish before the ghost appears. Whatever rendering we use has to keep that intact.
  • Flash-free restore via DWM cloaking (no layered-surface rebuild flash).

Given all that, I'm very open to collaborating. The cleanest approach is probably your rendering/curve and your taskbar + auto-hide features layered onto the existing hook and lifecycle structure, so we get the better animation without losing the app coverage and stability. PRs to my repo (https://github.com/Abdullah-Masood-05/windhawk-mods) work great. If your animation goes in, I'd absolutely want you credited as a co-author on the mod.

@m417z happy to move forward with this as a single mod with Potassiumuncher contributing. What's the preferred way to credit a co-author in the mod metadata — a separate contributors field, or something else? Want to make sure it's done in the format you'd like.

@m417z

m417z commented Jul 5, 2026

Copy link
Copy Markdown
Member

What's the preferred way to credit a co-author in the mod metadata — a separate contributors field, or something else? Want to make sure it's done in the format you'd like.

Each mod in Windhawk has a single author - the person responsible for the mod and for updating it. Contributors, co-authors, or other credits and references can be specified in the readme.

@Potassiumuncher

Potassiumuncher commented Jul 6, 2026

Copy link
Copy Markdown
Author

@m417z @Abdullah-Masood-05 i would be happy with a collaboration as iam busy with school so i wont be able to maintain it. I will send over the newest file with the 'unhide taskbar' and you can help me with any issues there are. the 'unhide taskbar' took a while to figure out so there may be some bugs I did not find. I can hand over the mod to you but you have to be able to maintain the mod, just make sure you credit me.

@Potassiumuncher

Copy link
Copy Markdown
Author

heres a preview of the taskbar unhide
Desktop2026 07 06-16 12 23 03-ezgif com-video-to-gif-converter

@Abdullah-Masood-05

Copy link
Copy Markdown
Contributor

@m417z thanks, that's clear, single author, contributors in the readme. That works perfectly.

@Potassiumuncher really appreciate you being open to this, and no worries about school, I'm happy to maintain it, and you'll be credited in the readme as the contributor of the Direct2D genie rendering and the taskbar auto-hide handling. Go ahead and send over the newest file.

Fair warning on timing: I'm pretty tight this week too (same as I mentioned on #4670), so I'll do the integration properly next week rather than rushing it in not putting it off, just want to give it the time it needs.

On how I'll approach the merge, so you know what to expect: I'll bring your rendering and the taskbar/auto-hide features onto the current mod's hook and lifecycle structure (the extra entry-point hooks for custom-titlebar/UWP apps, the unload-safety draining, the cloak-based restore) rather than swapping files wholesale that way we keep your better animation and taskbar handling without losing the app coverage and stability. I'll work through the known bits (the translucent-window greying, and any edge cases in the taskbar-unhide you mentioned) as I integrate. The auto-hide preview looks great, by the way.

I'll follow up here and on the repo as it comes together.

@Potassiumuncher

Copy link
Copy Markdown
Author

custom-animations-genie.wh.cpp

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants