← All tools
Desktop ToolR3a v0.3.1 — Development Prototype

Rubra Image Forge

A local batch workstation for converting image folders, preparing WebP outputs and generating 256×256 token-ready assets with a prototype-friendly preflight workflow.

Batch imagingWebPToken pipelineLocal desktop toolDevelopment prototype
Rubra Image Forge desktop interface in standard conversion mode with source selection, destination controls and the main analysis table.

A practical image pipeline instead of one-off cleanup work

Rubra Image Forge is a local desktop prototype built for a familiar production problem: taking a messy folder of images and turning it into a cleaner, more reusable asset set without repeating the same manual checks file by file.

The current public site baseline is R3a v0.3.1 — Development Prototype. The public repository is available, but no GitHub Release package is linked yet.

What the prototype already covers

Standard conversion for broad batches

The first mode is straightforward and useful: select files or folders, decide where the output should go and analyze the batch before writing anything.

The visible workflow includes:

  • source and destination selection;
  • recursive folder scanning;
  • filtering by extension, text, globs and regex;
  • duplicate and collision reporting;
  • conversion planning before execution.

That makes the tool feel less like a blind converter and more like a controlled staging pass for local assets.

WebP controls without hiding the trade-offs

The WebP panel keeps the main decisions visible instead of burying them behind presets.

From the supplied R3a capture we can confirm that the interface exposes quality, lossless mode, alpha quality, duplicate policy, worker count, metadata stripping and output verification controls. The default backend shown in the prototype is Pillow, with optional cwebp detection rather than a hard dependency.

Token 256×256 preparation

The second visible mode is more specialized and more interesting for game work.

Token 256×256 is aimed at producing normalized, token-ready outputs. The R3a screen shows controls for background removal heuristics, neutral tolerance, border distance, feathering, decontamination, alpha preservation and minimum-alpha validation.

It also exposes an explicit engine choice:

  • auto — use GEGL LoHalo when available;
  • GEGL — the more rigorous path when the runtime is available;
  • Lanczos / Pillow fallback — a practical fallback when GEGL is absent.

That is exactly the kind of design choice that fits the GVibeDev philosophy: not pretending the tool is magic, but making the pipeline and its limits understandable.

Preflight matters because large batches are where errors become expensive

The strongest proof in the supplied material is not a clean empty screen. It is the real batch capture.

In that R3a screenshot, Rubra Image Forge processes a folder with 707 files, about 290 MB of sources, 703 planned outputs, 29 duplicates, 18 collisions, 351 transparent items and 4 blocking preflight errors.

That does not just show that the prototype opens. It shows that it has already been exercised on the kind of batch where visibility, planning and error reporting actually matter.

Why this tool belongs on GVibeDev.cc

Rubra Image Forge fits the site for the same reason Arena Rubra tools do: it turns a repeated production nuisance into an explicit workflow.

Instead of “drop images somewhere and hope the output is fine,” the workflow becomes:

Select → Filter → Analyze → Review → Convert

It is a small tool, but it reflects the same pattern seen across the broader project hub:

  • identify a real bottleneck;
  • expose the decisions instead of hiding them;
  • test on actual workloads;
  • keep room for iteration.

Current public scope

The site page deliberately stays precise about maturity.

Rubra Image Forge is currently presented as a development prototype, not as a finished packaged product. The repository is public, but no release archive is linked yet, so the page provides the repository action and does not pretend a downloadable release already exists.

That keeps the public page honest while still showing a tool that is already clearly useful.

Setup / dependencies

Understand the two image workflows before running a large batch.

Rubra Image Forge currently exposes two practical modes: standard conversion for broad batch processing and Token 256×256 mode for game-asset preparation. The prototype keeps filtering, preflight and output decisions visible before files are converted.

CategoryBatch image conversion and token preparation
Platform / scopeWindows desktop · Local file workflow
Public packageRepository available · Release package pending
Core workflow

Standard conversion

Source image folders or filesRequired

The workflow starts from local source files and folders. The interface supports batch selection and recursive scanning across subfolders.

Writable output directoryRequired

Converted files are planned and written to a selected output folder with collision handling visible before conversion.

Local desktop sessionRequired

The current public baseline is a desktop prototype focused on local file workflows rather than a hosted web application.

Optional token pipeline

Token R3a / GEGL fallback

Optional GEGL runtimeOptional

Token R3a can use a portable GEGL LoHalo path when available. If it is missing, the prototype falls back to Pillow Lanczos instead of blocking the entire workflow.

Prototype access

Use the current repository snapshot

Rubra Image Forge is currently presented on the site as a development prototype. The repository is public, but no GitHub Release package is linked yet.

  1. Open the repository snapshot

    Start from the public GitHub repository linked above. At this stage the portfolio page documents the prototype and points back to the source snapshot rather than to a packaged release.

  2. Prepare input and output folders

    Collect one or more local source folders or image files, then choose a writable destination folder before running analysis.

  3. Choose the pipeline mode

    Use standard conversion for broad image batching or switch to Token 256×256 when you need normalized token outputs for game-oriented asset pipelines.

  4. Review filters and output settings

    Adjust extension filters, recursive scanning, WebP settings or Token R3a options before processing a large batch.

  5. Run Analyze preflight first

    The prototype is designed to inspect the batch before conversion, exposing duplicates, collisions, transparency state, planning counts and blocking errors.

  6. Convert only after the plan looks correct

    Once the preflight results make sense, proceed with conversion and review the generated output folder.

Because no public release package is linked yet, the portfolio intentionally exposes the repository action and keeps the release/download action absent.