Project documentation
Image Converter Guide
Use, behavior, limits, source, testing, and licence.
1. Use
- Drop images or folders into the converter, or use the two browse controls.
- Choose WebP quality and, if needed, a maximum width.
- Select Convert.
- 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
| Input | Behavior |
|---|---|
| PNG, JPEG, BMP, SVG, AVIF | Converted to a still WebP. |
| GIF and WebP | Animated files become one still frame. |
| TIFF | The first page is used. |
| HEIC and HEIF | The first decoded image is used. |
| ICO | One 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 devNode.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.