zjl88858

zjl88858 / forza-painter-geometrize-gpu

Public

This is a third-party geometrize JSON generation tool for [forza-painter](https://github.com/forza-painter/forza-painter). Its goal is to improve JSON generation efficiency so that higher-quality liveries can be produced in the same amount of time.

19
3
89% credibility
Found May 24, 2026 at 20 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Go
AI Summary

This is a specialized tool for creating custom car paint designs (liveries) in Forza Horizon video games. It takes a PNG image you provide and converts it into hundreds or thousands of overlapping oval shapes that approximate your image - like drawing a picture using only ellipses. The program uses your graphics card to generate these shapes much faster than a normal computer processor could, making the creative process practical and enjoyable. The output is a special file format that another tool (forza-painter) can import directly into the game so you can paint your car with your custom design. It's faster than the original tool, supports transparent images, and works across different computer types.

How It Works

1
🎮 You love customizing cars in Forza Horizon

You've always wanted to put a custom design on your dream car, and you heard about a tool that can turn any image into a paint design.

2
🖼️ You pick your favorite image

You choose a PNG image you want on your car - maybe a logo, artwork, or pattern. The tool works best with images that have some transparent areas.

3
⚙️ You set up how detailed you want your design

You tell the tool how many shapes to use (more shapes = better quality but takes longer) and save progress at certain points so you can preview and choose your favorite version.

4
🚀 The GPU speeds everything up dramatically

Your graphics card does the heavy lifting, breaking your image into thousands of oval shapes. What used to take almost 12 seconds per shape now takes less than 1 second - or on a powerful gaming PC, just 37 milliseconds.

5
You watch your design come together
⏳
You wait while it generates all shapes

The generation runs automatically, saving progress at your chosen checkpoints so you can test parts of your design while it's still working.

🎯
You spot the perfect moment to stop

You decide your design looks great at 1000 shapes instead of waiting for 3000, saving time while still getting excellent quality.

6
📦 Your design is ready as a special file

The tool saves your design as a JSON file containing all the oval shapes with their colors, positions, and sizes in a format that Forza Horizon can understand.

🏎️ Your design loads into the game

You open the file in forza-painter, import it into Forza Horizon, and see your chosen image transformed into a beautiful car livery ready to show off to the racing world.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 20 to 19 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is forza-painter-geometrize-gpu?

This is a Go-based tool that converts images into Forza paint job files (liveries) by approximating them with overlapping rotated ellipses. It hooks into the forza-painter workflow to generate JSON geometry files that can be imported into Forza Horizon games. The key difference from the original project is that it offloads the computationally expensive shape-finding process to your GPU using OpenCL, making the generation dramatically faster.

Why is it gaining traction?

The hook is raw performance. The README shows benchmarks where the same workload that took ~11 seconds per ellipse on CPU drops to ~1.3 seconds with OpenCL on integrated graphics, or down to 37ms on a high-end AIMAX device. That's not a 2x improvement, it's 30x or better. For creators making complex liveries with thousands of shapes, this is the difference between waiting hours versus minutes. The tool also handles transparent PNGs intelligently, protecting alpha regions from being overwritten by generated geometry.

Who should use this?

Forza painters and liveries creators who are frustrated by slow generation times. If you've been using forza-painter-fh6 and watching the progress bar crawl, this is the upgrade. It works on Windows with a simple PowerShell build script, and the CLI is straightforward: point it at your image, point it at a settings profile, and let it run. You need an OpenCL-capable GPU (Intel, AMD, or NVIDIA all work) and the OpenCL SDK installed.

Verdict

Forza liveries creators who care about generation speed should try this immediately. The credibility score sits at 0.9%, which reflects the low star count (19), but the codebase is well-documented, the math is solid, and the developer clearly knows the domain. It is a niche tool with a small audience, but for that audience it is a genuine time-saver.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.