cdredfox/workbuddy-skin-studio

WorkBuddy Skin Studio is a tool for changing the visual appearance of the WorkBuddy desktop app, an unofficial add on rather than a product from the app's own maker. It works by starting WorkBuddy with its remote debugging port open and then injecting custom CSS and a small menu into the running interface over a local connection, using a browser debugging protocol. Nothing in the official installed app files or its code signature is ever modified, and the change does not need to be re-adapted every time WorkBuddy itself updates. After applying a skin, a small palette icon appears near the top right of the WorkBuddy window. Clicking it opens a list of every installed theme plus the original native look, and switching between them is instant. Any PNG, JPG, JPEG, or WebP image can become a full theme, since the tool automatically extracts a color palette, background color, and text color from the picture and uses it to recolor the interface, including automatically switching between light and dark control styles based on how bright the extracted background color is. Users can also upload their own image directly from the menu to build a custom theme on the spot, and remove it just as easily. Ten built in themes are included, based on characters and visual styles from properties such as Hatsune Miku, Genshin Impact, Naruto, and other games and shows. The project supports both macOS and Windows, with matching setup scripts for each platform, plus a small command line tool for listing, creating, applying, and pausing themes, and a diagnostic command for troubleshooting setup. The README also documents a simple JSON format for defining a theme by hand, and explains that a theme resets whenever WorkBuddy fully reloads its interface, requiring the apply step to be run again. The README explicitly credits two earlier, similar skinning projects built for a different app as the basis for its injection approach and Windows startup scripts. The code itself is released under the MIT license, though character art, names, and other visual material used in the preset themes remain the property of their original owners and are not covered by that license.