Project documentation

Image Converter Guide

Use, behavior, limits, source, testing, and licence.

1. Use

  1. Drop images or folders into the converter, or use the two browse controls.
  2. Choose WebP quality and, if needed, a maximum width.
  3. Select Convert.
  4. Download one converted WebP directly or several successful files as a ZIP.

Conversion runs sequentially so large batches are less likely to freeze the browser. A failed file does not prevent downloading successful results.

2. Formats

InputBehavior
PNG, JPEG, BMP, SVG, AVIFConverted to a still WebP.
GIF and WebPAnimated files become one still frame.
TIFFThe first page is used.
HEIC and HEIFThe first decoded image is used.
ICOOne decoded resolution is used.

Output is always WebP. Re-encoding does not guarantee a smaller file; high quality can make an already efficient source larger.

3. Privacy

Image conversion happens inside the browser. Image Converter has no image-upload endpoint and does not send source image bytes to a conversion service. A first-party cookie shares the selected theme and header visibility across the `myforgeworks.net` family; local storage supplies immediate display and fallback behavior. The theme value is not an account or visitor identifier.

4. Limits

  • There is no set file-count cap, but practical capacity depends on image dimensions, browser memory, and available device memory.
  • RAW camera files, PSD, and PDF are not supported.
  • Animated and multipage inputs are flattened as described above.
  • Browser support for WebP encoding and individual source formats still applies.

5. Source and build

Download the complete source package. It includes the application, this Guide, the test suite, build instructions, maintenance rules, changelog, and licence.

The repository, source archive, domain, and internal code retain the technical name BatchForge for compatibility. The public product name is Image Converter.

npm ci
npm test
npm run dev

Node.js 22.13 or newer is required. The repository is the reconstruction record; future changes should extend its existing architecture rather than replace it with a new template.

6. Test standing

The release checks cover the production build, page routes, conversion workflow contracts, download behavior, theme structure, privacy wording, logo assets, and shared website interface contract.

Browser conversion was previously verified for PNG, JPEG, WebP, AVIF, GIF, BMP, SVG, ICO, and TIFF. HEIC and HEIF use a dedicated local decoder but did not receive identical automated fixture coverage in that release environment.

7. Licence

Image Converter software is released under the MIT License. It may be used, copied, modified, and distributed, including commercially, while retaining the copyright and licence notice.

The licence covers the software. Project names and logos do not automatically grant endorsement or identity rights.

Website settings

Settings lets you show or hide the top header and choose Light, Dark Gray or Pure Black. Dark Gray is the first-visit default. The footer stays available when the header is hidden.

The theme and header preferences are shared across myforgeworks.net websites in this browser. They use first-party cookies with local storage as a fallback on other hostnames. They contain no document data or visitor identifier. The website’s settings are separate from any installed application.

You can open Guide or Settings and return with Back to tool without losing this tab’s files or results. Processing can continue while you are there. Reloading, closing the tab or leaving this website clears the workspace.

The Buy me a coffee button has no donation destination yet. Selecting it shows a short notice.